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 la 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 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.
Use el Explorador de Windows o Explorador de archivos para ir al archivo de registro.
Abra el archivo de registro en su editor preferido.
Proyecto de .NET:
En el caso de los proyectos de .NET, indique a Visual Studio que guarde los archivos de registro:
En Visual Studio, seleccione Compilar>Compilar solución.
En la ventana Salida, seleccione en el texto y use el método abreviado de teclado Ctrl+S.
Visual Studio le preguntará en qué ubicación guardar la salida de la 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 mediante la ejecución directa de MSBuild desde la línea de comandos o con la opción de línea de comandos
-fileLogger(-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 (opción de línea de comandos
-binaryLoggero-bl). Puede ver los registros binarios en el Visor de registros estructurados. El visor de registros estructurados ofrece una interfaz de usuario más completa que permite conocer mejor los procesos de compilación complejos.
Puede crear variables de entorno para configurar Visual Studio con el fin de escribir un registro binario en el sistema de archivos. En MSBuildDebugEngine use el valor 1 y cree MSBUILDDEBUGPATH en la ubicación deseada del archivo de registro de compilación. Las variables deben crearse en el entorno en el que se inicie 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 crear registros para invocar algo determinado en la compilación.
Para acceder a más funciones avanzadas de la interfaz de usuario para crear registros de compilación en proyectos de .NET, tiene la opción 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 lo que necesite en la lista de registros. Sin embargo, por la forma en que se integra con el sistema de compilación de Visual Studio, los registros son un poco diferentes de los que vería en la ventana Salida o con las variables de entorno.
Especificación del nivel de detalle de los 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 de las columnas del archivo de registro se mide como detalle del registrador. El número de filas del archivo de registro representa los mensajes recopilados. El nivel de detalle del registro (valores de columna) afecta a los tipos de mensajes registrados (valores de fila). El detalle silencioso genera un registro mínimo en la salida de la compilación. 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/Nivel de detalle | Quiet | Minimal | Normal | Detallado | Diagnóstico |
|---|---|---|---|---|---|
| Errores | ✅ | ✅ | ✅ | ✅ | ✅ |
| Advertencias | ✅ | ✅ | ✅ | ✅ | ✅ |
| Mensajes con importancia alta | ✅ | ✅ | ✅ | ✅ | |
| Mensajes con importancia normal | ✅ | ✅ | ✅ | ||
| Mensajes con importancia baja | ✅ | ✅ | |||
| Otra información del motor de MSBuild | ✅ |
Puede configurar el nivel de detalle del registrador con los pasos siguientes:
En Visual Studio, seleccione Herramientas>Opciones para abrir el cuadro de diálogo Opciones.
En el cuadro de diálogo, expanda la sección Proyectos y soluciones y seleccione la pestaña Compilar y ejecutar.
Use la lista desplegable Detalle de salida de compilación de proyecto de MSBuild y seleccione la preferencia de salida de compilación.
Use la lista desplegable Detalles de archivo de registro de compilación del proyecto de MSBuild y seleccione la preferencia de detalle del registrador.
Sugerencia
Si quiere ver las líneas de comandos usadas para el compilador y otras herramientas, elija al menos el nivel de detalle Detallado.
Para aplicar los cambios, seleccione Aceptar.
Importante
Debe volver a compilar 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, Compilar y ejecutar y LoggerVerbosity.
Uso de registros binarios para archivos de registro grandes
Los registros binarios son una característica opcional de los proyectos .NET que permite tener una experiencia de exploración de registros más completa que puede facilitar la búsqueda de información en registros de gran tamaño. Para usar registros binarios, instale Project System Tools. Para obtener más información, vea https://msbuildlog.com y Registro binario.
Los registros binarios son una característica opcional de los proyectos .NET que permite tener una experiencia de exploración de registros más completa que puede facilitar la búsqueda de información en registros de gran tamaño. Para usar registros binarios, instale Project System Tools 2022. Para obtener más información, vea https://msbuildlog.com y Registro binario.