MSBuild (attività)

Compila progetti MSBuild da un altro progetto MSBuild.

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività MSBuild.

Osservazioni:

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe TaskExtension, che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

A differenza dell'uso dell'attività Exec per avviare MSBuild.exe, questa attività usa lo stesso processo MSBuild per compilare i progetti figlio. L'elenco di destinazioni già compilate che possono essere ignorate viene condiviso tra le compilazioni padre e figlio. Questa attività è anche più veloce perché non viene creato alcun nuovo processo MSBuild.

Questa attività può elaborare non solo i file di progetto, ma anche i file di soluzione.

Qualsiasi configurazione richiesta da MSBuild per consentire ai progetti di compilare contemporaneamente, anche se la configurazione prevede un'infrastruttura remota (ad esempio porte, protocolli, timeout, tentativi e così via), deve essere resa configurabile tramite un file di configurazione. Se possibile, gli elementi di configurazione devono essere specificati come parametri dell'attività nell'attività MSBuild.

A partire da MSBuild 3.5, i progetti di soluzione ora esecuno TargetOutputs da tutti i sottoproi progetti compilati.

Passare proprietà a progetti

Nelle versioni di MSBuild precedenti a MSBuild 3.5, il passaggio di diversi set di proprietà a progetti diversi elencati nell'elemento MSBuild era complesso. Se è stato usato l'attributo Properties dell'attività MSBuild, l'impostazione è stata applicata a tutti i progetti in corso di compilazione, a meno che l'attività MSBuild non sia stata divisa in batch e non siano state fornite proprietà diverse in modo condizionale per ogni progetto nell'elenco di elementi.

MSBuild 3.5, tuttavia, fornisce due nuovi elementi di metadati riservati, Proprietà e Proprietà aggiuntive, che consentono di passare proprietà diverse per progetti diversi compilati usando l'attività MSBuild.

Vantaggi della compilazione a più processori

Uno dei vantaggi principali derivanti dall'uso di questi nuovi metadati consiste nel compilare i progetti in parallelo in un sistema a più processori. I metadati consentono di consolidare tutti i progetti in una singola chiamata di attività MSBuild senza dover eseguire attività msbuild in batch o condizionali. E quando si chiama un'unica attività MSBuild, tutti i progetti elencati nell'attributo Projects vengono compilati in parallelo, Tuttavia, solo se l'attributo è presente nell'attività BuildInParallel=true MSBuild. Per altre informazioni, vedere Creare più progetti in parallelo.

Metadati Properties

Quando specificati, i metadati Properties eseguono l'override del parametro Properties dell'attività, mentre i metadati AdditionalProperties vengono accodati alle definizioni del parametro.

Uno scenario comune è quello in cui si compilano più file di soluzione tramite l'attività MSBuild, usando però configurazioni della build diverse. Potrebbe essere necessario compilare la soluzione a1 usando la configurazione per il debug e la soluzione a2 usando la configurazione per la versione. In MSBuild 2.0 questo file di progetto sarà simile al seguente:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Debug"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release"/>
    </Target>
</Project>

Usando i metadati Properties, tuttavia, è possibile semplificare l'operazione e usare una sola attività MSBuild, come illustrato di seguito:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <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>

- oppure -

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <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>

Metadati AdditionalProperties

Si consideri lo scenario seguente, in cui due file di soluzione vengono compilati tramite l'attività MSBuild. Entrambi usano la configurazione per il rilascio, ma uno usa l'architettura x86 e l'altro l'architettura ia64. In MSBuild 2.0 è necessario creare più istanze dell'attività MSBuild: una per compilare il progetto usando la configurazione release con l'architettura x86, l'altra usando la configurazione release con l'architettura ia64. Il file di progetto sarà come il seguente:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Release;
          Architecture=x86"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release;
          Architecture=ia64"/>
    </Target>
</Project>

Usando i metadati AdditionalProperties è possibile semplificare l'operazione e usare una sola attività MSBuild, come illustrato di seguito:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <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>

Esempio

L'esempio seguente usa l'attività MSBuild per compilare i progetti specificati dalla raccolta di elementi ProjectReferences. Gli output di destinazione risultanti vengono archiviati nella raccolta di elementi AssembliesBuiltByChildProjects.

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

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

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

</Project>

Vedi anche

• Attività
• Attività MSBuild