Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese
We recommend using Visual Studio 2017

Diagnosticare i problemi nella build

La diagnostica e la correzione dei problemi di compilazione sono attività normali nello sviluppo del software. In Team Foundation Build sono inclusi strumenti che consentono di eseguire il debug e di risolvere problemi quali:

  • Compilazioni riuscite o parzialmente riuscite

  • Eccezioni, errori o avvisi

  • Eventi o risultati imprevisti

Scegliere l'argomento con cui si desidera procedere

Autorizzazioni necessarie

È necessario essere un membro del gruppo Administrators di Windows nel server di compilazione e un membro del gruppo Project Collection Build Administrators nella raccolta del progetto team. Vedere Riferimento alle autorizzazioni per Team Foundation Server.

Se la compilazione è quella successiva nella coda, ma non è ancora in esecuzione, assicurarsi che il controller di compilazione e almeno uno dei relativi agenti di compilazione siano disponibili e abilitati. Se il processo di compilazione utilizza filtri dell'agente di compilazione, assicurarsi che un agente di compilazione che soddisfi i criteri sia disponibile e abilitato. Vedere Gestire il sistema di compilazione, Specificare quali agenti di compilazione elaborano la compilazione e Distribuire e configurare agenti di compilazione.

Se la compilazione è in esecuzione, bloccata in alcune parti del processo o completata, è possibile ottenere ulteriori informazioni sui problemi nella finestra dei risultati della compilazione. Scegliere Visualizza log per visualizzare informazioni più dettagliate:

  • Per passare direttamente ai problemi nella compilazione, scegliere Errore successivo o Avviso successivo.

  • Selezionare qualsiasi istanza del collegamento File di log di MSBuild per visualizzare informazioni più dettagliate sugli eventi che si sono verificati quando l'attività MSBuild ha compilato il codice ed eseguito altre attività.

  • È possibile copiare le informazioni e, se lo si desidera, condividerle con le persone che aiutano a risolvere i problemi. Selezionare passaggi specifici nel log o aprire un menu di scelta rapida da qualsiasi punto del log e scegliere Seleziona tutto. È quindi possibile aprire un menu di scelta rapida e scegliere Copia per copiare il testo negli Appunti.

Se non si dispone ancora di informazioni sufficienti per identificare il problema, è possibile visualizzare log di diagnostica più dettagliati. Nella finestra dei risultati della compilazione scegliere Diagnostica, quindi:

  • Se la compilazione viene completata, scegliere Log finali al date and time.

  • Se la compilazione non è ancora stata completata, scegliere Richiedi log.

    Recupero del registro di diagnostica

    Il sistema assembla i log.

    Quando i log sono pronti, scegliere Diagnostica, Al date and time per User who requested the log.

Se dalle fasi di compilazione si ottiene una cartella di ricezione di un percorso UNC, viene visualizzata una sottocartella della cartella di ricezione contenente i log di diagnostica. Dopo avere aperto la cartella di ricezione o scaricato il file con estensione zip, è possibile visualizzare uno dei seguenti registri:

  • Dal controller di compilazione: ActivityLog

  • Da ogni agente di compilazione che ha partecipato alla compilazione: ActivityLog.AgentScope.Build_Agent_ID

  • Per ogni soluzione compilata dall'attività MSBuild: Solution_Name

Il modo migliore per visualizzare i log è copiarli e aprirli nel computer di sviluppo.

Nota Nota

Se si utilizza Visual Studio 2010, il menu Diagnostica non viene visualizzato nella finestra dei risultati della compilazione, ma è comunque possibile visualizzare i log di diagnostica nella cartella di ricezione quando la compilazione viene completata.

Alcuni problemi possono essere causati dal sistema di compilazione locale.

Suggerimento Suggerimento

Provare a distribuire il computer di sviluppo come server di compilazione in modo che sia più semplice ottenere l'accesso diretto all'ambiente in cui il processo di compilazione è in esecuzione. Vedere Distribuire e configurare un server di compilazione.

Assicurarsi che il server di compilazione, il controller e l'agente siano configurati correttamente. Vedere Distribuire e configurare un server di compilazione, Distribuire e configurare un controller di compilazione e Distribuire e configurare agenti di compilazione.

Accedere al server di compilazione e verificare che funzioni correttamente. È anche possibile visualizzare i dati di diagnostica dettagliata sul server di compilazione. Vedere Gestire il sistema di compilazione.

Per diagnosticare problemi causati dalle attività del processo di compilazione personalizzato o per le eccezioni non intercettate, provare a eseguire il debug del processo di compilazione nel server di compilazione.

  1. Accedere al server di compilazione.

  2. Eseguire Visual Studio come amministratore.

  3. Dalla barra dei menu di Visual Studio scegliere Strumenti, Connetti a processo.

  4. Nella finestra di dialogo Connetti a processo:

    1. Scegliere Mostra i processi di tutti gli utenti.

    2. Selezionare TFSBuildServiceHost.exe.

    3. Scegliere Connetti.

  5. Dalla barra dei menu scegliere Debug, Eccezioni. Nella finestra di dialogo Eccezioni selezionare Eccezioni Common Language Runtime. Scegliere OK.

  6. Dalla barra dei menu scegliere Strumenti, Opzioni. Nella finestra di dialogo Opzioni selezionare Debug nel riquadro dell'albero. Nell'elenco Generaledeselezionare la casella di controllo Abilita Just My Code. Scegliere OK.

  7. In Visual Studio accodare la compilazione e verificare che venga eseguita in un controller di compilazione e in un server di compilazione ospitati nel server di compilazione in cui è stato abilitato il debugger.

È ora possibile eseguire il debug di eccezioni generate durante il processo di compilazione nonché impostare i punti di interruzione ed eseguire il debug delle attività di processo di compilazione personalizzate. Vedere Debug in Visual Studio.

  • Suggerimento Durante la diagnosi dei problemi relativi a un processo di compilazione, è possibile salvare l'utente e i problemi dei colleghi del team mettendolo in pausa finché non è possibile ripristinare il processo:

  • Suggerimento Se si ritiene che uno dei componenti del sistema di compilazione possa essere la causa di uno dei problemi, è possibile avviare, arrestare o riavviare un server di compilazione oppure disabilitare o abilitare un controller o un agente in base alle esigenze. Vedere Gestire il sistema di compilazione.

  • Suggerimento Spesso, mentre si tenta di risolvere i problemi di compilazione, è necessario accodare una compilazione con le stesse opzioni ripetutamente per testare le varie correzioni. È possibile ritentare rapidamente una compilazione:

  • Suggerimento Se viene utilizzato il controller di compilazione ospitato, vedere Utilizzare il controller di compilazione ospitato.

Aggiunte alla community

Mostra: