Referência de esquema tasks.vs.json (C++)

Para informar ao Visual Studio como criar seu código-fonte em um projeto Open Folder, adicione um arquivo tasks.vs.json. Defina qualquer tarefa arbitrária nesse arquivo e, em seguida, invoque-a no menu de contexto do Gerenciador de Soluções. Projetos CMake não usam este arquivo porque todos os comandos de build são especificados em CMakeLists.txt. Para sistemas de build diferentes do CMake, é em tasks.vs.json que você pode especificar comandos de build e invocar scripts de build. Para obter informações gerais sobre como usar tasks.vs.json, confira Personalizar o build e depurar tarefas para desenvolvimento "Open Folder".

Uma tarefa tem uma propriedade type que pode ter um dos quatro valores: default, launch, remote ou msbuild. A maioria das tarefas deve usar launch, a menos que uma conexão remota seja necessária.

Propriedades padrão

As propriedades padrão estão disponíveis em todos os tipos de tarefas:

Propriedades de inicialização

Quando o tipo de tarefa é launch, estas propriedades estão disponíveis:

Exemplo

As seguintes tarefas invocam make.exe quando um makefile é fornecido na pasta e o ambiente Mingw64 foi definido em CppProperties.json, conforme mostrado na referência de esquema CppProperties.json:

 {
  "version": "0.2.1",
  "tasks": [
    {
      "taskLabel": "gcc make",
      "appliesTo": "*.cpp",
      "type": "launch",
      "contextType": "custom",
      "inheritEnvironments": [
        "Mingw64"
      ],
      "command": "make"
    },
    {
      "taskLabel": "gcc clean",
      "appliesTo": "*.cpp",
      "type": "launch",
      "contextType": "custom",
      "inheritEnvironments": [
        "Mingw64"
      ],
      "command": "make",
      "args": ["clean"]
    }
  ]
}

Essas tarefas podem ser invocadas no menu de contexto quando você clica com o botão direito do mouse em um arquivo .cpp no Gerenciador de Soluções.

Propriedades remotas

As tarefas remotas são habilitadas quando você instala a carga de trabalho Desenvolvimento de Linux com C++ e adiciona uma conexão a um computador remoto usando o Gerenciador de Conexões do Visual Studio. Uma tarefa remota executa comandos em um sistema remoto e também pode copiar arquivos para ele.

Quando o tipo de tarefa é remote, estas propriedades estão disponíveis:

Exemplo

A tarefa a seguir aparecerá no menu de contexto quando você clicar com o botão direito do mouse em main.cpp no Gerenciador de Soluções. Depende de um computador remoto chamado ubuntu no Gerenciador de Conexões. A tarefa copia a pasta aberta atual no Visual Studio para o diretório sample no computador remoto e, em seguida, invoca g++ para compilar o programa.

{
  "version": "0.2.1",
  "tasks": [
    {
      "taskLabel": "Build",
      "appliesTo": "main.cpp",
      "type": "remote",
      "contextType": "build",
      "command": "g++ main.cpp",
      "remoteMachineName": "ubuntu",
      "remoteCopyDirectory": "~/sample",
      "remoteCopyMethod": "sftp",
      "remoteWorkingDirectory": "~/sample/hello",
      "remoteCopySourcesOutputVerbosity": "Verbose"
    }
  ]
}

propriedades MSBuild

Quando o tipo de tarefa é msbuild, estas propriedades estão disponíveis: