Visão geral do MSBuild (Visual C++)

MSBuild é o padrão de criar o sistema para projetos Visual C++. Quando você cria um projeto no ambiente de desenvolvimento integrado (IDE) do Visual Studio, ele usa a ferramenta MSBuild. exe, um arquivo de projeto baseado em XML e arquivos de configurações opcionais. Embora você possa usar o MSBuild. exe e um arquivo de projeto na linha de comando, o IDE fornece uma interface de usuário para que você pode definir as configurações e constrói um projeto mais facilmente. Esta visão geral descreve como o Visual C++ usa o sistema MSBuild.

Prerequisites

Leia os seguintes documentos sobre MSBuild.

• MSBuild
  Visão geral dos conceitos do MSBuild.

• Referência do MSBuild
  Informações de referência sobre o sistema MSBuild.

• Referência de esquema do arquivo de projeto MSBuild
  Lista os elementos do esquema XML de MSBuild, juntamente com seus atributos e elementos pai e filho. Observe principalmente a ItemGroup, PropertyGroup, destino, e tarefa elementos.

• Referência de linha de comando do MSBuild
  Descreve os argumentos de linha de comando e opções que você pode usar com o MSBuild. exe.

• Referência de tarefa do MSBuild
  Descreve as tarefas do MSBuild. Observe principalmente essas tarefas, que são específicas para o Visual C++: Tarefa de BscMake, Tarefa de CL, Tarefa de CPPClean, Tarefa LIB, Vincular tarefa, Tarefa MIDL, Tarefa de MT, Tarefa de RC, Tarefa de SetEnv, Tarefa de VCMessage, Tarefa de XDCMake, Tarefa XSD.

MSBuild na linha de comando

A instrução a seguir do Referência de linha de comando do MSBuild documento ilustra que a ferramenta MSBuild. exe leva um implícito ou explícito project file (um arquivo de .vcxproj para projetos Visual C++) de argumento e zero ou mais de linha de comando options.

msbuild.exe [project file] [options]

Use o /target (ou /t) e /property (ou /p) opções de linha de comando para substituir as propriedades e os destinos são 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 são necessárias para executar a operação. Um arquivo de projeto pode especificar um ou mais destinos, que podem incluir um destino padrão.

Cada destino consiste em uma seqüência de um ou mais tarefas. Cada tarefa é representada por um.NET Framework que contém um comando executável. Por exemplo, o CL tarefa contém o CL comando.

A parâmetro da tarefa é uma propriedade da tarefa de classe e geralmente representa uma opção de linha de comando do comando executável. Por exemplo, o FavorSizeOrSpeed parâmetro da CL tarefa corresponde do /Os e /Ot Opções do compilador.

Parâmetros adicionais de tarefa oferecem suporte a infra-estrutura do MSBuild. Por exemplo, o Sources parâmetro da tarefa Especifica um conjunto de tarefas que podem ser consumidos por outras tarefas. Para obter mais informações sobre tarefas do MSBuild, consulte Referência de tarefa do MSBuild.

A maioria das tarefas requerem entradas e saídas, como, por exemplo, seqüência de caracteres, os parâmetros numéricos ou booleanos, caminhos e nomes de arquivo. Por exemplo, uma entrada comum é o nome de um arquivo de origem. cpp para compilar. Um parâmetro de entrada importante é uma seqüência de caracteres que especifica a configuração de compilação e a plataforma, por exemplo, "Debug|Win32 ". Entradas e saídas são especificadas pelo XML definido pelo usuário de um ou mais Item elementos contidos em um ItemGroup elemento.

Um arquivo de projeto também pode especificar definido pelo usuário Propriedades e grupo de definições de item itens. Propriedades e os itens de pares nome/valor que podem ser usados como variáveis na compilação de formulário. O componente do nome de um par define um macro, e o componente de valor declara o o valor de macro. Uma macro de propriedade é acessada por meio de $(nome) notação e uma macro do item é acessado usando %(nome) notação.

Outros elementos XML em um arquivo de projeto podem testar as macros e então condicionalmente definir o valor de qualquer macro ou controlar a execução da compilação. Nomes de macro e seqüências de caracteres literais podem ser concatenadas para gerar construções como, por exemplo, um caminho e nome de arquivo. Na linha de comando, o /property opção define ou substitui uma propriedade de projeto. Itens não podem ser referenciados na linha de comando.

O sistema MSBuild condicionalmente pode executar um destino antes ou após outro destino. Além disso, o sistema pode construir um destino com base em arquivos de destino consome estejam mais recentes do que os arquivos que ela emite.

MSBuild no IDE

Quando você definir as propriedades do projeto no IDE e salve o projeto, o Visual C++ grava as configurações do projeto para o seu arquivo de projeto. O arquivo de projeto contém configurações que são exclusivas ao seu projeto, mas ele não contém todas as configurações são necessárias para construir seu projeto. O arquivo de projeto contém Import elementos que incluem uma rede de outros suporte a arquivos. Os arquivos de suporte contêm propriedades, destinos e configurações são necessárias para construir o projeto restantes.

A maioria dos destinos e propriedades nos arquivos de suporte existem somente para implementar o sistema de compilação. A seção a seguir aborda alguns destinos de útil e as propriedades que podem ser especificadas na linha de comando do MSBuild. Para descobrir mais destinos e propriedades, explore os arquivos nos diretórios de arquivos de suporte.

Diretórios de arquivos de suporte

Por padrão, os arquivos de suporte principais do Visual C++ estão localizados nos seguintes diretórios.

Arquivos de suporte

Os diretórios de arquivos de suporte contêm arquivos com as seguintes extensões.

Propriedades e os destinos de usuário

Para usar o MSBuild mais efetivamente na linha de comando, ele ajuda a saber quais propriedades e os destinos são úteis e relevantes. A maioria das propriedades e os destinos ajudam a implementar o sistema de compilação do Visual C++ e conseqüentemente não são relevantes para o usuário. Esta seção descreve algumas propriedades de orientado ao usuário vale a pena e o destinos.

Propriedade de PlatformToolset

O PlatformToolset propriedade determina se a Visual C++ 2010 ou o conjunto de ferramentas do Visual C++ 2008 é usado na compilação. O valor da propriedade é concatenado com seqüências de caracteres literais para formar o caminho de um diretório que contém os arquivos de propriedade e de destino são necessárias para criar um projeto em uma plataforma específica.

Definir o PlatformToolset propriedade para v100 para usar Visual C++ 2010 Ferramentas para criar seu aplicativo.

msbuild myProject.vcxproj /p:PlatformToolset=v100

Definir o PlatformToolset propriedade para v90 para usar as ferramentas do Visual C++ 2008 para criar seu aplicativo. O conjunto de ferramentas do Visual C++ 2008 já deve estar instalado em seu computador para essa propriedade ser eficiente.

msbuild myProject.vcxproj /p:PlatformToolset=v90

Propriedade de UseEnv

Por padrão, as configurações específicas de plataforma para o projeto atual substituem as variáveis de ambiente do caminho, INCLUDE, LIB, LIBPATH, configuração e plataforma. Definir o UseEnv propriedade para true para garantir que as variáveis de ambiente não são substituídas.

msbuild myProject.vcxproj /p:UseEnv=true

Targets

Existem centenas de destinos nos arquivos de suporte do Visual C++. No entanto, a maioria são alvos orientados para o sistema que o usuário pode ignorar. A maioria dos destinos de sistema são antecedidos por um sublinhado (_), ou tem um nome que começa com "PrepareFor", "Calcular", "Antes", "Após", "pre" ou "Post".

A tabela a seguir lista vários destinos vale a pena orientado ao usuário.

Consulte também

Outros recursos

MSBuild (Visual C++)

Histórico de alterações