Personalizar os números de compilação

Artigo
08/08/2011

Este tópico descreve como personalizar os números de compilação quando você usa o modelo de Upgrade. Para obter mais informações sobre o modelo de Upgrade, consulte Definir uma compilação usando o modelo de Upgrade. Com mais facilidade, você pode executar esse procedimento usando o modelo padrão. Para obter mais informações, consulte Definir uma compilação usando o modelo padrão.

Você pode personalizar Team Foundation Build , criando suas próprias tarefas personalizadas que são executados durante a compilação. Este tópico explica as etapas que devem ser seguidas para personalizar um Team Foundation Build criar a definição de uma tarefa que gera números de compilação.

Pré-requisitos

Antes de criar a tarefa para personalizar os números de compilação, certifique-se de que ter o seguinte no lugar:

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

O arquivo TFSBuild pode ser associado a mais de uma definição de compilação. Para determinar o local do controle de origem do arquivo TFSBuild, selecione a definição de compilação no constrói pasta na Team Explorer, o botão direito do mouse e em Editar. Local de controle de origem do arquivo TFSBuild é exibido no O arquivo de projeto o painel da Build Definition caixa de diálogo. Por padrão, o arquivo TFSBuild está localizado no $ pasta /MyTeamProject/TeamBuildTypes/MyBuildName na Controle de versão do Team Foundation. MyTeamProject é o nome do seu projeto de equipe e é o nó raiz de todas as suas fontes de projeto de equipe. MyBuildName é o nome que você deu para a primeira definição de compilação é associada ao arquivo TFSBuild. Para obter mais informações sobre como criar Team Foundation Build tipos de compilação, consulte Criar uma definição de compilação básico.

Importante

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

Para obter mais informações, consulte Criar um espaço de trabalho e arquivos de Get e Obter o código-fonte para o projeto de equipe.
Permissões necessárias

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

Para executar essa tarefa, você deve ter o administrar uma compilação e espaços de trabalho de administrar permissão definida Permitir. Você também deve ter o Check-in e Check-out as permissões definidas Permitir. Para obter mais informações, consulte Permissões de Team Foundation Server.

A tarefa de número de compilação de escrita.

Para escrever sua tarefa, você pode tanto implementar a ITask interface diretamente, ou derivar a classe de uma classe auxiliar Task. ITaské definido no assembly Microsoft.Build.Framework.dll e Task é definido no assembly Microsoft.Build.Utilitites.dll.

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

Para escrever sua tarefa personalizada

Criar um Visual C# biblioteca de classe chamada MinhaTarefa que contém tarefas personalizadas.

Para obter mais informações, consulte Classes de componentes.
No projeto menu, clique em Add Referencee selecione Microsoft.Build.Framework e Microsoft.Build.Utilities da Add Reference caixa de diálogo.

Insira o seguinte código para o arquivo class.cs.

Este exemplo herda de Task classe auxiliar e usa o DateTime Propriedades UtcNow e Ticks para gerar o número de 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 a sua biblioteca de classe para produzir MyTask.dll.

Copie a DLL compilada para a pasta de espaço de trabalho local que também contém o arquivo TFSBuild de sua definição de compilação.

Importante
Você deve ter mapeado o local do controle de origem do arquivo TFSBuild seu espaço de trabalho local antes da estrutura de diretório existe no computador cliente. Para obter mais informações, consulte Obter o código-fonte para o projeto de equipe.

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

Adicionando o arquivo DLL ao controle de origem

Após você ter criado a DLL que contém a tarefa personalizada, você deve adicioná-lo para Controle de versão do Team Foundation. Você pode usar o tf add e tf checkin comandos para adicionar e verifique na DLL no mesmo local do arquivo TFSBuild de sua definição de compilação. Para obter mais informações, consulte Adicionar comando e Comando de check-in.

Para adicionar e devolver seu assembly.

Clique em Iniciar, aponte para Todos os programas, Microsoft Visual Studio 9.0, Visual Studio Toolse em seguida, clique em Prompt de comando de 2008 do Visual Studio. Abra o espaço de trabalho local que você mapeou para o projeto de equipe que contém o tipo de compilação que você deseja personalizar.

Por exemplo, digite o seguinte no prompt de comando.

> cd c:\MyTeamProject

Onde MyTeamProject é o nome do seu projeto de equipe.
Mover para o local onde está armazenado o arquivo TFSBuild.

Por exemplo, digite o seguinte no prompt de comando.

c:\MyTeamProject>cd TeamBuildTypes\MyBuildName

Onde MyBuildName é o nome da definição de compilação.
Para adicionar o arquivo Controle de versão do Team Foundation, digite o comando a seguir.

c:\MyTeamProject\TeamBuildTypes\MyBuildName> tf add MyTask.dll
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 Controle de versão do Team Foundation. Para obter mais informações, consulte Adicionar arquivos ao controle de versão.

Registrando a tarefa

Após você ter criado sua tarefa, você deve registrá-lo especificando-se a tarefa em uma UsingTask elemento no arquivo TFSBuild. O UsingTask elemento mapeia a tarefa para o assembly que contém de implementação. a tarefa Para obter mais informações, consulte UsingTask elemento (MSBuild).

Para registrar a tarefa, modificando o arquivo TFSBuild.

Inicie o Visual Studio
Confira o que você deseja modificar o arquivo TFSBuild Controle de versão do Team Foundation e abri-lo na Visual Studio XML-do editor.

Adicionar o UsingTask elemento ao arquivo TFSBuild imediatamente após a instrução de importação.

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

Para inserir a tarefa para o BuildNumberOverrideTarget de destino, adicione o seguinte XML entre o <Target></Target> marcas, até o final do arquivo TFSBuild.

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

Clique em arquivo, clique em Salvar para salvar as alterações e feche TFSBuild.

Observação

Após fazer essas alterações no arquivo TFSBuild, você receberá avisos de esquema XML. Você pode ignorar seguramente esses avisos.
Verificar TFSBuild de volta ao controle de origem.
Depois que você tiver modificado o arquivo TFSBuild e salva as alterações na Controle de versão do Team Foundation, executar a definição de compilação.

Para obter mais informações, consulte Uma compilação de fila.

Você pode exibir o número de compilação personalizada no Build Explorer. Para obter mais informações, consulte Monitorar o progresso de uma compilação de execução.