Administrar información sobre las compilaciones y controlar el nivel de detalle

Puede obtener la información siguiente sobre una compilación completada:

• ¿Cómo se ejecutó la compilación? ¿Fue correcta? ¿Cuándo comenzó? ¿Cuánto tiempo tardó en completarse? ¿Cuál fue el resultado en comparación con otras anteriores?

• ¿Qué se compiló? ¿Qué soluciones, conjuntos de cambios y correcciones de errores entraron en esta compilación?

• ¿Qué salió mal? ¿Qué advertencias o errores se produjeron? ¿Qué pruebas dieron errores?

Puede controlar sistemáticamente el nivel de detalle de la información almacenada en cada compilación completada cuando defina el proceso de compilación. Como alternativa, puede controlar esta detalle para una única ejecución de una compilación cuando la pone en cola manualmente.

En este tema

• Cómo se genera la información de compilación y los flujos

  • Definir el proceso de compilación

  • El proceso de compilación se pone en la cola y se ejecuta

  • Se muestra, filtra y se almacena la información de compilación

  • Recuperar información de compilación

• Establecer el parámetro del proceso de compilación para registrar el nivel de detalle

• Procedimiento recomendado: establecer el nivel de detalle tan bajo como sea posible

  • Emplear un nivel de detalle mínimo al ejecutar una compilación

  • Emplear un nivel de detalle mínimo al diseñar una plantilla personalizada del proceso de compilación

• Para obtener más información

Cómo se genera la información de compilación y los flujos

Definir el proceso de compilación

Puede controlar sistemáticamente el detalle de información cuando desarrolla el proceso de compilación. Cuando crea o modifica una definición de compilación que se basa en DefaultTemplate.xaml o UpgradeTemplate.xaml, muestre la pestaña Proceso. En el nodo Basic, puede seleccionar un valor en la lista de Nivel de detalle de registro para especificar este parámetro del proceso de compilación.

En los casos en que las plantillas integradas no resuelven sus necesidades, puede desarrollar una plantilla personalizada. Al crear este tipo de plantilla, debe escribir cuidadosamente la información de compilación. Para obtener más información, vea Administrar el nivel de detalle en las plantillas de proceso de compilación personalizadas.

El proceso de compilación se pone en la cola y se ejecuta

Puede invalidar manualmente el Nivel de detalle de registro que se establece cuando se pone en cola una definición de compilación basada en DefaultTemplate.xaml o UpgradeTemplate.xaml. En el cuadro de diálogo Poner compilación en cola, muestre la pestaña Parámetros, expanda el nodo Basic y, a continuación, seleccione un valor de la lista Nivel de detalle de registro para especificar este parámetro del proceso de compilación. Este valor se aplica a una única ejecución de la compilación.

Se muestra, filtra y se almacena la información de compilación

El sistema de generación pasa el valor del parámetro del proceso de compilación de Nivel de detalle a Verbosity. Esta propiedad se utiliza para filtrar la información de compilación que se registra y se almacena en el almacén de datos a través de Information de los siguientes orígenes:

• Actividades de flujo de trabajo: varias actividades de flujo de trabajo generan un mensaje si la operación se realiza correctamente, y una advertencia o un error si una operación da error. Por ejemplo, la actividad SyncWorkspace genera mensajes de importancia baja cuando descarga el código fuente y otros archivos del servidor al agente de compilación. Esta actividad genera errores cuando no puede descargar los archivos. Otro ejemplo, la actividad OpenWorkItem genera una advertencia cuando no se puede crear un elemento de trabajo.

  Puede utilizar otras actividades de flujo de trabajo para escribir directamente su propia información de compilación. Para obtener más información, vea Diseñar una plantilla personalizada de proceso de compilación que escriba información con el mínimo nivel de detalle necesario.

• MSBuild : el proceso de compilación utiliza la actividad MSBuild para aprovechar MSBuild para compilar los binarios y realizar otras tareas fundamentales. La propiedad Nivel de detalle de esta actividad controla el nivel de detalle de la información que este proceso genera y publica en las siguientes ubicaciones:

  • El almacén de datos almacena los resultados, los errores y las advertencias de compilación.

  • Un registro en la carpeta de entrega almacena la misma información que el almacén de datos junto con el resto de los mensajes que se muestran en MSBuild.

• MSTest: el proceso de compilación utiliza la actividad MSTest para aprovechar MSTest.exe para ejecutar pruebas. Todos los mensajes que este proceso genera se ordenan con un valor de importancia alta y se publican en el almacén de datos y en un registro en la carpeta de entrega.

Recuperar información de compilación

A medida que la compilación se está ejecutando y una vez completada, puede recuperar la información de resumen y de detalle en la ventana de resultados de compilación. Puede copiar esta información de la ventana en el portapapeles. También puede vincular directamente con la carpeta de entrega y recuperar los registros, los binarios y otros datos.

Parámetro del proceso de compilación de nivel de detalle del registro

En un proceso de compilación basado en DefaultTemplate.xaml o UpgradeTemplate.xaml, puede utilizar el parámetro del proceso de compilación Nivel de detalle de registro para administrar el nivel de detalle de la información que se ha registrado y almacenado.

En la tabla siguiente se enumeran los valores de Nivel de detalle de registro y sus efectos correspondientes:

Valor	Errores	Advertencias	Mensajes de compilación de importancia alta	Mensaje de importancia normal	Mensaje de importancia baja	Propiedades de actividades de flujo de trabajo (entradas y salidas)
Minimal	Y	N	N	N	N	N
Normal	Y	Y	Y	N	N	N
Detailed	Y	Y	Y	Y	N	N
Diagnóstico (solo debe utilizarse para depurar un proceso de compilación)	Y	Y	Y	Y	Y	Y

Procedimiento recomendado: establecer el nivel de detalle tan bajo como sea posible

Aunque la información de la compilación sea importante, un proceso de compilación que registra demasiada información puede producir problemas. Estos problemas pueden incluir el consumo excesivo de espacio en el almacén de datos, la disminución del rendimiento de Visual Studio y la sobrecarga de los componentes del equipo con más información de la que pueden controlar.

Emplear un nivel de detalle mínimo al ejecutar una compilación

Cuando se ejecuta una compilación, se debe seguir normalmente el procedimiento recomendado de utilizar la configuración de la información de nivel de detalle más baja que se necesita para lograr el objetivo.

Por ejemplo, podría ejecutar una compilación de los binarios que incluyen los cambios más recientes llevado a cabo en el código. En la mayoría de los casos, un nivel de detalle Normal será suficiente. Sin embargo, tal vez sea necesario usar el nivel Detallado o Diagnóstico si está solucionando un error del proceso de compilación o un error poco habitual de la compilación del código.

Emplear un nivel de detalle mínimo al diseñar una plantilla personalizada del proceso de compilación

Los usuarios de su proceso de compilación dependen del filtrado de nivel de detalle para reducir la sobrecarga de información. Este filtrado es más eficaz si se siguen estos pasos:

• Asegúrese de seleccionar la actividad más adecuada para escribir un mensaje: Actividad WriteBuildMessage, Actividad WriteBuildWarning o Actividad WriteBuildError.

• Cuando se utiliza la actividad Actividad WriteBuildMessage para registrar información, aplique un enfoque intencionado y coherente para establecer la propiedad Importancia. Cuando utiliza un valor más alto de la importancia del mensaje, tenga en cuenta que está aumentando potencialmente la cantidad de datos que se almacenan y se muestran a los miembros del equipo.

Nota

El impacto de estas decisiones puede ser importante si usa estas actividades dentro de una estructura de bucle como DoWhile, ForEach<T> o While.

Para obtener más información

Actividades de Team Foundation Build describe las actividades de flujo de trabajo del proceso de compilación que se mencionan en este tema.

Definir una compilación con la plantilla predeterminada y Definir una compilación con la plantilla de actualización proporcionan orientación para crear una definición de compilación.

Ver la ventana de resultados de la compilación proporciona directrices sobre cómo utilizar la ventana de resultados de compilación.

IBuildDetail, BuildMessageImportance y BuildVerbosity describen algunos elementos clave de la API de Team Foundation Build que proporcionan funcionalidad de información de compilación.

Referencia de la línea de comandos de MSBuild describe MSBuild.

Especificar desencadenadores y razones de compilación y Poner en cola una compilación describen cómo poner en cola automática y manualmente una compilación.

Historial de cambios

Fecha	Historial	Motivo
1 de abril de 2011	Se ha agregado un tema.	Mejora de la información.