Tutorial: Agregar pasos de compilación mediante la tarea BuildStep
Actualización: noviembre 2007
Una tarea BuildStep es una tarea de MSBuild escrita específicamente para Team Foundation Server. Para agregar una tarea BuildStep a una compilación, agregue uno o más elementos BuildStep a un elemento Target en el archivo TFSBuild.proj de la definición de compilación de la solución.
Requisitos previos
Antes de poder agregar una tarea BuildStep a una definición de compilación, debe tener lo siguiente:
Vaya al archivo TFSBuild.proj para la definición de compilación que desea personalizar. Para obtener más información acerca de cómo crear definiciones de compilación, vea Cómo: Crear una definición de compilación.
.gif "Nota importante")
Nota importante:Cuando se personaliza el archivo TFSBuild.proj, se personalizan todas las definiciones de compilación asociadas a dicho archivo.
Área de trabajo local que contiene los archivos de proyecto de equipo y los archivos de compilación. Para obtener más información, vea Cómo: Crear un área de trabajo asignada y Cómo: Obtener el código fuente para el proyecto de equipo.
Permisos necesarios
Para realizar los procedimientos de este tema, los permisos Proteger y Desproteger deben estar establecidos en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.
Para agregar pasos de compilación mediante la tarea BuildStep, siga estos procedimientos:
Agregar una tarea al archivo de proyecto
Agregar un paso de compilación informativo al archivo de proyecto
Agregar una tarea al archivo de proyecto
Puede utilizar la tarea BuildStep para agregar y actualizar los pasos de compilación. Este procedimiento describe cómo modificar el archivo TFSBuild.proj del modo siguiente:
Agregue un paso de compilación.
Realice una tarea.
Actualice el paso de compilación con el estado Correcto si la tarea es la correcta o con el estado Error si la tarea no es la correcta.
La tarea de los pasos de compilación del ejemplo copia los archivos de código fuente en una nueva ubicación.
Para agregar y actualizar un paso de compilación en el archivo TFSBuild.proj
Inicie Visual Studio.
Desproteja el archivo TFSBuild.proj que desea modificar desde Control de versiones de Team Foundation y ábralo en el editor XML de Visual Studio.
Agregue el XML siguiente al elemento <ItemGroup>. Puede agregar el XML al elemento <ItemGroup> existente o puede agregar un nuevo elemento <ItemGroup>:
.gif "Nota")
Nota:El código en este paso identifica las carpetas en las que se encuentran los archivos de código fuente que se van a copiar. Es posible que otras tareas de MSBuild requieran realizar más adiciones al XML. Para obtener más información sobre los requisitos para tareas de MSBuild, vea Referencia de tareas de MSBuild.
<ItemGroup> <SourceFileFolder Include="C:\WorkingFolder\TeamBuildTypes\**\*.cs" /> </ItemGroup>Agregue el XML siguiente al final del archivo TFSBuild.proj justo antes del elemento </Project>:
</ItemGroup> <Target Name="BeforeCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Working..."> <Output TaskParameter="Id" PropertyName="StepId" /> </BuildStep> <!-- Perform a task... --> <Copy SourceFiles="@(SourceFileFolder)" DestinationFolder="C:\NewSourceFileFolder" /> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Succeeded" /> <OnError ExecuteTargets="MarkBuildStepAsFailed" /> </Target> <Target Name="MarkBuildStepAsFailed"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Failed" /> </Target> </Project>Nota:Para obtener más información sobre los destinos de Team Foundation Build y una lista de destinos personalizables, vea Destinos personalizables de Team Foundation Build.
Guarde los cambios y, a continuación, cierre TFSBuild.proj.
Proteja el archivo TFSBuild.proj en el control de versiones.
Ejecute la definición de compilación.
Para obtener más información, vea Cómo: Poner en cola o iniciar una definición de compilación.
Puede ver el mensaje del paso de compilación en Build Explorer y ver los procesos completos de creación y actualización de pasos de compilación en el registro de compilación. También puede ver los archivos copiados en el directorio especificado. Para obtener más información, vea Cómo: Supervisar el progreso de compilación.
Agregar un paso de compilación informativo al archivo de proyecto
Si no tiene que realizar una tarea pero desea agregar un paso de compilación informativo, no utilice la propiedad Id Output y establezca el estado de inmediato. Este procedimiento agrega solo un mensaje al proceso de compilación que ve al abrir la compilación en Build Explorer.
Para agregar un paso de compilación informativo al archivo TFSBuild.proj
Inicie Visual Studio.
Desproteja el archivo TFSBuild.proj que desea modificar desde Control de versiones de Team Foundation y ábralo en el editor XML de Visual Studio.
Agregue el XML siguiente al final del archivo TFSBuild.proj justo antes de la etiqueta </Project>:
</ItemGroup> <Target Name="AfterCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Compile step complete." Status="Succeeded" /> </Target> </Project>Nota:Para obtener más información sobre los destinos de Team Foundation Build y una lista de destinos personalizables, vea Destinos personalizables de Team Foundation Build.
Guarde los cambios y, a continuación, cierre TFSBuild.proj.
Proteja el archivo TFSBuild.proj en el control de versiones.
Ejecute la definición de compilación.
Para obtener más información, vea Cómo: Poner en cola o iniciar una definición de compilación.
Puede ver el mensaje en Build Explorer y en el registro de compilación. Para obtener más información, vea Cómo: Supervisar el progreso de compilación.