Visualización, guardado y configuración de archivos de registro de compilación

Después de compilar un proyecto en el entorno de desarrollo interactivo (IDE) de Visual Studio, puede ver información registrada sobre la compilación en la ventana Salida de Visual Studio. Los datos de salida se pueden guardar en los archivos de registro que puede ver en Visual Studio y en otros editores.

Los registros pueden ayudarle a solucionar problemas en la compilación. Puede encontrar las líneas de comandos exactas que se usan para todas las herramientas de compilación y obtener datos de diagnóstico completos sobre todo el proceso de compilación. Visual Studio proporciona opciones para especificar los tipos de información que desea ver en la salida de compilación y los archivos de registro de compilación.

En este artículo se describe cómo generar, configurar y ver archivos de registro de compilación en Visual Studio.

Generación y visualización de archivos de registro de compilación

Use los procedimientos siguientes para generar y ver los archivos de registro de compilación para su escenario.

• Proyecto de C++:

  Visual Studio guarda los archivos de registro para usted al compilar el proyecto. Entre las ubicaciones comunes de los archivos de registro se incluyen Release\<ProjectName>.log, Debug\<ProjectName>.log y <ProjectName>.txt. Todas las ubicaciones de archivo son relativas a la carpeta raíz del proyecto y se basan en la configuración específica.

  1. Use el Explorador de Windows o el Explorador de archivos para ir al archivo de registro.

  2. Abra el archivo de registro en el editor que prefiera.

• Proyecto de .NET:

  En el caso de los proyectos de .NET, indique a Visual Studio que guarde los archivos de registro:

  1. En Visual Studio, seleccione Compilar>solución de compilación.

  2. En la ventana Salida , seleccione en el texto y use el método abreviado de teclado Ctrl+S .

  Visual Studio le pide una ubicación para guardar la salida de compilación. Después, puede abrir los archivos de registro desde esa ubicación en Visual Studio u otro editor.

• MSBuild:

  Puede generar registros de compilación ejecutando MSBuild directamente desde la línea de comandos mediante la -fileLogger opción de línea de comandos (-fl). Para obtener más información, consulte Obtención de registros de compilación con MSBuild.

  Con MSBuild, también puede generar registros binarios (-binaryLogger o -bl opción de línea de comandos). Puede ver los registros binarios en el Visor de registros estructurados. El visor de registros estructurado proporciona una interfaz de usuario más completa que puede facilitar la comprensión de los procesos de compilación complejos.

Puede establecer variables de entorno para configurar Visual Studio para escribir un registro binario en el sistema de archivos. Establezca MSBuildDebugEngine en 1 y establezca MSBUILDDEBUGPATH en la ubicación deseada del archivo de registro de compilación. Las variables deben establecerse en el entorno en el que se inicia Visual Studio. Esta configuración afecta a todas las compilaciones de Visual Studio, por lo que es posible que no sea una buena opción si solo desea registros para una invocación determinada de la compilación.

Para obtener compatibilidad con la interfaz de usuario más avanzada para el registro de compilación en proyectos de .NET, considere la posibilidad de instalar la extensión Project System Tools. Con la extensión instalada, puede activar y desactivar el registro binario en la interfaz de usuario y elegir entre la lista de registros. Sin embargo, debido a la forma en que se integra con el sistema de compilación de Visual Studio, los registros son ligeramente diferentes de los que obtendría de la ventana Salida o con las variables de entorno.

Especificar la verbosidad de datos para los registros de compilación

Puede especificar la cantidad de información que se va a incluir en los archivos de registro de compilación. La cantidad de datos en las columnas del archivo de registro se mide como la verbosidad del registrador. El número de filas del archivo de registro representa los mensajes recopilados. La verbosidad del registro (valores de columna) influye en los tipos de mensajes registrados (valores de fila). Verbosidad silenciosa genera un registro mínimo en la salida de la compilación. El diagnóstico es la configuración más detallada y genera archivos de registro con todos los datos posibles.

En la tabla siguiente se muestran los tipos de mensajes que se recopilan en función del nivel de detalle del registrador:

Tipo de mensaje / Verbosidad	Tranquilo	Mínimo	Normal	Detallado	Diagnostic
Errors	✅	✅	✅	✅	✅
Warnings	✅	✅	✅	✅	✅
Mensajes de alta importancia		✅	✅	✅	✅
Mensajes de importancia normal			✅	✅	✅
Mensajes de importancia baja				✅	✅
Otra información del motor de MSBuild					✅

Puede configurar la verbosidad del registrador con los pasos siguientes:

1. Abra el panel Opciones de herramientas> y expanda la sección Todos losproyectos y soluciones> de configuración>Compilación y ejecución.

2. Utilice la lista desplegable de verbosidad de salida de compilación del proyecto de MSBuild y seleccione su preferencia de salida de compilación.

3. Use la lista desplegable de verbosidad del registro de compilación del proyecto de MSBuild y seleccione su preferencia de verbosidad del registrador.

   Sugerencia

   Si quiere ver las líneas de comandos usadas para el compilador y otras herramientas, elija al menos el nivel detallado.

Importante

Debe volver a generar el proyecto para que los cambios surtan efecto en la ventana Salida . En el caso de los proyectos de C++, la recompilación del proyecto también garantiza que los cambios se reflejen en el <archivo projectName>.txt .

Para obtener más información, vea Cuadro de diálogo Opciones, Proyectos y soluciones, Compilación y ejecución y LoggerVerbosity.

Uso de registros binarios para archivos de registro grandes

Los registros binarios son una característica opcional para los proyectos de .NET que le permiten tener una experiencia de exploración de registros más completa que podría facilitar la búsqueda de información en registros grandes. Para usar registros binarios, instale Project System Tools 2022. Para obtener más detalles, consulte https://msbuildlog.com y Registro binario.

Contenido relacionado

• Compilar y limpiar proyectos y soluciones en Visual Studio
• Compilar y construir
• Obtención de registros de compilación con MSBuild