Partilhar via

MSBuild na linha de comando - C++

Em geral, recomendamos que você use o Visual Studio para definir as propriedades do projeto e invocar o sistema MSBuild. No entanto, você pode usar a ferramenta MSBuild diretamente do prompt de comando. O processo de compilação é controlado pelas informações em um arquivo de projeto (.vcxproj) que você pode criar e editar. O arquivo de projeto especifica opções de compilação com base em estágios, condições e eventos de compilação. Além disso, você pode especificar zero ou mais argumentos de opções de linha de comando.

msbuild.exe [ project_file ] [ opções ]

Use as opções de linha de comando /target (ou /t) e /property (ou /p) para substituir propriedades e destinos específicos especificados no arquivo de projeto.

Uma função essencial do arquivo de projeto é especificar um destino, que é uma operação específica aplicada ao seu projeto, e as entradas e saídas que são necessárias para executar essa operação. Um arquivo de projeto pode especificar um ou mais destinos, que podem incluir um destino padrão.

Cada destino consiste numa sequência de uma ou mais tarefas. Cada tarefa é representada por uma classe .NET Framework que contém um comando executável. Por exemplo, a tarefa CL contém o comando cl.exe .

Um parâmetro task é uma propriedade da class task e normalmente representa uma opção de linha de comando do comando executável. Por exemplo, o FavorSizeOrSpeedCL parâmetro da tarefa corresponde às opções do compilador /Os e /Ot .

Parâmetros de tarefa adicionais suportam a infraestrutura do MSBuild. Por exemplo, o Sources parâmetro task especifica um conjunto de tarefas que podem ser consumidas por outras tarefas. Para obter mais informações sobre tarefas do MSBuild, consulte Referência de tarefas.

A maioria das tarefas requer entradas e saídas, como nomes de arquivos, caminhos e parâmetros string, numéricos ou booleanos. Por exemplo, uma entrada comum é o nome de um arquivo de origem .cpp a ser compilado. Um parâmetro de entrada importante é uma cadeia de caracteres que especifica a configuração de compilação e a plataforma, por exemplo, "Debug|Win32". As entradas e saídas são especificadas por um ou mais elementos XML Item definidos pelo usuário contidos em um ItemGroup elemento .

Um arquivo de projeto também pode especificar propriedades e ItemDefinitionGroupitens definidos pelo usuário. Propriedades e itens formam pares nome/valor que podem ser usados como variáveis na compilação. O componente de nome de um par define uma macro e o componente de valor declara o valor da macro. Uma macro de propriedade é acessada usando a notação $(nome) e uma macro de item é acessada usando %notação (nome).

Outros elementos XML em um arquivo de projeto podem testar macros e, em seguida, definir condicionalmente o valor de qualquer macro ou controlar a execução da compilação. Nomes de macro e cadeias de caracteres literais podem ser concatenados para gerar construções como um caminho e um nome de arquivo. Na linha de comando, a opção /property define ou substitui uma propriedade do projeto. Os itens não podem ser referenciados na linha de comando.

O sistema MSBuild pode executar condicionalmente um destino antes ou depois de outro destino. Além disso, o sistema pode criar um destino com base em se os arquivos que o destino consome são mais recentes do que os arquivos que ele emite.

Para obter mais informações sobre MSBuild, consulte:

Na presente seção

Período Definição
Passo a passo: Usando o MSBuild para criar um projeto C++ Demonstra como criar um projeto Visual Studio C++ usando MSBuild.
Como: Usar eventos de compilação em projetos do MSBuild Demonstra como especificar uma ação que ocorre em um estágio específico da compilação: antes do início da compilação; antes do início da etapa de ligação; ou após o término da compilação.
Como: Adicionar uma etapa de compilação personalizada para projetos do MSBuild Demonstra como adicionar um estágio definido pelo usuário para a sequência de compilação.
Como: Adicionar ferramentas de compilação personalizadas para projetos do MSBuild Demonstra como associar uma ferramenta de compilação a um arquivo específico.
Como: Integrar ferramentas personalizadas nas propriedades do projeto Demonstra como adicionar opções de uma ferramenta personalizada às propriedades do projeto.
Como: Modificar a estrutura de destino e o conjunto de ferramentas da plataforma Demonstra como compilar um projeto para várias estruturas ou conjuntos de ferramentas.

Ver também

Usar o conjunto de ferramentas MSVC a partir da linha de comando