Introducción a los archivos de configuración de Team Foundation Build
Actualización: noviembre 2007
Team Foundation Build utiliza el motor de MSBuild. Un conjunto de archivos XML que se corresponden con el esquema de archivo de proyecto de MSBuild controla todo el proceso de Team Foundation Build. Los elementos siguientes de estos archivos XML son importantes para el proceso de generación:
Elemento Target El elemento Target define cómo se genera 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 secuencias de comandos de MSBuild pueden importar otros archivos de secuencias de comandos. 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.
Dos 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 Team System 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.
.gif "Nota importante")
Nota importante: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 nuevo archivo de proyecto para una nueva definición de compilación. Para obtener más información, vea Cómo: Crear una definición de compilación. 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.
Asimismo, los archivos siguientes son importantes:
TfsBuildService.exe.config
Puede utilizar el archivo TfsBuildService.exe.config para configurar determinados aspectos de Team Foundation Build. TfsBuildService.exe.config incluye opciones para el puerto utilizado para comunicar con el servidor de Team Foundation; para configurar el número máximo de procesos utilizado por Team Foundation Build; para generar errores y advertencias por proyecto o por plataforma y combinación de configuraciones; y para modificar los nombres de los subdirectorios de código fuente, archivos binarios y resultados de las pruebas en un agente de compilación. Para obtener más información, vea Cómo: Modificar la configuración del archivo TfsBuildService.exe.config.
El archivo TfsBuildService.exe.config file se encuentra en <raíz>:\Archivos de programa\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies en un servidor de nivel de aplicación.
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 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. Incluye 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 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 se incluyen ejemplos.
Vea también
Tareas
Tutorial: Personalizar Team Foundation Build con una tarea personalizada