Tarefa MSBuild

Cria projetos do MSBuild a partir de outro projeto do MSBuild.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa MSBuild.

Observações

Além dos parâmetros listados anteriormente, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte classe base TaskExtension.

Ao contrário de usar o de tarefas Exec para iniciar MSBuild.exe, essa tarefa usa o mesmo processo MSBuild para criar os projetos filho. A lista de destinos já criados que podem ser ignorados é compartilhada entre as compilações pai e filho. Esta tarefa também é mais rápida porque nenhum novo processo MSBuild é criado.

Esta tarefa pode processar não apenas arquivos de projeto, mas também arquivos de solução. No MSBuild 17.12 e posterior, os formatos de arquivo de solução .slnx e .sln são aceitos.

Qualquer configuração exigida pelo MSBuild para permitir que projetos sejam compilados ao mesmo tempo, mesmo que a configuração envolva infraestrutura remota (por exemplo, portas, protocolos, tempos limites, tentativas e assim por diante), deve ser configurada usando um arquivo de configuração. Sempre que possível, os itens de configuração devem poder ser especificados como parâmetros de tarefa na tarefa MSBuild.

A partir do MSBuild 3.5, os projetos de solução agora apresentam TargetOutputs de todos os subprojetos que cria.

Passar propriedades para projetos

Em versões do MSBuild anteriores ao MSBuild 3.5, passar diferentes conjuntos de propriedades para diferentes projetos listados no item MSBuild era um desafio. Se você usou o atributo Properties do de tarefas do MSBuild, sua configuração foi aplicada a todos os projetos que estão sendo criados, a menos que você tenha colocado em lote a tarefa MSBuild e fornecido condicionalmente propriedades diferentes para cada projeto na lista de itens.

MSBuild 3.5, no entanto, fornece dois novos itens de metadados reservados, Properties e AdditionalProperties, que fornecem uma maneira flexível de passar propriedades diferentes para diferentes projetos que estão sendo criados usando o tarefa MSBuild.

Benefícios da compilação de vários processadores

Um dos principais benefícios de usar esses novos metadados ocorre quando você constrói seus projetos em paralelo em um sistema com vários processadores. Os metadados permitem que você consolide todos os projetos em um único tarefa MSBuild chamada sem ter que executar qualquer lote ou tarefas condicionais do MSBuild. E quando você chama apenas uma única tarefa do MSBuild, todos os projetos listados no atributo Projects são criados em paralelo. (Apenas, no entanto, se o atributo BuildInParallel=true estiver presente na tarefa MSBuild.) Para obter mais informações, consulte Criar vários projetos em paralelo.

Metadados de propriedades

Quando especificado, os metadados Properties substituem o parâmetro Properties da tarefa, enquanto metadados AdditionalProperties são acrescentados às definições do parâmetro.

Um cenário comum é quando você está criando vários arquivos de solução usando a tarefa MSBuild, usando apenas configurações de compilação diferentes. Você pode querer criar a solução a1 usando a configuração Debug e a solução a2 usando a configuração Release. No MSBuild 2.0, esse arquivo de projeto teria a seguinte aparência:

a.proj

<Project>
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Debug"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release"/>
    </Target>
</Project>

Usando os metadados Properties, no entanto, você pode simplificar esse código para usar uma única tarefa MSBuild, conforme mostrado pelo exemplo a seguir:

a.proj

<Project>
    <ItemGroup>
        <ProjectToBuild Include="a1.sln...">
            <Properties>Configuration=Debug</Properties>
        </ProjectToBuild>
        <ProjectToBuild Include="a2.sln">
            <Properties>Configuration=Release</Properties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"/>
    </Target>
</Project>

- ou -

<Project>
    <ItemGroup>
        <ProjectToBuild Include="a1.sln..."/>
        <ProjectToBuild Include="a2.sln">
            <Properties>Configuration=Release</Properties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"
          Properties="Configuration=Debug"/>
    </Target>
</Project>

Metadados AdditionalProperties

Considere o seguinte cenário em que você está criando dois arquivos de solução usando a tarefa MSBuild, ambos usando a configuração Release, mas um usando a arquitetura x86 e o outro usando a arquitetura ia64. No MSBuild 2.0, você precisaria criar várias instâncias da tarefa MSBuild: uma para construir o projeto usando a configuração Release com a arquitetura x86, a outra usando a configuração Release com a arquitetura ia64. Seu arquivo de projeto teria a seguinte aparência:

a.proj

<Project>
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Release;
          Architecture=x86"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release;
          Architecture=ia64"/>
    </Target>
</Project>

Usando os metadados AdditionalProperties, você pode simplificar isso para usar um único de tarefas do MSBuild usando o seguinte:

a.proj

<Project>
    <ItemGroup>
        <ProjectToBuild Include="a1.sln...">
            <AdditionalProperties>Architecture=x86
              </AdditionalProperties>
        </ProjectToBuild>
        <ProjectToBuild Include="a2.sln">
            <AdditionalProperties>Architecture=ia64
              </AdditionalProperties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"
          Properties="Configuration=Release"/>
    </Target>
</Project>

Exemplo

O exemplo a seguir usa a tarefa MSBuild para criar os projetos especificados pela coleção ProjectReferences item. As saídas de destino resultantes são armazenadas na coleção de itens AssembliesBuiltByChildProjects.

<Project>

    <ItemGroup>
        <ProjectReferences Include="*.*proj" />
    </ItemGroup>

    <Target Name="BuildOtherProjects">
        <MSBuild
            Projects="@(ProjectReferences)"
            Targets="Build">
            <Output
                TaskParameter="TargetOutputs"
                ItemName="AssembliesBuiltByChildProjects" />
        </MSBuild>
    </Target>

</Project>

Ver também

• Tarefas
• Referência de tarefa