Compartir a través de

Introducción a los archivos de configuración de Team Foundation Build

  • Artículo

En este tema se explican los archivos de configuración que utiliza la Plantilla de actualización. Para obtener más información sobre la Plantilla de actualización, vea Definir una compilación con la plantilla de actualización. Las características que se utilizan para generar estos archivos, como el Asistente para crear archivos de proyecto de MSBuild, solo están disponibles en Visual Studio Team System 2008.

Cuando se procesa una compilación de la Plantilla de actualización, Team Foundation Build utiliza el motor de MSBuild. El proceso lo controla un conjunto de archivos XML que se corresponden con el esquema de archivo de proyecto de MSBuild. Los elementos siguientes de estos archivos XML son importantes para el proceso de generación:

  • Elemento Target El elemento Target define cómo se compila el proyecto. Los elementos Target contienen un conjunto de tareas que MSBuild ejecuta secuencialmente. Para obtener más información acerca de los destinos, vea Objetivos de MSBuild.

  • Elemento Task El elemento Task especifica el código que se ejecutará durante el proceso de compilación. Para obtener más información acerca de las tareas, vea Tareas de MSBuild.

    MSBuild incluye una colección de tareas comunes que se pueden utilizar para personalizar el proceso de compilación. Para obtener más información, vea Referencia de tareas de MSBuild.

  • Elemento UsingTask El elemento UsingTask especifica el ensamblado que contiene las tareas utilizadas en el proceso de generación.

Los archivos de scripts de MSBuild pueden importar otros archivos de scripts. Por ejemplo, puede definir una configuración común en un archivo y, a continuación, incluirlo en otras configuraciones. Para obtener más información, vea Cómo: Utilizar el mismo destino en varios archivos de proyecto.

Tres archivos controlan el proceso de Team Foundation Build:

  • Microsoft.TeamFoundation.Build.targets

    Este archivo define el conjunto de tareas predeterminadas y destinos incluido con Team Foundation Build. Por ejemplo, Clean, DropBuild y Compile. Cada destino contiene las tareas que se van a llamar para ese destino concreto. Algunos destinos en este archivo dependen de otros destinos para formar una cadena de destinos que se va a ejecutar en un orden determinado. Por ejemplo, el destino Compile depende del destino BeforeCompile, de modo que cualquier tarea definida en el destino BeforeCompile se ejecuta antes que Compile. No todos los destinos definidos en este archivo se ejecutan necesariamente en cada generación. Por ejemplo, las compilaciones de escritorio no ejecutan el destino Clean.

    Microsoft.TeamFoundation.Build.targets se incluye con Visual Studio Application Lifecycle Management y se puede encontrar en el directorio <raíz>:\Archivos de programa\MSBuild\Microsoft\VisualStudio\TeamBuild\. Hay sólo una copia de este archivo en un equipo y todas las compilaciones que se ejecutan en ese equipo la comparten.

    Nota importanteImportante

    No modifique el archivo Microsoft.TeamFoundation.Build.targets. Si modifica el archivo, resultarán afectadas todas las definiciones de compilación. Para personalizar las definiciones de compilación, debe modificar el archivo TfsBuild.proj asociado a ellas.

  • TfsBuild.proj

    Éste es el archivo de configuración principal de Team Foundation Build. Se puede asociar a una única definición de compilación o puede compartirse entre varias definiciones de compilación. Este archivo almacena los parámetros de configuración que se proporcionan en el Asistente para crear archivos de proyecto de MSBuild. Entre estos parámetros se incluye el proyecto de equipo, el tipo de elemento de trabajo creado al interrumpirse la compilación, la configuración que se va a generar y las soluciones que se van a generar. El Asistente para crear archivos de proyecto de MSBuild crea este archivo cuando se crea un archivo de proyecto para una nueva definición de compilación. Para obtener más información, vea Crear una definición de compilación básica. Este archivo importa Microsoft.TeamFoundation.Build.targets y lo pasa a MSBuild. Todos los cambios realizados en este archivo afectan a las compilaciones de todas las definiciones de compilación asociadas. Este archivo se almacena de forma predeterminada en el control de código fuente bajo la carpeta $\miProyecto\TeamBuildTypes\definiciónDeCompilación, donde miProyecto es el nombre del proyecto de equipo y definiciónDeCompilación es el nombre de la definición de compilación. También puede almacenar este archivo en una ubicación diferente especificándola en el cuadro de diálogo Definición de compilación.

    El archivo TfsBuild.proj incluye ejemplos de uso en el texto de los comentarios. Entre estos ejemplos se incluye cómo llamar a destinos personalizados en el elemento SolutionToBuild y cómo pasar propiedades personalizadas a otros elementos.

  • TfsBuild.rsp

    Éste es un archivo vacío generado por el Asistente para crear archivos de proyecto de MSBuild. Este archivo se puede utilizar para especificar un registrador personalizado o invalidar las propiedades de MSBuild. Para obtener más información, vea Archivos de respuesta de MSBuild.

Destinos, propiedades y tareas

En los temas siguientes se describen los destinos, las tareas y las propiedades que se definen de manera predeterminada en Microsoft.TeamFoundation.Build.targets.

  • Destinos personalizables de Team Foundation Build
    Muestra los destinos definidos en Microsoft.TeamFoundation.Build.targets que puede invalidar especificando tareas personalizadas. En este tema se incluyen ejemplos que muestran cómo personalizar el proceso de compilación.

  • Propiedades personalizables de Team Foundation Build
    Muestra las propiedades predeterminadas que se definen en Microsoft.TeamFoundation.Build.targets que se pueden invalidar en el archivo TfsBuild.proj. En este tema también se incluyen ejemplos.

  • Tareas de Team Foundation Build
    Muestra las tareas predeterminadas definidas en Microsoft.TeamFoundation.Build.targets que puede modificar en el archivo TfsBuild.proj para personalizar definiciones de compilación. En este tema también se incluyen ejemplos.