Tarefas do MSBuild específicas para o C++

  • Artigo

Tarefas fornecem o código que é executado durante o processo de build. Quando o C++ é instalado, as tarefas a seguir estão disponíveis, além das que são instaladas com o MSBuild. Para saber mais, confira Visão geral do MSBuild (C++).

Além dos parâmetros para cada tarefa, todas as tarefas também têm os seguintes parâmetros.

Parâmetro Descrição
Condition Parâmetro String opcional.

A expressão Boolean que o mecanismo MSBuild usa para determinar se essa tarefa será executada. Para obter informações sobre as condições que são suportadas pelo MSBuild, confira Condições.
ContinueOnError Parâmetro opcional. Pode conter um dos seguintes valores:

- WarnAndContinue ou true. Quando uma tarefa falha, as tarefas subsequentes no elemento de Destino e a compilação continuam em execução, e todos os erros da tarefa são tratados como avisos
- ErrorAndContinue. Quando uma tarefa falha, as tarefas subsequentes no elemento de Target e o build continuam em execução e todos os erros da tarefa são tratados como erros.
- ErrorAndStop ou false (padrão). Quando uma tarefa falha, as tarefas restantes do elemento de Target e o build não são executadas e todo o elemento Target e a compilação são considerados como com falha.

As versões do .NET Framework antes da 4.5 ofereciam suporte somente aos valores true e false.

Para saber mais, confira Como ignorar erros em tarefas.
Título Descrição
Tarefa BscMake Encapsula a ferramenta Utilitário de Manutenção de Informações de Procura da Microsoft (bscmake.exe).
tarefa CL Encapsula a ferramenta de compilador C++ (cl.exe).
Tarefa CPPClean Exclui os arquivos temporários que o MSBuild cria quando um projeto C++ é criado.
Tarefa ClangCompile Encapsula a ferramenta de compilador C++ (clang.exe).
Tarefa CustomBuild Encapsula a ferramenta de compilador C++ (cmd.exe).
Tarefa FXC Use os compiladores de sombreador HLSL no processo de compilação.
GetOutOfDateItems Lê tlogs antigos, grava novos tlogs e retorna um conjunto de itens não atualizados. (tarefa auxiliar)
GetOutputFileName Obtém o nome do arquivo de saída para cl e outras ferramentas, que permitem especificar somente o diretório de saída ou o nome de arquivo completo, ou nada. (tarefa auxiliar)
tarefa LIB Encapsula a ferramenta Gerenciador de Biblioteca de 32 bits da Microsoft (lib.exe).
tarefa de vinculação Encapsula a ferramenta de vinculador C++ (link.exe).
tarefa MIDL Encapsula a ferramenta do compilador da MIDL (linguagem IDL) da Microsoft (midl.exe).
tarefa MT Encapsula a Ferramenta de Manifesto da Microsoft (mt.exe).
Tarefa MultiToolTask Sem descrição.
Tarefa ParallelCustomBuild Executar instâncias paralelas da tarefa CustomBuild.
tarefa RC Encapsula a ferramenta do compilador de recurso do Microsoft Windows (rc.exe).
Tarefa SetEnv Define ou exclui o valor de uma variável de ambiente especificada.
Classe base TrackedVCToolTask Herda de VCToolTask.
tarefa VCMessage Logs de mensagens de erro e mensagens de aviso durante uma compilação. (Não extensível. Somente uso interno.)
Classe base VCToolTask Herda de ToolTask.
tarefa XDCMake Encapsula a ferramenta de Documentação XML (xdcmake.exe), que mescla arquivos de comentário (.xdc) do documento XML com um arquivo .xml.
tarefa XSD Encapsula a ferramenta de definição de esquema XML (xsd.exe), a qual gera arquivos de classe ou de esquema com base em uma origem. Consulte a observação abaixo.
Referência do MSBuild Descreve os elementos do sistema MSBuild.
Tarefas Descreve tarefas que são unidades de código que podem ser combinadas para produzirem uma compilação.
Produção de tarefas Descreve como criar uma tarefa.

Observação

A partir do Visual Studio 2017, o suporte a projetos em C++ para xsd.exe foi preterido. Você ainda pode usar as APIs Microsoft.VisualC.CppCodeProvider manualmente adicionando CppCodeProvider.dll ao cache de assembly global.