Partilhar via


Compilar de forma incremental

Quando você cria um projeto grande, é importante que já tenha criado componentes que ainda estejam atualizados e não sejam recriados. Se todos os destinos forem criados todas as vezes, cada build levará muito tempo para ser concluída. Para habilitar os builds incrementais (builds nos quais somente os destinos que não foram criados antes ou destinos que estão desatualizados são recriadas), o Microsoft Build Engine (MSBuild) pode comparar os carimbos de data/hora dos arquivos de entrada com carimbos de data/hora dos arquivos de saída e determinar se ignora, compila ou recompila parcialmente um destino. No entanto, deve haver um mapeamento de um para um entre entradas e saídas. Você pode usar transformações para permitir que os destinos identifiquem esse mapeamento direto. Para obter mais informações sobre transformações, consulte Transformações.

Especificar entradas e saídas

Um destino pode ser criado incrementalmente se as entradas e saídas forem especificadas no arquivo de projeto.

Para especificar as entradas e saídas para um destino

  • Use os atributos Inputs e Outputs do elemento Target. Por exemplo:

    <Target Name="Build"
        Inputs="@(CSFile)"
        Outputs="hello.exe">
    

O MSBuild pode comparar os carimbos de data/hora dos arquivos de entrada com os carimbos de data/hora dos arquivos de saída e determinar se deve ignorar, compilar ou recompilar parcialmente um destino. No seguinte exemplo, se um arquivo da lista de itens @(CSFile) for mais recente que o arquivo hello.exe, o MSBuild executará o destino; caso contrário, ele será ignorado:

<Target Name="Build"
    Inputs="@(CSFile)"
    Outputs="hello.exe">

    <Csc
        Sources="@(CSFile)"
        OutputAssembly="hello.exe"/>
</Target>

Quando entradas e saídas são especificadas em um destino, cada saída pode mapear para apenas uma entrada ou não pode haver nenhum mapeamento direto entre as saídas e entradas. Na tarefa Csc anterior, por exemplo, a saída, hello.exe, não pode ser mapeada para uma única entrada – ela depende de todas elas.

Observação

Um destino no qual não há nenhum mapeamento direto entre as entradas e saídas sempre será compilado com mais frequência do que um destino no qual cada saída possa mapear para apenas uma entrada porque o MSBuild não pode determinar quais saídas precisam ser recriadas se algumas das entradas tiverem sido alteradas.

As tarefas nas quais você pode identificar um mapeamento direto entre as saídas e entradas, como a tarefa LC, são mais adequadas para builds incrementais, ao contrário de tarefas como Csc e Vbc, que produzem um assembly de saída de diversas entradas.

Exemplo

O exemplo a seguir usa um projeto que cria arquivos de ajuda para um sistema de ajuda hipotético. O projeto funciona convertendo arquivos .txt de origem em arquivos .content intermediários, que são então combinados com arquivos de metadados XML para produzir o arquivo .help final usado pelo sistema de Ajuda. O projeto usa as seguintes tarefas hipotéticas:

  • GenerateContentFiles: converte arquivos .txt em arquivos .content.

  • BuildHelp: combina arquivos .content e arquivos de metadados XML para criar o arquivo .help final.

O projeto usa transformações para criar um mapeamento de um para um entre entradas e saídas na tarefa GenerateContentFiles. Para obter mais informações, consulte Transformações. Além disso, o elemento Output é configurado para usar automaticamente as saídas da tarefa GenerateContentFiles como entradas para a tarefa BuildHelp.

Este arquivo de projeto contém os destinos Convert e Build. As tarefas GenerateContentFiles e BuildHelp são colocadas nos destinos Convert e Build, respectivamente, para que cada destino possa ser compilado de forma incremental. Ao usar o elemento Output, as saídas da tarefa GenerateContentFiles são colocadas na lista de itens de ContentFile, na qual elas podem ser usadas como entradas para a tarefa BuildHelp. Usar o elemento Output dessa maneira fornece automaticamente as saídas de uma tarefa como entradas para outra tarefa para que você não precise listar os itens individuais ou listas de itens manualmente em cada tarefa.

Observação

Embora o destino Convert possa ser compilado incrementalmente, todas as saídas desse destino sempre serão necessárias como entradas para o destino Build. O MSBuild fornece automaticamente todas as saídas de um destino como entradas para outro destino quando você usa o elemento Output.

<Project DefaultTargets="Build"
    xmlns="http://schemas.microsoft.com/developer/msbuild/2003" >

    <ItemGroup>
        <TXTFile Include="*.txt"/>
        <XMLFiles Include="\metadata\*.xml"/>
    </ItemGroup>

    <Target Name = "Convert"
        Inputs="@(TXTFile)"
        Outputs="@(TXTFile->'%(Filename).content')">

        <GenerateContentFiles
            Sources = "@(TXTFile)">
            <Output TaskParameter = "OutputContentFiles"
                ItemName = "ContentFiles"/>
        </GenerateContentFiles>
    </Target>

    <Target Name = "Build" DependsOnTargets = "Convert"
        Inputs="@(ContentFiles);@(XMLFiles)"
        Outputs="$(MSBuildProjectName).help">

        <BuildHelp
            ContentFiles = "@(ContentFiles)"
            MetadataFiles = "@(XMLFiles)"
            OutputFileName = "$(MSBuildProjectName).help"/>
    </Target>
</Project>