Compartilhar via


Demonstra Passo a passo: Adicionar etapas de compilação usando a tarefa BuildStep

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

Uma tarefa BuildStep é um MSBuild criado especificamente para tarefas Team Foundation Server. Você pode adicionar uma tarefa de BuildStep para uma compilação Adicionando um ou mais elementos BuildStep a um elemento de destino no arquivo TFSBuild.proj de definição de compilação da solução.

Pré-requisitos

Antes de adicionar uma tarefa BuildStep a uma definição de compilação, você deve ter o seguinte:

Permissões necessárias

Para executar os procedimentos neste tópico, você 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.

Para adicionar etapas de compilação usando a tarefa BuildStep, execute os procedimentos a seguir:

  • Adicionar uma tarefa para o arquivo de projeto

  • Adicionando uma etapa de compilação informativo ao arquivo do projeto

Adicionar uma tarefa para o arquivo de projeto

Você pode usar a tarefa BuildStep para adicionar e atualização criar etapas.Este procedimento descreve sistema autônomo modificar o arquivo TFSBuild.proj da seguinte maneira:

  1. Adicione uma etapa de compilação.

  2. Execute uma tarefa.

  3. atualização a etapa de compilação com o status de êxito se a tarefa for bem-sucedida ou com o status de falha se a tarefa não for bem-sucedida.

A tarefa de etapa compilação em cópias exemplo arquivos para um novo local de fonte.

Para adicionar e atualizar uma etapa de compilação no arquivo TFSBuild.proj

  1. Inicie o Visual Studio

  2. 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.

  3. Adicione o seguinte XML ao elemento <itemgroup>.Você pode adicionar o XML para o elemento <ItemGroup>existente ou pode optar por adicionar um novo elemento <ItemGroup>:

    Observação:

    O código nesta etapa identifica as pastas onde se encontram os arquivos de fonte a serem copiados.Outros MSBuild as tarefas podem exigir outros acréscimos ao XML. Para obter mais informações sobre requisitos de MSBuild tarefas, consulte Referência de tarefa do MSBuild.

    <ItemGroup>
        <SourceFileFolder Include="C:\WorkingFolder\TeamBuildTypes\**\*.cs" />
    </ItemGroup>
    
  4. Adicione o seguinte XML ao participante do arquivo TFSBuild.proj antes o</projeto> elemento:

    </ItemGroup>
        <Target Name="BeforeCompile">        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Message="Working...">            <Output TaskParameter="Id" PropertyName="StepId" />        </BuildStep>        <!-- Perform a task... -->        <Copy SourceFiles="@(SourceFileFolder)"            DestinationFolder="C:\NewSourceFileFolder"        />        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Id="$(StepId)"            Status="Succeeded" />        <OnError ExecuteTargets="MarkBuildStepAsFailed" />    </Target>    <Target Name="MarkBuildStepAsFailed">        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Id="$(StepId)"            Status="Failed" />    </Target>
    </Project>
    
    Observação:

    Para obter mais informações sobre Team Foundation Build destinos e uma lista de destinos personalizáveis, consulte Personalizável Team Foundation compilação destinos.

  5. Salvar as alterações e fechar TFSBuild.proj.

  6. Fazer check-in do arquivo TFSBuild.proj ao controle de versão.

  7. Execute 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 a mensagem de etapa de compilação no Build Explorer, e você pode ver a compilação concluída etapa de criação e atualização processos no log de compilação. Você também ver os arquivos copiados no diretório que você especificou.Para obter mais informações, consulte Como: Progresso de compilação de monitor.

Adicionando uma etapa de compilação informativo ao arquivo do projeto

Se você não é necessário que executar uma tarefa, mas você deseja adicionar uma etapa de compilação Informativo, não use o Id Output propriedade e conjunto o status imediatamente. Este procedimento adiciona apenas uma mensagem para o processo de compilação que você vê quando você abre a compilação no Build Explorer.

Para adicionar uma etapa de compilação Informativo o arquivo TFSBuild.proj

  1. Inicie o Visual Studio

  2. 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.

  3. Adicione o seguinte XML ao participante do arquivo TFSBuild.proj antes o</projeto> marca:

    </ItemGroup>
        <Target Name="AfterCompile">        <BuildStep            TeamFoundationServerUrl="$(TeamFoundationServerUrl)"            BuildUri="$(BuildUri)"            Message="Compile step complete."            Status="Succeeded" />    </Target>
    </Project>
    
    Observação:

    Para obter mais informações sobre Team Foundation Build destinos e uma lista de destinos personalizáveis, consulte Personalizável Team Foundation compilação destinos.

  4. Salvar as alterações e fechar TFSBuild.proj.

  5. Fazer check-in do arquivo TFSBuild.proj ao controle de versão.

  6. Execute 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 a mensagem no Build Explorer e no log de compilação. Para obter mais informações, consulte Como: Progresso de compilação de monitor.

Consulte também

Referência

Tarefa BuildStep

Outros recursos

Referência de tarefa do MSBuild

Referência de esquema de arquivo de projeto MSBuild