Propiedades personalizables de Team Foundation Build
Actualización: noviembre 2007
Las propiedades de MSBuild son pares de clave y valor que puede utilizar para configurar las compilaciones. Para obtener más información, vea Propiedades de MSBuild.
El archivo Microsoft.TeamFoundation.Build.targets define varios destinos, tareas y propiedades de MSBuild para Team Foundation Build. Estas propiedades se pueden modificar en el archivo TFSBuild.proj para:
Pasar valores a tareas y destinos de Team Foundation Build
Invalidar algunas acciones de compilación
Para obtener más información sobre el archivo TFSBuld.proj, vea Introducción a los archivos de configuración de Team Foundation Build.
En este documento
Personalizar las compilaciones de VC++
Propiedades utilizadas para personalizar tareas
Propiedades que se pueden reemplazar
En la tabla siguiente se muestran las propiedades que se definen para Team Foundation Build. Puede invalidarlas en el archivo TfsBuild.proj para personalizar el proceso de compilación. Para obtener más información, vea Cómo: Personalizar el grupo de elementos SolutionToBuild.
Propiedad |
Descripción |
|---|---|
CustomPropertiesForClean |
Establezca esta propiedad para pasar valores personalizados a cada solución cuando Team Foundation Build llame al destino Clean. |
CustomPropertiesForBuild |
Establezca esta propiedad para pasar valores personalizados a cada solución cuando Team Foundation Build llame a su destino predeterminado (normalmente Build). |
SkipClean |
Establezca esta propiedad para omitir el destino CoreClean. |
IncrementalGet |
Establezca esta propiedad en true para realizar una operación Get incremental. Ésta es una propiedad muy útil que establece CleanCompilationOutputOnly en true, SkipInitializeWorkspace en true y ForceGet en false. |
IncrementalBuild |
Establezca esta propiedad en true para realizar una compilación incremental. Ésta es una propiedad muy útil que establece SkipClean en true, SkipInitializeWorkspace en true y ForceGet en false. |
CleanCompilationOutputOnly |
Establezca esta propiedad en true para eliminar únicamente los ensamblados intermedios del directorio de origen durante la ejecución del destino CoreClean. Si esta propiedad está establecida en false, todo el directorio de origen se eliminará durante la ejecución del destino CoreClean. |
SkipGetChangesetsUpdateWorkItems |
Establezca esta propiedad en true para omitir la asociación de conjuntos de cambios y actualización de elementos de trabajo para las compilaciones que se han realizado correctamente. |
SolutionRoot |
Establezca esta propiedad para señalar a la raíz de la carpeta de código fuente en el equipo de compilación. |
BinariesRoot |
Establezca esta propiedad para señalar a la raíz de la carpeta de binarios en el equipo de compilación. |
LabelComment |
Establezca esta propiedad para definir el comentario utilizado por la tarea Label. |
LabelName |
Establezca este nombre de etiqueta para definir el nombre utilizado por la tarea Label. De manera predeterminada, el nombre de etiqueta se establece en $(NúmeroCompilación) en el destino InitializeEndToEndIteration. |
OutDir |
Establezca esta propiedad para definir la ubicación de los archivos de resultados en el directorio de trabajo de la compilación. |
UpdateAssociatedWorkItemsOnBuildBreak |
Establezca esta propiedad en true para actualizar los elementos de trabajo asociados incluso en las compilaciones interrumpidas. |
StopOnFirstFailure |
Establezca esta propiedad en true para detener la limpieza, compilación y comprobación cuando se detecte el primer error durante la ejecución de la compilación. |
SkipGet |
Establezca esta propiedad para omitir el destino CoreGet. |
SkipLabel |
Establezca esta propiedad para omitir el destino CoreLabel. |
SkipInitializeWorkspace |
Establezca esta propiedad para omitir el destino CoreInitializeWorkspace. |
SkipInvalidConfigurations |
Establezca esta propiedad en false para generar un error en lugar de una advertencia cuando el usuario encuentre una configuración no válida. |
SkipPostBuild |
Establezca esta propiedad para omitir la recolección asociada a los conjuntos de cambios y elementos de trabajo. |
SkipDropBuild |
Establezca esta propiedad para omitir el destino CoreDropBuild. |
SkipWorkItemCreation |
Establezca esta propiedad para omitir el destino CoreCreateWorkItem. |
CustomizableOutDir |
Establezca esta propiedad en true cuando desee evitar que Team Foundation Build establezca OutDir para cada solución. Tenga en cuenta que puede utilizar la propiedad TeamBuildPublishDir para recuperar el valor que Team Foundation Build habría asignado a PublishDir si CustomizablePublishDir estuviera establecida en false. |
CustomizablePublishDir |
Establezca esta propiedad en true cuando desee evitar que Team Foundation Build establezca el directorio PublishDir para cada solución. Tenga en cuenta que puede utilizar la propiedad TeamBuildPublishDir para recuperar el valor que Team Foundation Build habría asignado a PublishDir si CustomizablePublishDir estuviera establecida en false. |
Personalizar las compilaciones de VC++
Team Foundation Build permite también personalizar la compilación de proyectos de Visual C++. Puede utilizar las propiedades siguientes para establecer las propiedades correspondientes en la tarea de VCBuild utilizada por MSBuild para generar proyectos de Visual C++. Para obtener más información, vea VCBuild (Tarea).
Propiedad de Team Build |
Propiedad Task de VCBuild |
Descripción |
|---|---|---|
VCBuildAdditionalLibPaths |
AdditionalLibPaths |
Especifica rutas de acceso adicionales para buscar bibliotecas antes de que se busque en las rutas de acceso de las variables de entorno LIB (corresponde a la opción de LIBPATH de LINK.exe). |
VCBuildAdditionalOptions |
AdditionalOptions |
Especifica opciones de la línea de comandos adicionales sin parámetros de tareas dedicados. |
VCBuildToolPath |
ToolPath |
Especifica la ubicación desde la que la tarea de VCBuild cargará el archivo ejecutable subyacente (VCBuild.exe). |
VCBuildUseEnvironment |
UseEnvironment |
Establezca esta propiedad en true para utilizar las variables de entorno de PATH, INCLUDE, LIBS y LIBPATH. En caso contrario, establezca esta propiedad en false. Esta propiedad corresponde a la opción /useenv del comando VCBuild.exe. Para obtener más información, vea /useenv. |
AdditionalVCOverrides |
Ninguno |
Utilice esta propiedad para especificar opciones adicionales para los archivos de hojas de tareas de VCBuild generados por Team Foundation Build y especificados en la propiedad Override de la tarea VCBuild. |
Propiedades utilizadas para personalizar tareas
Cada tarea predeterminada de Team Foundation Build en el archivo Microsoft.TeamFoundation.Build.targets incluye también un conjunto de propiedades que se pueden utilizar para personalizar la tarea. Para obtener más información sobre las tareas de Team Foundation Build, vea Tareas de Team Foundation Build. Por ejemplo, la tarea CreateNewWorkItem se define del modo siguiente.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
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