tareas de MSBuild

Compila proyectos de MSBuild desde otro proyecto de MSBuild.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea MSBuild .

Comentarios

Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte TaskExtension base class.

A diferencia de utilizar la tarea Exec para iniciar MSBuild.exe, esta tarea utiliza el mismo proceso MSBuild para compilar los proyectos secundarios. La lista de destinos ya generados que se pueden omitir se comparte entre las compilaciones primarias y secundarias. Esta tarea también es más rápida porque no se crea ningún proceso MSBuild nuevo.

Esta tarea puede procesar no solo los archivos del proyecto, sino también los archivos de solución.

Cualquier configuración que MSBuild necesite para activar la compilación simultánea de proyectos, incluso si la configuración implica una infraestructura remota (por ejemplo, puertos, protocolos, tiempos de espera, reintentos, etc.), debe poder configurarse mediante el uso de un archivo de configuración. Cuando sea posible, los elementos de configuración deben especificarse como parámetros de tarea en la tarea MSBuild.

A partir de MSBuild 3.5, los proyectos de soluciones emergen de TargetOutputs desde todos los subproyectos que compila.

Pasar propiedades a proyectos

En las versiones de MSBuild anteriores a MSBuild 3.5, pasar distintos conjuntos de propiedades a diferentes proyectos enumerados en el elemento MSBuild era una tarea ardua. Si usó el atributo de propiedades de la tarea MSBuild, su configuración se aplicaba a todos los proyectos que se estaban compilando, a menos que procesara por lotes la tarea MSBuild y proporcionara condicionalmente diferentes propiedades para cada proyecto de la lista de elementos.

MSBuild 3.5, en cambio, ofrece dos nuevos elementos de metadatos reservados, Properties y AdditionalProperties, que proporcionan una manera flexible de pasar propiedades diferentes para distintos proyectos que se están compilando con la tarea MSBuild.

Ventajas de la compilación de varios procesadores

Una de las principales ventajas de utilizar estos nuevos metadatos se produce cuando se compilan los proyectos en paralelo en un sistema de varios procesadores. Los metadatos permiten consolidar todos los proyectos en una sola llamada de la tarea MSBuild sin tener que realizar ningún procesamiento por lotes ni tareas MSBuild condicionales. Y cuando se llama únicamente a una sola tarea MSBuild, todos los proyectos que aparecen en el atributo Projects se compilarán en paralelo. (Solo, sin embargo, si el atributo BuildInParallel=true está presente en la tarea MSBuild). Para más información, consulte Compilar varios proyectos en paralelo.

Metadatos de propiedades

Cuando se especifican, los metadatos Properties reemplazan el parámetro Propiedades de la tarea, mientras que los metadatos AdditionalProperties se anexan a las definiciones del parámetro.

Un escenario común es cuando se compilan varios archivos de solución mediante la tarea MSBuild, solo con diferentes configuraciones de compilación. Otra opción es compilar la solución a1 con la configuración de depuración y la solución a2 con la configuración de versión. En MSBuild 2.0, este archivo del proyecto tendría el aspecto siguiente:

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>

Sin embargo, mediante el uso de los metadatos de propiedades, puede simplificar este proceso para utilizar una sola tarea MSBuild, como se muestra a continuación:

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>

O bien

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

Metadatos de AdditionalProperties

Considere un escenario en que se están compilando dos archivos de solución mediante la tarea MSBuild, ambos con la configuración de versión, pero uno mediante la arquitectura x86 y otro con la arquitectura ia64. En MSBuild 2.0, habría que crear varias instancias de la tarea MSBuild: una para compilar el proyecto mediante la configuración de versión con la arquitectura x86, la otra mediante la configuración de versión con la arquitectura ia64. El archivo del proyecto tendría el aspecto siguiente:

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>

Con el uso de los metadatos AdditionalProperties, puede simplificar este proceso para utilizar una sola tarea MSBuild mediante lo siguiente:

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>

Ejemplo

En el ejemplo siguiente se utiliza la tarea MSBuild para compilar los proyectos especificados por la colección de elementos ProjectReferences. Los resultados de destino resultantes se almacenan en la colección de elementos 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>

Vea también

• Tareas
• Referencia de tareas