Cómo: Crear una definición de compilación
Actualización: noviembre 2007
Team Foundation Build utiliza definiciones de compilación para configurar las condiciones en las que se generará una solución única o un conjunto de soluciones en un proyecto de equipo. Para realizar una compilación, debe crear una nueva definición de compilación o utilizar una definición de compilación existente.
Cuando se crean definiciones de compilación mediante el cuadro de diálogo Definición de compilación, se pueden establecer varias opciones. Entre estas opciones se incluyen el nombre de la compilación, el área de trabajo de control de código fuente para los archivos que se van a generar y la ubicación del archivo de proyecto TFSBuild.proj, el agente de compilación, la directiva de retención de compilación y el desencadenador de la compilación. Si no tiene un archivo de proyecto de MSBuild existente, puede utilizar el cuadro de diálogo Definición de compilación para iniciar el Asistente para crear archivos de proyecto de MSBuild y crear un nuevo archivo TFSBuild.proj para la definición de compilación. También puede iniciar el cuadro de diálogo Propiedades de agente de compilación para crear un nuevo agente de compilación.
Después de crear una nueva definición de compilación, puede cambiar estas opciones. Para obtener más información, vea Cómo: Editar una definición de compilación.
Puede personalizar aún más las definiciones de compilación editando el archivo TFSBuild.proj escrito en formato de MSBuild. Para obtener más información, vea Personalizar Team Foundation Build.
Las definiciones de compilación se quitan eliminando primero las compilaciones asociadas a ellas. A continuación, se puede eliminar la propia definición de compilación. Para obtener más información, vea Cómo: Eliminar una definición de compilación.
Permisos necesarios
Para realizar este procedimiento, debe tener el permiso Administrar una generación establecido en Permitir. Además, la cuenta de servicio del nivel de aplicación y la cuenta de servicio de Team Foundation Build deben tener permisos de lectura y escritura en la ubicación de destino de la compilación. Para obtener más información, vea Permisos de Team Foundation Server.
Para crear una nueva definición de compilación
En Team Explorer, seleccione el proyecto para el que desea crear una nueva definición de compilación.
En el menú Generar, seleccione Definición de nueva compilación.
Aparece el cuadro de diálogo Definición de compilación con la ficha General seleccionada.
.gif "Sugerencia")
Sugerencia:Las fichas que tienen un icono de advertencia junto a ellas requieren que se especifiquen datos.
Especifique el nombre que se va a asociar a la definición de compilación en el cuadro de texto Nombre de definición de compilación.
El nombre que escriba debe ser un nombre de archivo de Windows único y válido.
Agregue una descripción adecuada en el cuadro de texto Descripción.
Esta descripción aparece en el cuadro de diálogo Poner en cola compilación "<nombre del proyecto de equipo>". Para obtener más información, vea Cómo: Poner en cola o iniciar una definición de compilación.
Haga clic en la ficha Área de trabajo.
La tabla Carpetas de trabajo incluye de forma predeterminada la carpeta de control de código fuente del proyecto de equipo para el que se van a crear las nuevas definiciones de compilación y una carpeta local del agente de compilación. La carpeta local del agente de compilación se muestra en la columna Carpeta local. Todas las rutas de acceso de área de trabajo del agente de compilación se asignan respecto al directorio raíz predeterminado que se muestra.
Para copiar un área de trabajo existente en la lista de carpetas de trabajo, haga clic en el botón Copiar área de trabajo existente para iniciar el cuadro de diálogo Seleccione un área de trabajo que copiar.
El área de trabajo que selecciona se convierte en un elemento secundario del directorio raíz común del agente de compilación.
También puede hacer clic en una celda de tabla vacía en la Carpeta de control de código fuente y, a continuación, hacer clic en los puntos suspensivos (…) para buscar la carpeta de control de código fuente que va a agregar como carpeta de trabajo. La carpeta de control de código fuente que selecciona se normaliza también en el directorio raíz común del agente de compilación.
Haga clic en la ficha Archivo de proyecto. En el panel Archivo de proyecto puede buscar un archivo de proyecto TFSBuild.proj existente o iniciar el Asistente para crear archivos de proyecto de MSBuild para crear un nuevo archivo TFSBuild.proj.
Para buscar un archivo TFSBuild.proj existente, haga clic en Examinar. En el cuadro de diálogo Buscar carpeta, seleccione una definición de compilación existente en la carpeta TeamBuildTypes y, a continuación, haga clic en Aceptar.
El archivo TFSBuild.proj se comparte ahora entre la nueva definición de compilación y la existente.
Si se encuentra un archivo TFSBuild.proj, se muestra el texto Se encontró archivo de proyecto de MSBuild: TFSBuild.proj en el panel Archivo de proyecto. Si no se encuentra un archivo de proyecto, se muestra en el panel Archivo de proyecto un texto de advertencia y se aconseja crear un nuevo archivo de proyecto de MSBuild.
.gif "Nota importante")
Nota importante:Cualquier cambio que realice en un archivo TFSBuild.proj compartido se aplica a todas las definiciones de compilación a las que está asociado el archivo. Para obtener más información, vea Personalizar Team Foundation Build.
Para crear un nuevo archivo de proyecto para la definición de compilación, haga clic en Crear. Aparece el Asistente para crear archivos de proyecto de MSBuild.
En la página Seleccione y ordene las soluciones que desea generar, seleccione las soluciones que va a generar. Para ordenar las soluciones, seleccione una de ellas y utilice las teclas de flecha situadas a la derecha de la lista para cambiar su ubicación en el orden de compilación.
Precaución:Tenga en cuenta si una solución tiene dependencias respecto a otra cuando determine el orden en el que se generan. Por ejemplo, si la solución 2 depende de la solución 1, establezca la solución 1 de modo que se genere antes que la solución 2.
Haga clic en Siguiente.
Aparece la página Seleccione las configuraciones para generar.
En la cuadrícula situada debajo de ¿Qué configuraciones desea generar?, seleccione la configuración y las plataformas que desee incluir en las definiciones de compilación. La configuración de compilación indica la configuración y la plataforma (por ejemplo, Release y cualquier CPU).
Nota:Si va a crear una definición de compilación para proyectos web, seleccione Varias plataformas en el menú desplegable Plataforma.
Haga clic en Siguiente.
Aparece la página Seleccione las opciones de la compilación.
Indique las opciones de compilación que desea habilitar activando las casillas Ejecutar prueba (p. ej. ejecutar BVT, etc.) y Ejecutar análisis de código, según corresponda. Si activa la casilla Ejecutar prueba (p. ej. ejecutar BVT, etc.), puede utilizar las opciones desplegables para especificar Archivo de metadatos de prueba y Lista de pruebas para ejecutar, según corresponda.
Para obtener más información, vea Usar listas de pruebas y Escribir código de calidad.
Nota importante:Para ejecutar las pruebas, Team para Testers debe estar instalado en el agente de compilación. Para ejecutar el análisis de código, Team para Developers debe estar instalado en el agente de compilación.
Haga clic en Finalizar.
Aparece el panel Archivo de proyecto del cuadro de diálogo Definición de compilación. El archivo TFSBuild.proj que se crea se almacena debajo de $<Proyecto de equipo>\TeamBuild Types\Nombre de definición de compilación>\TFSBuild.proj en el control de código fuente.
Haga clic en la ficha Directiva de retención. En la lista Especifique cómo desea retener las compilaciones, puede seleccionar la directiva de retención para las compilaciones con error, detenidas, parcialmente correctas y totalmente correctas. Seleccione una directiva de retención de la lista desplegable. Si selecciona <Especifique el número que desea mantener>, aparece el cuadro de diálogo Número de compilaciones. En el cuadro de texto Especifique el número de compilaciones que deben retenerse, indique cuántas compilaciones deben mantenerse para el resultado de la compilación especificado.
Haga clic en la ficha Valores predeterminados de compilación. En el panel Valores predeterminados de compilación puede elegir un agente de compilación existente en la lista desplegable Agente de compilación. Si no existe ningún agente de compilación o desea crear uno nuevo, haga clic en Nuevo. Aparece el cuadro de diálogo Propiedades de agente de compilación. Rellene los cuadros de texto Nombre para mostrar, Descripción y Nombre del equipo, y haga clic en Aceptar. Para obtener más información, vea Cómo: Crear y administrar agentes de compilación.
En el cuadro de texto Las compilaciones se almacenarán en el siguiente recurso compartido (por ejemplo, \\servidor\recurso compartido), escriba la ubicación UNC (\\servidor\recurso compartido). Los archivos binarios generados y los archivos de registro se almacenarán en esta carpeta en cuanto finalice la compilación.
Nota:Antes de completar este paso, debe haber creado una carpeta pública en el equipo del agente de compilación en la que la cuenta TFSService tenga todos los permisos. Para obtener más información sobre las cuentas de servicio de Team Foundation, vea Cómo: Ver los servicios de Team Foundation Server.
Haga clic en la ficha Desencadenador.
En el panel Desencadenador, active Las protecciones no desencadenan una nueva compilación para generar una compilación solo cuando se solicite.
Active Generar cada protección (más compilaciones) para generar una compilación continuamente cada vez que se proteja un cambio en los archivos que va a generar la definición de compilación.
Active Acumular protecciones hasta que finalice la compilación anterior (menos compilaciones) para crear compilaciones acumuladas. Si activa la casilla Acumular protecciones hasta que finalice la compilación anterior (menos compilaciones), puede indicar la frecuencia de realización de compilaciones activando la casilla No generar compilaciones con una frecuencia superior a y escribiendo un número en el cuadro de texto minutos.
El intervalo válido para el cuadro de texto minutos es de 0 a 2147483647 (Int32 MaxValue).
Nota:Si está utilizando Visual Studio Team System 2008 Team Foundation Server con Service Pack 1, puede establecer el intervalo de compilaciones acumuladas entre 120 y 240 minutos. Si está utilizando Visual Studio Team System 2008 Team Foundation Server sin Service Pack 1, Team Foundation Build omite cualquier valor de ese intervalo.
Seleccione Generar compilación cada semana los días siguientes para crear compilaciones programadas. Seleccione los días en que desea generar la compilación mediante las casillas que se proporcionan para cada día de la semana. Escriba la hora de compilación en el cuadro de texto Poner la compilación en cola en el agente de compilación predeterminado en.
Nota:Las compilaciones programadas no tendrán lugar si no se ha protegido ningún cambio desde la compilación anterior.
Haga clic en Aceptar para crear la definición de compilación una vez especificada toda la información necesaria.
La definición de compilación creada se muestra en la carpeta Compilaciones de Team Explorer. Para revisar la información almacenada en el servidor de la definición de compilación, haga clic con el botón secundario del mouse en ella en Team Explorer y haga clic en Editar definición de compilación. Se muestra el cuadro de diálogo Definición de compilación con la información que ha especificado. También puede cambiar esa información. Para obtener más información, vea Cómo: Editar una definición de compilación.
Nota importante:Si la definición de compilación comparte un archivo TFSBuild.proj con otra compilación, la definición de compilación y los archivos asociados no se muestran en Explorador de control de código fuente en la carpeta TeamBuildTypes. Sólo se muestra la definición de compilación original.
Vea también
Tareas
Tutorial: Crear una definición de compilación en Team Foundation Build
Cómo: Establecer permisos para el agente de Team Foundation Build
Cómo: Configurar e instalar Team Foundation Build
Tutorial: Personalizar Team Foundation Build con una tarea personalizada
Conceptos
Información general sobre Team Foundation Build
Otros recursos
Trabajar con definiciones de compilación en Team Foundation Build