Como: Personalizar os números de compilação

Artigo
08/25/2010

[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.]

Você pode personalizar Team Foundation Build Criando seu próprio personalizado tarefas executadas durante uma compilação. Este tópico explica as etapas que devem ser seguidas para personalizar um Team Foundation Build definição de compilação com uma tarefa que gera números de compilação.

Pré-requisitos

Antes de criar a tarefa para personalizar compilação números, você deve ter o seguinte:

Acesso ao arquivo TFSBuild.proj da definição de compilação que deseja personalizar.

O arquivo TFSBuild.proj pode ser associado a mais de uma definição de compilação.Para determinar o controle do código-fonte local do arquivo TFSBuild.proj, selecionar a definição de compilação no Compilações pasta Team Explorer, clicar com o botão direito do mouse nele e, em seguida, clique em edição.Do arquivo TFSBuild.proj controle do código-fonte local é exibido sobre o Arquivo de projeto painel do definição de compilação da caixa de diálogo.Por padrão, o arquivo TFSBuild.proj está localizado no $ pasta / MyTeamProject/TeamBuildTypes/ MyBuildName in Controle de versão do Team Foundation. MyTeamProject é o nome do seu projeto da equipe e o nó raiz de todas as suas fontes de projeto da equipe.MyBuildName é o nome que você deu para a primeira definição de compilação associado ao arquivo TFSBuild.proj.Para obter mais informações sobre como criar Team Foundation Build tipos de compilação, consulte Como: Criar uma definição de compilação.

Observação importante:

Quando você personaliza o arquivo TFSBuild.proj, você pode personalizar cada definição de compilação associada a ele.
Um espaço de trabalho local que contém os arquivos de projeto da equipe e os arquivos de compilação no computador local.

Para obter mais informações, consulte Como: Criar um espaço de trabalho mapeado e Como: Obter a Origem para O projeto de equipe.
Permissões necessárias.

Para executar essa tarefa, você deve ter o Administrar uma compilação and Administrar os espaços de trabalho permissão definido como Permitir.Você também deve ter o Fazer check-in and Fazer check-out permissões definidas para Permitir.Para obter mais informações, consulte Team Foundation servidor Permissões.

Observação importante:
Quando você personaliza o arquivo TFSBuild.proj, você pode personalizar cada definição de compilação associada a ele.

Gravar o número do Build tarefa

Para gravar sua tarefa, ou você pode implementar o ITask diretamente da interface ou derivar a classe de uma classe auxiliar Task. ITask definido no assembly Microsoft.compilação.estrutura.dll e Task é definido no assembly Microsoft.compilação.Utilitites.dll.

Para personalizar o compilação número é gerado por Team Foundation Build, você deve inserir a tarefa para o BuildNumberOverrideTarget destino. BuildNumberOverrideTarget requer uma propriedade de saída chamada BuildNumber. O Output atributo indica que a propriedade é a saída de suas tarefas personalizado. Para obter mais informações sobre o Team Foundation Build destinos, consulte Personalizável Team Foundation compilação destinos.

Para escrever sua tarefa personalizada

Criar um Visual C# biblioteca de classes chamada MyTask que contém a tarefa personalizada.

Para obter mais informações, consulte Classes de componentes.
Sobre o Projeto menu, clicar Adicionar referênciae selecionar Microsoft.compilação.estrutura e Microsoft.compilação.Utilities from a Adicionar referência caixa de diálogo.

Insira o código a seguir ao arquivo classe.cs.

Este exemplo herda o Task classe auxiliar e usa o DateTime Propriedades UtcNow e Ticks para gerar o número da compilação.

using System;
using Microsoft.Build.Utilities;
using Microsoft.Build.Framework;

namespace BuildNumberGenerator
{
    public class BuildNumberGenerator:Task
    {
        public override bool Execute()
        {            
            m_buildNumber = DateTime.UtcNow.Ticks.ToString();
            return true;
        }
        private string m_buildNumber;

        [Output]
        public string BuildNumber
        {
            get { return m_buildNumber; }
        }
    }
}

Crie sua biblioteca de classes para produzir MyTask.dll.

Copie a DLL interna para a pasta de espaço de trabalho local que contém o arquivo TFSBuild.proj da definição de compilação.

Observação importante:
Você deve ter mapeado a controle do código-fonte local do arquivo TFSBuild.proj ao seu espaço de trabalho local antes dessa estrutura de diretório existe no computador cliente.Para obter mais informações, consulte Como: Obter a Origem para O projeto de equipe.

Se seu arquivo TFSBuild.proj foi armazenado na pasta padrão em controle do código-fonte, a cópia local do arquivo está localizada na <raiz>:\Espaço de trabalho local\TeamBuildTypes\ MyBuildName no computador cliente.Espaço de trabalho local é a pasta local para o qual o projeto da equipe é mapeado, MyTeamProject é o nome do seu projeto da equipe e MyBuildName é o nome que você deu para a primeira definição de compilação que está associada este arquivo TFSBuild.proj.

Adicionando o arquivo DLL ao controle de fonte

Depois de criar a DLL que contém a tarefa personalizada, adicione-Controle de versão do Team Foundation. Você pode usar o tf add e tf checkin comandos para adicionar e fazer check-in da DLL no mesmo local do arquivo TFSBuild.proj de definição de compilação. Para obter mais informações, consulte Adicionar comando e Comando de Fazer Fazer Check-in.

Para adicionar e verifique seu conjunto de módulos (assembly)

clicar Iniciar, point to Todos os programas, Microsoft Visual Studio 9.0, O Visual Studio Toolse, em seguida, clicar O Visual Studio 2008 aviso de comando.Abre o espaço de trabalho local você mapeou para o projeto da equipe que contém o tipo de compilação você deseja personalizar.

Por exemplo, digite o seguinte no aviso de comando.

> cd c:\MyTeamProject

Em que MyTeamProject é o nome do seu projeto da equipe.
Mover para o local onde o arquivo TFSBuild.proj é armazenado.

Por exemplo, digite o seguinte no aviso de comando.

c:\MyTeamProject>cd TeamBuildTypes\MyBuildName

Em que MyBuildName é o nome da definição da compilação.
Adicione o arquivo Controle de versão do Team Foundation, digite o comando a seguir.

c:\MyTeamProject\TeamBuildTypes\MyBuildName> tf add MyTask.dll
Para fazer check-in o arquivo Controle de versão do Team Foundation, digite o comando a seguir.

c:\MyTeamProject\TeamBuildTypes\MyBuildName> tf checkin MyTask.dll

Você também pode usar o Team Explorer Para adicionar sua DLL para Controle de versão do Team Foundation. Para obter mais informações, consulte How to: Add a Project or Solution to Version Control.

Registrando a tarefa

Depois de criar a tarefa, você deve registrá-lo, especificando a tarefa em um UsingTask elemento do arquivo TFSBuild.proj. The UsingTask elemento mapeia a tarefa para o assembly que contém a implementação da tarefa. Para obter mais informações, consulte Elemento UsingTask (MSBuild).

Para registrar a tarefa modificando o arquivo TFSBuild.proj

Inicie o Visual Studio
Fazer check-out do arquivo TFSBuild.proj que você deseja modificar na Controle de versão do Team Foundation e em aberto-o Visual Studio Editor de XML.

Adicionar o UsingTask elemento para o arquivo TFSBuild.proj imediatamente após a demonstrativo de importação.

<UsingTask 
    TaskName="BuildNumberGenerator.BuildNumberGenerator" 
    AssemblyFile="MyTask.dll"/>

Para inserir a tarefa no BuildNumberOverrideTarget de destino, adicione o seguinte XML enlosed dentro do <Target></Target> Rótulos, ao participante do arquivo TFSBuild.proj.

</ItemGroup>
  <Target Name = "BuildNumberOverrideTarget" >    <BuildNumberGenerator>     <Output TaskParameter="BuildNumber" PropertyName="BuildNumber"/>     </BuildNumberGenerator>   </Target>
</Project>

clicar Arquivo, clicar Salvar para salvar suas alterações e, em seguida, fechar TFSBuild.proj.

Observação:

Você receberá avisos de esquema XML após fazer essas alterações no arquivo TFSBuild.proj.Você pode ignorar com segurança esses avisos.
Verificar TFSBuild.proj de volta ao controle de fonte.
Depois que você modificou o arquivo TFSBuild.proj e salvou as alterações em Controle de versão do Team Foundation, executar a definição de compilação.

Para obter mais informações, consulte Como: Fila ou iniciar uma definição de compilação.

Você pode exibir o número da versão personalizada no Build Explorer. Para obter mais informações, consulte Como: Progresso de compilação de monitor.