Visualizzare, salvare e configurare file di log di compilazione

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.

  Con MSBuild è anche possibile generare log binari (-binaryLogger o -bl opzione della riga di comando). È possibile visualizzare i log binari nel Visualizzatore log strutturato. Il visualizzatore log strutturato offre un'interfaccia utente più completa che potrebbe semplificare la comprensione di processi di compilazione complessi.

È possibile impostare le variabili di ambiente per configurare Visual Studio per scrivere un log binario nel file system. Impostare MSBuildDebugEngine su 1 e impostare MSBUILDDEBUGPATH sul percorso desiderato del file di log di compilazione. Le variabili devono essere impostate nell'ambiente in cui viene avviato Visual Studio. Queste impostazioni influiscono su tutte le compilazioni di Visual Studio, quindi potrebbe non essere un'opzione valida se si desiderano solo i log per una particolare chiamata della compilazione.

Per un supporto dell'interfaccia utente più avanzato per la registrazione della compilazione nei progetti .NET, è consigliabile installare l'estensione Project System Tools. Con l'estensione installata, è possibile attivare e disattivare la registrazione binaria nell'interfaccia utente e scegliere tra l'elenco dei log. Tuttavia, a causa del modo in cui si integra con il sistema di compilazione di Visual Studio, i log sono leggermente diversi da quelli che si otterrebbero dalla finestra Output o con le variabili di ambiente.

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 Project System Tools 2022. Per altre informazioni, vedere https://msbuildlog.com e Log binario.

Contenuto correlato

• Compilazione e pulizia di progetti e soluzioni in Visual Studio
• Compilare
• Ottenere i log di compilazione con MSBuild