Partilhar via


Como: Personalizar o agrupar de Item SolutionToBuild

[Observação: Este tópico é pré-versão documentação e está sujeitas a alterações em versões futuras. Tópicos em branco são incluídos sistema autônomo espaços reservados.]

The Team Foundation Build arquivo de projeto, TFSBuild.proj, pode ser personalizado, passando destinos e propriedades para a compilação na SolutionToBuild item agrupar. Você também pode adicionar ou remover soluções para criar no SolutionToBuild agrupar de itens. Para obter mais informações sobre o arquivo TFSBuild.proj, consulte Noções básicas sobre Arquivos de Configuração de Compilação do Team Foundation.

Permissões necessárias

Para concluir esses procedimentos, você deve ter o Administrar uma compilação and Administrar os espaços de trabalho permissão conjunto para Permitir.Você também deve ter o Fazer check-in and Fazer check-out permissões definidas para Permitir.

Editando o arquivo de projeto do Team Foundation compilação

Antes de poder edição o arquivo TFSBuild.proj, você precisará check-out de controle do código-fonte.

Para edição o arquivo TFSBuild.proj

  1. Sobre o Modo de exibição , aponte para Outras janelase, em seguida, clicar Gerenciador do Controle do Código-Fonte.

  2. No controle do código-fonte Explorer, expandir o seu projeto da equipe no Pastas painel e selecionar TeamBuildTypes.

  3. Para obter a versão mais recente do TFSBuild.proj, clicar com o botão direito do mouse o TeamBuildType pasta e, em seguida, clique em Obter última versão.

    Essa ação faz com que os arquivos disponível para fazer check-out para edição.

  4. No painel de visualização, clicar clicar duas vezes no nome de definição de compilação que você deseja modificar, clicar com o botão direito do mouse TFSBuild.proj e, em seguida, clique em Fazer check-out para edição.Sobre o Fazer check-out caixa de diálogo de de seleçãoCheck-out compartilhado permitir nenhume, em seguida, clicar Fazer check-out.

    Uma marca de seleção vermelha aparece próxima ao arquivo TFSBuild.proj e indica seu status de controle de fonte.

  5. clicar duas vezes no arquivo TFSBuild.proj para abri-lo no Visual Studio Editor de XML.

Propriedades de passagem no SolutionToBuild Item agrupar

Team Foundation Build inclui duas propriedades reservadas que você pode usar para personalizar definições de compilação:

  • CustomPropertiesForClean passa valores personalizados em cada solução quando Team Foundation Build chamadas a Clean destino.

  • CustomPropertiesForBuild passa valores personalizados em cada solução quando Team Foundation Build chama o destino padrão (normalmente Build).

Passar propriedades SolutionToBuild item agrupar

  1. localizar o <SolutionToBuild> marca no arquivo TFSBuild.proj.

  2. Para adicionar uma propriedade personalizada para o destino padrão, digite o seguinte entre o <SolutionToBuild> e </SolutionToBuild> Rótulos de formatação. Por exemplo:

    <SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln">
      <CustomPropertiesForBuild>
        Context=TeamBuild;RootDirectory=$(SolutionDir)
      </CustomPropertiesForBuild>
    </SolutionToBuild>
    

    Esse XML aponta a compilação propriedade RootDirectory o padrão SolutionDir propriedade.

    Use a mesma sintaxe para passar as propriedades personalizadas no CustomPropertiesForClean propriedade.

  3. sistema autônomo opção, você também pode passar propriedades personalizadas para individuais SolutionToBuild itens, especificando-sistema autônomo nos metadados.

    Por exemplo:

    <SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln">
      <Properties>
        OutDir=$(BinariesRoot)\$(Solution)\$(Platform)\$(Configuration\
      </Properties>
    </SolutionToBuild>
    

    Esse XML Especifica o diretório de saída para a definição de compilação ou definições associadas este arquivo TFSBuild.proj.

    Observação:

    Adicionando a CustomPropertiesForBuild e CustomPropertiesForClean avisos de validação de esquema XML no faz com que as Rótulos Visual Studio. Você pode ignorar com segurança esses avisos.

Adicionando e excluindo soluções de agrupar de Item SolutionToBuild

Você pode edição o SolutionToBuild item agrupar para adicionar ou remover soluções que serão criadas pela definição de compilação ou definições que estão associadas a Team Foundation Build arquivo de projeto, TFSBuild.proj.

Para adicionar ou remover soluções para compilação

  1. localizar o <SolutionToBuild> marca no arquivo TFSBuild.proj.

    Se a definição de compilação estiver definida para criar uma única solução, a SolutionToBuild entrada é semelhante ao seguinte XML:

    <ItemGroup>
    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    </ItemGroup>
    
  2. Para adicionar outra solução, adicione outro conjunto de <SolutionToBuild></SolutionToBuild> Rótulos após a abertura <ItemGroup> e antes do fechamento </ItemGroup> Rótulos de formatação.

    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySecondSolution.sln" />  <Targets></Targets>  <Properties></Properties></SolutionToBuild>
    
  3. Para remover uma solução, remova o <SolutionToBuild></SolutionToBuild> Rótulos e tudo o que está entre as Rótulos para a solução que você não deseja criar.

Chamar um destino personalizado no agrupar de Item SolutionToBuild

Você pode telefonar destinos personalizados para individuais SolutionToBuild itens, especificando-os nos metadados.

Para telefonar um destino personalizado no agrupar de itens SolutionToBuild

  1. localizar o <SolutionToBuild> marca no arquivo TFSBuild.proj.

  2. Use a sintaxe a seguir para chamar um destino e passar propriedades.

    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln">
      <Targets>MyCustomTarget1;MyCustomTarget2</Targets>
      <Properties>Property1=Value1;PropertyTwo=Value2</Properties>
    </SolutionToBuild>
    

    Esse XML chama os destinos MyCustomTarget1 e MyCustomTarget2 e passa as propriedades de propriedade1 e propriedade2.

Consulte também

Tarefas

Como: Criar uma definição de compilação

Outros recursos

Team Foundation compilação Destinos, tarefas e propriedades