Criando uma Definição de Compilação para o Team System 2008 Team Foundation Server

Antes de poder compilar seu aplicativo, primeiro você deve criar uma definição de compilação. Uma definição de compilação especifica quais projetos de Eclipse compilar e onde as compilações devem ocorrer. Depois de criar uma definição de compilação, você pode por compilações na lista de espera.

Quando você criar definições de compilação para Visual Studio Team System 2008 Team Foundation Server, você deve executar essas compilações manualmente. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team System 2008 Team Foundation Server.

Para criar uma definição de compilação para Visual Studio Team System 2008 Team Foundation Server, você executa as seguintes tarefas:

ObservaçãoObservação

Você deveria concluir as seções deste processo em ordem. A tarefa é dividida em procedimentos menores para melhorar a legibilidade.

Permissões Necessárias

Para executar este procedimento, você deve ter a permissão de Editar definição de compilação definidas para Permitir. Para obter mais informações, consulte a seguinte página no site da Microsoft: Permissões do Team Foundation Server.

Abrir a caixa de diálogo Definição de Compilação

  1. Em Team Explorer, expanda o projeto de equipe que você deseja criar uma definição de compilação.

  2. Clique com o botão direito no nó Compilações e clique em Nova Definição de Compilação.

    A caixa de diálogo Definição da Compilação aparece. A guia Geral está ativa.

    Depois, especifique um nome e descrição para sua definição de compilação.

Especifique um Nome e Descrição para a Definição de compilação.

  1. Clique na guia Geral.

  2. Em Nome da definição de compilação, digite o nome que você deseja dar esta definição de compilação.

    O nome especificado devem ser únicos no projeto de equipe.

  3. (Opcional) Em Descrição, forneça uma descrição para esta definição de compilação.

  4. (Opcional) Se você deseja desabilitar esta definição de compilação, clique em Desabilitar esta definição de compilação.

    Por exemplo, você pode fazer isto se desejar definir uma compilação automatizada, mas não estar pronto ainda para aquela compilação ser executada automaticamente.

Depois, especifique o gatilho de compilação para definir quando uma compilação deve ser executada.

Especifique o Disparador da Compilação

Você pode especificar quatro tipos de disparadores de compilação com Team Foundation Server:

  • Compilação sob demanda (disparo manual)

  • Compile continuadamente em cada check-in. Se o agente de compilação não terminou de executar uma compilação anterior então a nova compilação será colocada na fila.

  • Cada check-in deve acrescentar uma compilação à fila para ser executado assim que um agente esteja livre.  Isto também pode ser limitado para que um tempo mínimo entre as compilações seja fornecido. Você pode escolher esta opção se sua compilação levar muito tempo e se você tiver um grande números de check-ins que resultariam em um número inaceitável de compilações na fila de compilação.

  • Compilações agendadas (diariamente).  Você pode especificar os dias e a hora que a compilação será executada. Você também pode forçar a compilação a sempre executar naquele horário, até mesmo se nenhuma alteração foi executada no período intermediário.

    ObservaçãoObservação

    Se você criar a definição de compilação em um computador que está em um fuso horário diferente do computador onde as compilações serão executadas, o horário atual de compilação pode ser inesperado durante um período onde o horário de verão de dois fusos é diferente.

Para criar uma definição de compilação disparada sob demanda

  1. Clique na guia Disparador.

  2. Selecione o botão de opção Check-ins não dispara uma nova compilação.

Para criar uma definição de compilação que compila continuamente em cada check-in

  1. Clique na guia Disparador.

  2. Clique em Compilar cada check-in.

Para criar uma definição de compilação que compila continuamente enquanto os agentes estiverem disponíveis

  1. Clique na guia Disparador.

  2. Clique em Accumular check-ins até que a compilação anterior esteja finalizada.

  3. (Opcional) Se você deseja restringir mais a frequência de compilações, marque a caixa de seleção Frequencia de compilação igual ou inferior aos outros. Na caixa minutos , especifique o número mínimo de minutos que você deseja transcorrer entre as compilações.

Para criar uma definição de compilação que compila em uma cronograma especificado

  1. Clique na guia Disparador.

  2. Clique em Compilar semanalmente durante os próximos dias.

  3. Selecione as caixas de seleção que correspondem aos dias que você deseja que a compilação seja executada.

  4. Em Colocar a compilação no agente de compilação padrão em, especifique a hora à que você deseja que a compilação seja colocada na fila.

  5. (Opcional) Marque a caixa de seleção Compilar mesmo se nada foi mudado desde a última compilação.

Depois, especifique as pastas de trabalho que você deseja incluir na compilação.

Especifique as Pastas de Trabalho para Incluir na Compilação

Nesta guia, especifique as pastas para incluir na compilação. Cada caminho é mapeado para um local relativo embaixo de um diretório de compilação raiz no agente de compilação, que é referenciado como $ (SourceDir). O agente de compilação será executado em um sistema operacional Windows. Portanto, os caminhos relativos de Pasta Local devem ser fornecidos usando convenções de nomenclatura para diretórios de Windows. Por exemplo, você deve usar a barra invertida (\) como um separador de caminho.

Por padrão, o projeto de equipe inteiro é incluído, mas você pode considerar a inclusão apenas das pastas que são necessárias à sua definição de compilação. Fazendo isto, você pode reduzir o número de arquivos que são baixados do controle de código-fonte para executar a compilação.

  1. Clique na guia Espaço de Trabalho.

  2. Para alterar as Pastas de trabalho, execute uma das seguintes tarefas:

    • Para copiar outra definição de espaço de trabalho Team Foundation Server clique em Copiar Espaço de Trabalho Existente e então especifique o espaço de trabalho que você deseja copiar.

    • Para adicionar uma nova pasta de trabalho, clique em Clique aqui para inserir uma nova pasta de trabalho. Especifique uma Pasta de Controle do Código-Fonte e uma Pasta Local para cada pasta de trabalho que você adiciona. Você pode clicar navegue (...) para especificar as pastas.

    • Para excluir uma pasta de trabalho, clique com o botão direito na pasta que você deseja excluir e clique em Excluir.

Depois, especifique as configurações padrão da compilação.

Especifique as Configurações padrão para a compilação.

Você deve especificar um agente de compilação e um local para colocação onde a saída de compilação será organizada.

  1. Clique na guia Padrões de Compilação.

  2. Em Agente de Compilação, especifique o agente de compilação que você deseja usar na definição de compilação.

  3. Marque a caixa de seleção Esta compilação copiará arquivos de saída para uma pasta-depósito se ela já não estiver marcada.

    Observação importanteImportante

    Para Visual Studio Team System 2008 Team Foundation Server, você deve copiar a saída de compilação para uma pasta-depósito.

  4. Em As compilações serão preparadas no seguinte compartilhamento, forneça um caminho válido a um compartilhamento de arquivo Windows (ou um compartilhamento de protocolo SMB). O servidor de compilação copiará a compilação produzida a este caminho.

    Você deve especificar o caminho no formato da Convenção universal de nomenclatura (UNC) do Windows, como \\NomeServidor\Compartilhamento.

Depois, especifique o local do arquivo de projeto.

Especifique o local do Arquivo do Projeto

Team Foundation Build usa um script MSBuild que é nomeado TFSBuild.proj para controlar o processo de compilação. Você usa a guia Arquivo do Perfil para procurar por um arquivo TFSBuild.proj existente no controle da versão ou para criar um novo arquivo TFSBuild.proj que você associa com a definição de compilação. Se duas ou mais definições de compilação compartilharem um único arquivo TFSBuild.proj, a personalização deste arquivo afetará cada definição de compilação.

Você pode especificar uma pasta que contém um arquivo TFSBuild.proj existente ou você pode criar um novo arquivo TFSBuild.proj a partir um arquivo de compilação existente do Ant (Build.xml).

Se uma definição de compilação pode ser gerenciada de um cliente Visual Studio 2005, você deve armazenar o arquivo de projeto em uma pasta chamada TeamBuildTypes na raiz do projeto de equipe em controle de versão. Se todos os colaboradores da compilação estiverem usando o Visual Studio 2008 ou o Plug-in do Team Foundation Server para Eclipse, então a pasta de compilação pode existir em qualquer lugar dentro do projeto de equipe em controle de versão.

Para especificar um arqui TFSBuild.proj existente

  1. Clique na guia Arquivo de Projeto.

  2. Clique em Procurar para especificar a pasta de controle de versão que contenha o arquivo de TFSBuild.proj que você deseja usar.

Para criar um novo arquivo TFSBuild.proj

  1. Clique na guia Arquivo de Projeto.

  2. Clique em Procurar para especificar a pasta de controle de versão na qual você deseja criar o novo arquivo de TFSBuild.proj.

  3. Clique em Create.

    O Assitente de Criação de Configuração de Compilação aparece.

  4. Na lista Assistentes, clique em Configuração MSBuild de um Arquivo de Compilação Ant Existente ou Configuração MSBuild de um Arquivo de Compilação Maven POM Existente.

  5. Clique em Next.

  6. Em Arquivo de Compilação, especifique o arquivo de compilação Ant ou Maven POM no servidor de controle de versão.

  7. Clique em Finish.

    Um novo arquivo TFSBuild.proj é criado do arquivo de compilação Ant ou do arquivo POM Maven.

Depois, especifique uma diretiva de retenção de compilação para indicar quanto tempo devem ser mantidas as compilações.

Especifique Política de retenção para a Compilação.

Para cada status de compilações concluídas, você pode especificar um número de compilações daquele tipo que serão retidas automaticamente.

  1. Clique na guia Diretiva de Retenção.

  2. Em Especificar como as compilações devem ser retidas, clique em Diretriz de Retenção para especificar o número de compilações que devem ser mantidas para cada status concluído de compilação.

    Você pode clicar em Especificar Contagem a Manter e então especificar um número específico de compilações se nenhum dos valores fornecidos satisfazem seus requisitos.

    ObservaçãoObservação

    Usuários podem subtituir a diretiva de retenção especificando Reter Indefinidamente para uma ou mais compilações no Gerenciador de Compilação. Para obter mais informações, consulte Retain a Build Indefinitely.

Salve a Definição de Compilação

  • Na caixa de diálogo Definição de Compilação , clique em OK.

    A definição de compilação é salva no servidor.

Você deveria executar uma compilação de teste para verificar se a sua definição de compilação está funcionando como espera. Para obter mais informações, consulte Colocando na fila uma Compilação para o Team System 2008 Team Foundation Server.

Consulte também

Outros recursos

Criando uma Definição de Compilação para o Visual Studio 2005 Team Foundation Server

Criando uma Definição de Compilação para o Team Foundation Server 2010