Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Se recomienda usar Visual Studio 2017

Diagnosticar problemas de la compilación

El diagnóstico y la corrección de problemas de compilación son tareas frecuentes en el desarrollo de software. Team Foundation Build dispone de herramientas que le ayudarán a depurar y a resolver problemas tales como:

  • Compilaciones con error o parcialmente correctas

  • Excepciones, errores o advertencias

  • Eventos o resultados inesperados

¿Qué desea hacer?

Permisos necesarios

Debe ser miembro del grupo Administradores de Windows en el servidor de compilación y del grupo Administradores de compilación de la colección de proyectos en la colección de proyectos de equipo. Vea Referencia de permisos para Team Foundation Server.

Si la compilación es la siguiente de la cola, pero aún no se está ejecutando, asegúrese de que el controlador de compilación y al menos uno de sus agentes de compilación esté disponible y habilitado. Si el proceso de compilación tiene filtros de agente de compilación, asegúrese de que esté disponible y habilitado un agente de compilación que cumpla los criterios. Vea Administrar el sistema de compilación, Especificar los agentes de compilación que procesan la compilación y Implementar y configurar los agentes de compilación.

Si la compilación se está ejecutando, está bloqueada en una parte del proceso o se ha completado, puede obtener más información sobre los problemas en la ventana de resultados de la compilación. Elija Ver registro para mostrar información más detallada:

  • Para pasar directamente a los problemas de la compilación, elija Error siguiente o Advertencia siguiente.

  • Siempre que vea instancias de un vínculo Archivo de registro de MSBuild, elíjalo para obtener información más detallada acerca de los eventos que se produjeron cuando la actividad MSBuild compiló el código y llevó a cabo otras tareas.

  • Puede copiar la información y, si lo desea, compartirla con personas que puedan ayudarle a resolver los problemas. Seleccione fragmentos concretos en el registro o abra un menú contextual desde cualquier parte del registro y elija Seleccionar todo. Puede abrir un menú contextual y elegir Copiar para copiar el texto en el Portapapeles.

Si aún no tiene información suficiente para diagnosticar el problema, puede ver registros de diagnóstico más detallados. En la ventana de resultados de la compilación, elija Diagnósticosy, a continuación:

  • Si la compilación está completada, elija Registros finales a partir de date and time.

  • Si la compilación no se ha completado aún, elija Solicitar registros.

    Recuperar registro de diagnóstico

    El sistema ensambla los registros.

    Cuando los registros estén listos, elija Diagnósticos, A partir de date and time para User who requested the log.

Si la compilación organiza los resultados en una carpeta de entrega en una ruta de acceso UNC, el sistema abre una subcarpeta de dicha carpeta que contiene los registros de diagnóstico. Después de abrir la carpeta de entrega o descargar el archivo .zip, verá uno de los registros siguientes:

  • Desde el controlador de compilación: ActivityLog

  • Desde cada agente de compilación que ha participado en la compilación: ActivityLog.AgentScope.Build_Agent_ID

  • Para cada solución compilada por la actividad MSBuild: Solution_Name

La mejor manera de ver estos registros es copiándolos en el equipo de desarrollado y abriéndolos desde allí.

Nota Nota

Si utiliza Visual Studio 2010, el menú Diagnósticos no se muestra en la ventana de resultados de compilación, pero podrá ver los registros de diagnóstico en la carpeta de entrega cuando finalice la compilación.

Algunos problemas pueden tener su origen en el sistema de compilación local.

Sugerencia Sugerencia

Intente implementar el equipo de desarrollo como servidor de compilación para poder obtener acceso directo con mayor facilidad al entorno en el que se está ejecutando el proceso de compilación. Vea Implementar y configurar un servidor de compilación.

Asegúrese de que el servidor, el controlador y el agente de compilación estén configurados correctamente. Vea Implementar y configurar un servidor de compilación, Implementar y configurar un controlador de compilación y Implementar y configurar los agentes de compilación.

Inicie sesión en el servidor de compilación y confirme que funciona correctamente. También puede ver datos de diagnóstico detallados en el servidor de compilación. Vea Administrar el sistema de compilación.

Para diagnosticar problemas ocasionados por las actividades del proceso de compilación personalizado, o por excepciones no detectadas, intente depurar el proceso de compilación en el servidor de compilación.

  1. Inicie sesión en el servidor de compilación.

  2. Ejecute Visual Studio como administrador.

  3. En Visual Studio, en la barra de menús, elija Herramientas, Asociar al proceso.

  4. En el cuadro de diálogo Asociar al proceso:

    1. Seleccione Mostrar los procesos de todos los usuarios.

    2. Seleccione TFSBuildServiceHost.exe.

    3. Elija Asociar.

  5. En la barra de menús, elija Depurar, Excepciones. En el cuadro de diálogo Excepciones, seleccione Excepciones de Common Language Runtime. Elija Aceptar.

  6. En la barra de menús, elija Herramientas, Opciones. En el cuadro de diálogo Opciones, en el panel de árbol, seleccione Depuración. En la lista General, desactive la casilla Habilitar Solo mi código. Elija Aceptar.

  7. En Visual Studio, ponga la compilación en cola y asegúrese de que se ejecute en un controlador de compilación y un servidor de compilación que estén hospedados en el servidor de compilación en el que ha habilitado el depurador.

Ahora puede depurar excepciones producidas durante el proceso de compilación y también establecer puntos de interrupción y depurar las actividades de proceso de compilación personalizadas. Vea Depurar en Visual Studio.

  • Sugerencia Mientras diagnostica problemas con el proceso de compilación, se evitará problemas, tanto a usted como a sus compañeros de equipo, si lo detiene hasta que pueda reparar el proceso:

  • Sugerencia Si cree que uno de los componentes del sistema de compilación podría ser la causa de uno de los problemas, puede iniciar, detener o reiniciar un servidor de compilación, o bien habilitar o deshabilitar un controlador o un agente según sea necesario. Vea Administrar el sistema de compilación.

  • Sugerencia Con frecuencia, al intentar corregir problemas de los procesos de compilación, es necesario poner en cola una compilación con las mismas opciones de forma repetida para probar varias correcciones. Puede reintentar rápidamente una compilación:

  • Sugerencia ¿Va a usar el controlador de compilación hospedado? Vea Usar el controlador de compilación hospedado.

Adiciones de comunidad

Mostrar: