Cómo: Generar versiones incrementalmente

Artículo
10/07/2008

Actualización: noviembre 2007

Cuando se genera un proyecto grande, es importante que los componentes que se generaron previamente y que aún están actualizados no se vuelvan a generar. Si todos los destinos se generan cada vez, llevará más tiempo finalizar la compilación. Para habilitar las compilaciones incrementales (aquéllas en las que sólo se generan los destinos no compilados con anterioridad o no actualizados), Microsoft Build Engine (MSBuild) compara las marcas de tiempo de los archivos de entrada con las de los archivos de resultados y determina si debe omitir, generar o volver a generar parcialmente un destino. Sin embargo, debe haber una asignación unívoca entre las entradas y resultados. Se pueden utilizar las transformaciones para permitir que los destinos identifiquen esta asignación directa. Para obtener más información sobre transformaciones, vea Transformaciones de MSBuild.

Especificar entradas y resultados

Es posible generar un destino de forma incremental si se han especificado las entradas y los resultados en el archivo de proyecto.

Para especificar las entradas y los resultados de un destino

Utilice los atributos Inputs y Outputs del elemento Target. Por ejemplo:

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

MSBuild compara las marcas de tiempo de los archivos de entrada con las de los archivos de resultados y determina si debe omitir, generar o volver a generar parcialmente un destino. En el ejemplo siguiente, si algún archivo de la colección de elementos @(CSFile) es más reciente que el archivo hello.exe file, MSBuild ejecutará el destino; de lo contrario, lo omitirá:

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

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

Cuando las entradas y los resultados están especificados en un destino, puede suceder que cada resultado sólo se asigne a una entrada o que no exista ninguna asignación directa entre resultados y entradas. Por ejemplo, en la tarea Csc (Tarea) anterior, el resultado hello.exe no se puede asignar a una única entrada porque depende de todas ellas.

Nota:
Un destino en el que no exista asignación directa entre entradas y resultados se generará con más frecuencia que un destino en el que cada resultado sólo se puede asignar a una entrada. Esto se debe a que MSBuild no puede determinar qué resultados necesitan volver a generarse si algunas de las entradas han cambiado.

Las tareas en las que se puede identificar una asignación directa entre resultados y entradas, como la tarea LC (Tarea), son más adecuadas para las generaciones incrementales que las tareas como Csc y Vbc, que producen un ensamblado de resultados a partir de una serie de entradas.

Ejemplo

En el ejemplo siguiente se usa un proyecto que genera archivos de Ayuda para un sistema de Ayuda hipotético. El proyecto convierte archivos .txt de código fuente en archivos .content intermedios que, después, se combinan con archivos XML de metadatos para generar el archivo .help definitivo del sistema de Ayuda. El proyecto usa las tareas hipotéticas siguientes:

GenerateContentFiles: Convierte archivos .txt en archivos .content.
BuildHelp: Combina archivos .content y archivos XML de metadatos para generar el archivo .help final.

El proyecto usa transformaciones para crear una asignación unívoca entre las entradas y los resultados en la tarea GenerateContentFiles. Para obtener más información, vea Transformaciones de MSBuild. Asimismo, el elemento Output se establece para que utilice automáticamente los resultados de la tarea GenerateContentFiles como entradas para la tarea BuildHelp.

Este archivo de proyecto contiene los destinos Convert y Build. Las tareas GenerateContentFiles y BuildHelp se colocan respectivamente en los destinos Convert y Build para que se pueda generar cada destino incrementalmente. Al usar el elemento Output, los resultados de la tarea GenerateContentFiles se colocan en la colección de elementos ContentFile, donde se pueden usar como entradas para la tarea BuildHelp. Si usa el elemento Output de esta manera, proporcionará automáticamente los resultados de una tarea como entradas para otra tarea y no será necesario enumerar cada elemento o las colecciones de elementos de cada tarea.

Nota:
Aunque el destino GenerateContentFiles se puede generar de forma incremental, siempre se necesitarán todos los resultados de dicho destino como entradas para el destino BuildHelp. MSBuild proporciona automáticamente todos los resultados de un destino como entradas para otro destino cuando se utiliza el elemento Output.

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

    <ItemGroup>
        <TXTFile Include="*.txt"/>
        <XMLFile 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 = "@(XMLFile)"
            OutputFileName = "$(MSBuildProjectName).help"/>
    </Target>
</Project>