Gestire le informazioni di compilazione e controllare il dettaglio

È possibile ottenere informazioni dettagliate su una compilazione completata:

• Come è stata eseguita la compilazione. Se la compilazione è stata eseguita correttamente.Quando è iniziata.Quanto tempo ha richiesto la compilazione.Come è stata eseguita questa compilazione rispetto a quelle precedenti.

• Quali elementi sono stati compilati. Quali soluzioni, insiemi di modifiche e correzioni di bug sono stati inseriti in questa compilazione.

• Quali problemi si sono verificati. Quali avvisi o errori sono stati generati.Quali test hanno avuto esito negativo.

È possibile controllare sistematicamente il livello di dettaglio delle informazioni archiviate per ogni compilazione completata quando si definisce il processo di compilazione.In alternativa, è possibile controllare il livello di dettaglio per una singola esecuzione di una compilazione quando viene accodata manualmente.

In questo argomento

• Generazione delle informazioni di compilazione e flussi

  • Definire il processo di compilazione

  • Il processo di compilazione viene accodato ed eseguito

  • Le informazioni di compilazione vengono generate, filtrate e archiviate

  • Recuperare le informazioni di compilazione

• Impostazione del parametro del processo di compilazione per registrare il livello di dettaglio

• Procedura consigliata: impostare il livello di dettaglio più basso possibile

  • Utilizzare un livello di dettaglio minimo quando si esegue una compilazione

  • Utilizzare un livello di dettaglio minimo quando si progetta un modello di processo di compilazione personalizzato

• Ulteriori informazioni

Generazione delle informazioni di compilazione e flussi

Definire il processo di compilazione

È possibile controllare sistematicamente il livello di dettaglio delle informazioni quando si sviluppa il processo di compilazione.Quando si crea o si modifica una definizione di compilazione basata sul modello predefinito o il modello di aggiornamento, si visualizza la scheda Processo.Nel nodo Base è possibile selezionare un valore nell'elenco di Registrazione del livello di compilazione per specificare il parametro del processo di compilazione.

Nei casi in cui i modelli incorporati non soddisfino le proprie esigenze, è possibile compilare un modello di processo di compilazione personalizzato.Quando si crea questo tipo di modello, è opportuno scrivere attentamente le informazioni di compilazione.Per ulteriori informazioni, vedere Utilizzare il livello di dettaglio minimo quando si progetta un modello di processo di compilazione personalizzato.

Il processo di compilazione viene accodato ed eseguito

È possibile eseguire manualmente l'override delle impostazioni della Registrazione del livello di compilazione quando si accoda una definizione di compilazione basata sul modello predefinito o il modello di aggiornamento.Nella finestra di dialogo Accoda compilazione, visualizzare la scheda Parametri espandere il nodo Base quindi selezionare un valore nell'elenco Registrazione del livello di compilazione per specificare il parametro del processo di compilazione.Questo valore viene applicato a una singola esecuzione della compilazione.

Le informazioni di compilazione vengono generate, filtrate e archiviate

Il sistema di compilazione passa il valore del parametro del processo di compilazione Livello di dettaglio a Verbosity.Questa proprietà viene utilizzata per filtrare le informazioni di compilazione registrate e archiviate in Team Foundation Server tramite Information dalle seguenti origini:

• Attività del flusso di lavoro: diverse attività di flusso di lavoro generano un messaggio quando un'operazione viene completata oppure un avviso o un errore quando un'operazione ha esito negativo.Ad esempio, l'attività SyncWorkspace genera messaggi con priorità bassa quando vengono scaricati codice sorgente e altri file dal server all'agente di compilazione.Questa attività genera errori quando il download dei file non viene eseguito.Un altro esempio è rappresentato dall'attività OpenWorkItem che genera un avviso quando non è possibile creare un elemento di lavoro.

  È possibile utilizzare altre attività del flusso di lavoro per scrivere direttamente le proprie informazioni di compilazione.Per ulteriori informazioni, vedere l'articolo relativo alla progettazione di un modello di processo di compilazione personalizzato che consente di scrivere le informazioni con il livello di dettaglio minimo.

• Compilare il codice: Il processo di compilazione utilizza la funzione MSBuild per l'utilizzo di MSBuild per compilare il codice binario ed eseguire altre attività fondamentali.La proprietà Livello di dettaglio di questa attività controlla il livello di dettaglio delle informazioni generate e pubblicate da questo processo nelle seguenti posizioni:

  • Il Team Foundation Server archivia i risultati, gli errori e gli avvisi di compilazione.

  • Un log nella cartella di ricezione archivia le stesse informazioni del Team Foundation Server con tutti gli altri messaggi che scrive MSBuild.

• Testare il codice: il processo di compilazione utilizza la funzione RunTests o MSTest per eseguire i test.Tutti i messaggi di log di queste attività viene classificata con un valore di priorità alto se il controller di compilazione su locali, o basso se si utilizza Controller di compilazione ospitato.

Recuperare le informazioni di compilazione

Mentre la compilazione è in esecuzione e dopo che è stata completata, è possibile recuperare le informazioni di riepilogo e dettagliate dalla finestra Risultati compilazione.È possibile copiare queste informazioni dalla finestra negli Appunti.È inoltre possibile collegare direttamente la cartella di ricezione per recuperare log, binari e altri dati.

Parametro del processo di compilazione Registrazione del livello di compilazione

In un processo di compilazione basato sul modello predefinito o il modello di aggiornamento, è possibile utilizzare il parametro del processo di compilazione Registrazione del livello di compilazione per controllare il livello di dettaglio delle informazioni registrate ed archiviate.

Nella tabella riportata di seguito sono elencati i valori del livello di dettaglio registrazione e gli effetti corrispondenti:

Valore	Errori	Avvisi	Messaggi di compilazione con priorità alta	Messaggi con priorità normale	Messaggi con priorità bassa	Proprietà attività di flusso di lavoro (input e output)
Minimal	S	N	N	N	N	N
Normal	S	S	S	N	N	N
Detailed	S	S	S	S	N	N
Diagnostica (Suggerimento: Nella maggior parte dei casi è possibile utilizzare i registri diagnostici.Vedere Diagnosticare i problemi di compilazione).	S	S	S	S	Controller di compilazione di Su locali: Y Controller di compilazione ospitato: N	S

Procedura consigliata: impostare il livello di dettaglio più basso possibile

Anche se le informazioni di compilazione sono importanti, un processo di compilazione che registra una quantità eccessiva di informazioni può causare problemi.Questi problemi possono includere utilizzare troppa memoria del Team Foundation Server, una riduzione delle prestazioni di Visual Studio e l'overload dei membri del team con più informazioni che possono gestire.

Utilizzare un livello di dettaglio minimo quando si esegue una compilazione

Quando si esegue una compilazione, è consigliabile seguire in genere la procedura consigliata di utilizzare l'impostazione di dettaglio più bassa, che fornisca comunque le informazioni necessarie per raggiungere l'obiettivo previsto.

Utilizzare un livello di dettaglio minimo quando si progetta un modello di processo di compilazione personalizzato

Gli utenti del processo di compilazione si basano sul filtro del livello di dettaglio per ridurre l'overload di informazioni.È possibile rendere più efficace questa operazione adottando le misure seguenti:

• Accertarsi di selezionare la funzione più appropriata per scrivere un messaggio: Attività WriteBuildMessage, Attività WriteBuildWarning, Attività WriteBuildError, o WriteBuildTestError.

• Quando si utilizza l'attività Attività WriteBuildMessage per registrare informazioni, applicare un approccio intenzionale e coerente all'impostazione della proprietà Importance.Quando si utilizza un valore di priorità più alto per il messaggio, tenere presente che si sta potenzialmente aumentando la quantità di dati archiviati e presentati ai membri del team.

[!NOTA]

L'impatto di tali decisioni può essere particolarmente significativo se si utilizzano queste attività all'interno di una struttura di ciclo, ad esempio DoWhile, ForEach<T> o While.

Ulteriori informazioni

Diagnosticare i problemi di compilazione viene descritto come ottenere i registri diagnostici.

In Attività di Team Foundation Build vengono descritte le attività del flusso di lavoro del processo di compilazione indicate in questo argomento.

Definire un processo di compilazione basato sul modello predefinito e Utilizzare i processi di compilazione legacy forniscono indicazioni su come creare e gestire le definizioni di compilazione basate sul modello predefinito e sul modello di aggiornamento

In Visualizzare i risultati di compilazione vengono fornite indicazioni sull'utilizzo della finestra Risultati compilazione.

In IBuildDetail, BuildMessageImportance e BuildVerbosity vengono descritti alcuni elementi principali dell'API di Team Foundation Build che forniscono la funzionalità per le informazioni di compilazione.

In Riferimenti alla riga di comando di MSBuild viene descritto MSBuild.

In Specificare trigger e motivi di compilazione e Accodare una compilazione viene descritto come accodare automaticamente e manualmente una compilazione.