Visualizzare, salvare e configurare file di log di compilazione

  • Articolo

Dopo aver compilato un progetto nell'IDE (Interactive Development Environment) di Visual Studio, è possibile visualizzare le informazioni registrate sulla compilazione nella finestra Output di Visual Studio. I dati di output possono essere salvati in file di log che è possibile visualizzare in Visual Studio e in altri editor.

I log consentono di risolvere i problemi nella compilazione. È possibile individuare le righe di comando esatte usate per tutti gli strumenti di compilazione e ottenere dati di diagnostica completi sull'intero processo di compilazione. Visual Studio offre opzioni per specificare i tipi di informazioni da visualizzare nei file di log di compilazione e di compilazione.

Questo articolo descrive come generare, configurare e visualizzare i file di log di compilazione in Visual Studio.

Generare e visualizzare i file di log di compilazione

Usare le procedure seguenti per generare e visualizzare i file di log di compilazione per lo scenario in uso.

  • Progetto C++:

    Visual Studio salva automaticamente i file di log quando si compila il progetto. I percorsi comuni per i file di log includono Release\ProjectName>.log, Debug\<ProjectName.log e <ProjectName>>.txt.< Tutti i percorsi dei file sono relativi alla cartella radice del progetto e in base alla configurazione specifica.

    1. Usare Esplora risorse o Esplora file per passare al file di log.

    2. Aprire il file di log nell'editor preferito.

  • Progetto .NET:

    Per i progetti .NET, si indica a Visual Studio di salvare i file di log:

    1. In Visual Studio selezionare Compila soluzione di>compilazione.

    2. Nella finestra Output selezionare nel testo e usare la scelta rapida da tastiera CTRL+S.

    Visual Studio richiede di specificare il percorso in cui salvare l'output di compilazione. È quindi possibile aprire i file di log da tale percorso in Visual Studio o in un altro editor.

  • MSBuild:

    È possibile generare log di compilazione eseguendo MSBuild direttamente dalla riga di comando usando l'opzione della -fileLogger riga di comando (-fl). Per altre informazioni, vedere Ottenere i log di compilazione con MSBuild.

Specificare il livello di dettaglio dei dati per i log di compilazione

È possibile specificare la quantità di informazioni da includere nei file di log di compilazione. La quantità di dati nelle colonne del file di log viene misurata come dettaglio del logger. Il numero di righe del file di log rappresenta i messaggi raccolti. Il livello di dettaglio del log (valori di colonna) influisce sui tipi di messaggi registrati (valori di riga). La verbosità non interattiva produce una registrazione minima nell'output di compilazione. La diagnostica è l'impostazione più dettagliata e genera i file di log con tutti i dati possibili.

La tabella seguente illustra i tipi di messaggi raccolti in base al livello di dettaglio del logger:

Tipo di messaggio/Dettaglio Quiet Minima Normale Dettagliate Diagnostic
Errori ✅ ✅ ✅ ✅ ✅
Avvisi ✅ ✅ ✅ ✅ ✅
Messaggi di importanza elevata ✅ ✅ ✅ ✅
Messaggi di importanza normale ✅ ✅ ✅
Messaggi con priorità bassa ✅ ✅
Altre informazioni sul motore MSBuild ✅

È possibile configurare il livello di dettaglio del logger seguendo questa procedura:

  1. In Visual Studio selezionare Strumenti>Opzioni per aprire la finestra di dialogo Opzioni.

  2. Nella finestra di dialogo espandere la sezione Progetti e soluzioni e selezionare la scheda Compila ed esegui .

  3. Usare l'elenco a discesa dettaglio output compilazione progetto MSBuild e selezionare le preferenze di output di compilazione.

  4. Usare l'elenco a discesa verbosità del file di log di compilazione del progetto MSBuild e selezionare la preferenza di dettaglio del logger.

    Suggerimento

    Per visualizzare le righe di comando usate per il compilatore e altri strumenti, scegliere almeno il livello dettagliato.

  5. Per applicare le modifiche, selezionare OK.

Importante

È necessario ricompilare il progetto per rendere effettive le modifiche nella finestra Output . Per i progetti C++, la ricompilazione del progetto garantisce anche che le modifiche vengano riflesse nel <file ProjectName>.txt .

Per altre informazioni, vedere Finestra di dialogo Opzioni, Progetti e soluzioni, Compila ed esegui e LoggerVerbosity.

Usare i log binari per file di log di grandi dimensioni

I log binari sono una funzionalità facoltativa per i progetti .NET che consente di ottenere un'esperienza di ricerca dei log più completa, con la quale sarebbe possibile trovare facilmente informazioni nei log di grandi dimensioni. Per usare i log binari, installare gli strumenti dei sistemi di progetto. Per altre informazioni, vedere https://msbuildlog.com e Log binario.

I log binari sono una funzionalità facoltativa per i progetti .NET che consente di ottenere un'esperienza di ricerca dei log più completa, con la quale sarebbe possibile trovare facilmente informazioni nei log di grandi dimensioni. Per usare i log binari, installare Project System Tools 2022. Per altre informazioni, vedere https://msbuildlog.com e Log binario.

Contenuto correlato