Tareas de Team Foundation Build
Actualización: noviembre 2007
Las tareas de MSBuild están incluidas en destinos. Estas tareas proporcionan el código que se ejecuta durante el proceso de compilación. MSBuild proporciona una biblioteca de tareas comunes. Para obtener más información, vea Referencia de tareas de MSBuild.
El archivo .targets de MSBuild para Team Foundation Build, Microsoft.TeamFoundation.Build.targets, define varias tareas de Team Foundation Build predeterminadas que puede personalizar estableciendo las propiedades en el archivo TfsBuild.proj. Por ejemplo, el destino CoreGet contiene una tarea Get que permite recuperar un conjunto de cambios específico para un tipo de compilación. De forma predeterminada, la tarea Get recupera los archivos más recientes. Para obtener más información sobre los archivos .targets, vea Archivos .Targets de MSBuild.
Lista de tareas predeterminadas de Microsoft.TeamFoundation.Build.targets
Las tareas siguientes se pueden personalizar modificando sus propiedades.
Tarea de Team Foundation Build |
Destino asociado |
|---|---|
|
Sincroniza los orígenes en el equipo de compilación. También provoca eventos de registro para informar al registrador de cada archivo y versión recuperados en el área de trabajo local. |
Get |
|
Etiqueta todos los archivos de código fuente de un área de trabajo especificada. |
Label |
GenCheckinNotesUpdateWorkItems (Tarea) Genera la lista de todos los conjuntos de cambios y elementos de trabajo que se crearon o resultaron afectados durante una compilación. Las etiquetas se utilizan para etiquetar una compilación determinada. |
Si la compilación se realiza correctamente, se invoca al destino GetChangeSetsAndUpdateWorkitems. Si la compilación no se realiza correctamente, se invoca al destino GetChangeSetsOnBuildBreak. |
|
Crea un nuevo elemento de trabajo para los errores que se producen durante el proceso de compilación. Asimismo, actualiza el campo Found In del elemento de trabajo con un vínculo al número de versión de compilación específico. |
CreateWorkItem |
|
Crea una nueva área de trabajo en el equipo de compilación. |
InitializeWorkspace |
|
Elimina el área de trabajo creada durante la ejecución de la compilación. Los archivos reales no se eliminan del equipo de compilación. Si el área de trabajo especificada no existe, DeleteWorkspaceTask envía una advertencia. |
InitializeWorkspace |
UpdateBuildNumberDropLocation (Tarea) Crea una carpeta en una ubicación especificada para almacenar los archivos generados. Además, actualiza el número de versión de compilación. |
InitializeEndToEndIteration |
|
Ejecuta un conjunto de pruebas durante la compilación y publica los resultados. |
RunTestWithConfiguration |
|
Inserta los pasos de compilación en la compilación. |
None |
|
Genera los valores iniciales de las propiedades de compilación. |
InitializeBuildProperties |
|
Establece todas las propiedades que se pueden establecer en la compilación. |
None |
WorkspaceItemConverterTask (Tarea) Convierte los elementos del servidor del control de versiones en elementos del área de trabajo locales, y los elementos locales en elementos del servidor del control de versiones. |
ResolveSolutionPathsForEndToEndIteration y ResolveTestFilesForEndToEndIteration |
Modificar las tareas de Team Foundation Build
Para modificar las tareas definidas en el archivo de definición Microsoft.TeamFoundation.Build.targets, examine las propiedades de la tarea que desea modificar y, a continuación, especifique dichas propiedades en el archivo TfsBuild.proj para el tipo de compilación de Team Foundation Build. La tarea CreateNewWorkItem se define de la manera siguiente.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
BuildId="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
Para personalizar el elemento de trabajo que se crea en caso de un error de compilación, establezca WorkItemFieldValues en el archivo TFSBuild.proj:
.gif "Nota") Nota: |
|---|
En el ejemplo siguiente se asume que se han establecido también las propiedades Areapath e IterationPath. |
<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>
Vea también
Tareas
Cómo: Utilizar variables de entorno al generar
Conceptos
Introducción a los archivos de configuración de Team Foundation Build