Accodare una compilazione

Dopo aver definito i processi di compilazione creando una o più definizioni di compilazione, è possibile iniziare ad usufruire dei vantaggi del sistema di compilazione.La maggior parte dei processi di compilazione sono definiti con triggerautomatico.Se nella definizione di compilazione è presente un trigger manuale o automatico, è possibile accodare manualmente una compilazione ogni volta che è necessario.

Attività comuni	Contenuto di supporto
Accodare una compilazione pubblica se si desidera compilare la versione più recente del codice sorgente nel server di controllo della versione. Per accodare una compilazione pubblica a un prompt dei comandi, utilizzare il comando TFSBuild start.	Compilazioni pubbliche Comando Start (Team Foundation Build)
Accodare una compilazione privata se si desidera compilare le modifiche inserite in uno shelveset.È possibile utilizzare una compilazione privata (denominata anche "compilazione degli utenti") per convalidare le modifiche al codice prima di eseguirne l'archiviazione. Per accodare una compilazione privata a un prompt dei comandi, utilizzare il comando TFSBuild start con l'opzione /shelveset.	Compilazioni private Comando Start (Team Foundation Build)
Ritenta una compilazione completata se si desidera accodare una compilazione pubblica o privata usando le stesse opzioni di una compilazione completata.	Ritenta una compilazione completata

Compilazioni pubbliche

Indipendentemente dall'avere specificato un trigger automatico in una definizione di compilazione, è possibile accodare manualmente la compilazione.

Autorizzazioni necessarie

Per eseguire questa routine, l'autorizzazione Compilazioni coda sia impostata su Consenti.Per ulteriori informazioni, vedere la classe Autorizzazioni per Team Foundation Server.

Per accodare una compilazione pubblica da Visual Studio

1. In Team Explorer:

   1. Se non si è già connessi al progetto team con cui si desidera lavorare, connettersi al progetto team.

   2. Seleziona Home, quindi seleziona Compilazioni.

   3. Nella pagina Compilazioni, in Definizioni di compilazione preferite o Tutte le definizioni di compilazione, aprire il menu di scelta rapida per una definizione di compilazione e quindi scegliere Accoda nuova compilazione.

   Verrà visualizzata la finestra di dialogo Accoda compilazioneNomeProgettoTeam.

2. Nell'elenco Definizione di compilazione, la definizione di compilazione è selezionata e la sua descrizione viene visualizzata sotto.Se si desidera accodare una definizione di compilazione diversa, è possibile selezionarne una dall'elenco.

3. Nell'elenco Specificare cosa compilare lasciare selezionata l'opzione Origini più recenti.

4. (Facoltativo) Nell'elenco Controller di compilazione selezionare un controller di compilazione diverso da quello predefinito.

5. (Facoltativo) Nell'elenco Priorità in coda selezionare uno dei valori seguenti: Alto, Superiore al normale, Normale, Inferiore al normale o Minimo.

   Nella casella Posizione viene visualizzata la posizione prevista della compilazione nella coda.

6. (Facoltativo) nella casella Cartella di ricezione per la compilazione viene visualizzata la posizione in cui gli output quali i binari e i file di log vengono archiviati quando la compilazione viene completata.Se si desidera che gli output vengano archiviati in una posizione differente, digitare il percorso alla posizione in questa casella.

   Importante
   Se si modifica questo valore, è necessario specificare una cartella preparata per l'utilizzo come cartella di ricezione.Non è possibile modificare questo valore se è stata specificata Copia dell'output di compilazione nel server come percorso di gestione temporanea per la definizione di compilazione. Vedere Impostare cartelle a sola scrittura.

7. (Facoltativo) Nella scheda Parametri visualizzare le altre impostazioni della definizione di compilazione ed eseguirne l'override solo per questa esecuzione.

   Se la definizione di compilazione è basata su Modello predefinito o su Aggiorna modello, vedere Definire un processo di compilazione basato sul modello predefinito o Utilizzare i processi di compilazione legacy per ulteriori informazioni su questi parametri.

8. Scegliere Accoda.

Compilazioni private

Si accoda una compilazione privata se si desidera compilare le modifiche inserite in uno shelveset.È possibile utilizzare una compilazione privata (denominata anche "compilazione degli utenti") per convalidare le modifiche al codice prima di eseguirne l'archiviazione.Eseguendo una compilazione privata delle modifiche prima di archiviarle, è possibile ridurre la probabilità che interrompano le eventuali compilazioni che il team esegue regolarmente, come quelle notturne.

Differenza tra le compilazioni private e quelle pubbliche

I risultati di una compilazione privata completata sono diversi da una compilazione pubblica completata nei modi indicati di seguito:

• Una compilazione privata è simile a una compilazione di archiviazione gestita in quanto si compila codice che include le modifiche in uno shelveset.Tuttavia, le modifiche non vengono archiviate automaticamente dopo una compilazione privata, come lo sono invece dopo una compilazione di archiviazione gestita.

• Si presuppone che i seguenti parametri del processo di compilazione siano FALSE e, di conseguenza. non producono alcun effetto, indipendentemente dall'impostazione specificata nella definizione di compilazione:

  • Origini etichette

  • Crea un elemento di lavoro in caso di errore

  • Associa set di modifiche ed elementi di lavoro

• In Build Explorer la compilazione completata viene visualizzata accanto all'icona seguente:

• La compilazione completata viene denominata utilizzando il formato BuildN in cui N è un valore Integer univoco.Questo formato differisce da quello delle compilazioni pubbliche, che viene specificato mediante il parametro Formato numero build.

• Per ogni definizione di compilazione, specificare criteri di conservazione separati (e facoltativamente diversi) per limitare il numero di compilazioni private completate archiviate nel sistema.

Accodare una compilazione privata

Autorizzazioni necessarie

Per eseguire questa routine, l'autorizzazione Compilazioni coda sia impostata su Consenti.Per ulteriori informazioni, vedere la classe Autorizzazioni per Team Foundation Server.

Per accodare una compilazione privata da Visual Studio

1. In Team Explorer:

   1. Se non si è già connessi al progetto team con cui si desidera lavorare, connettersi al progetto team.

   2. Seleziona Home, quindi seleziona Compilazioni.

   3. Nella pagina Compilazioni, in Definizioni di compilazione preferite o Tutte le definizioni di compilazione, aprire il menu di scelta rapida per una definizione di compilazione e quindi scegliere Accoda nuova compilazione.

   Verrà visualizzata la finestra di dialogo Accoda compilazioneNomeProgettoTeam.

2. Nell'elenco Definizione di compilazione, la definizione di compilazione è selezionata e la sua descrizione viene visualizzata sotto.Se si desidera accodare una definizione di compilazione diversa, è possibile selezionarne una dall'elenco.

3. Nell'elenco Specificare cosa compilare selezionare l'opzione Origini più recenti con shelveset.

   Verrà visualizzata la casella Nome shelveset.

4. Eseguire uno dei passaggi seguenti:

   • Se si dispone già di uno shelveset, digitarne il nome nella casella Nome shelveset, o selezionare il pulsante con i puntini di sospensione (…) per cercare lo shelveset.

   • Se si desidera inserire alcune modifiche in sospeso dall'area di lavoro in uno shelveset e quindi compilare tali modifiche, scegliere Crea.

5. (Facoltativo) Se si desidera archiviare le modifiche nello shelveset se la compilazione viene completata correttamente, selezionare la casella di controllo Archivia modifiche dopo completamento della compilazione.

   Importante
   Se si seleziona questa casella di controllo, la compilazione viene eseguita come compilazione di archiviazione gestita anziché come compilazione privata.Per ulteriori informazioni sulle compilazioni di archiviazione gestita, vedere Definire un processo di compilazione di archiviazione gestita per convalidare le modifiche.

6. (Facoltativo) Nell'elenco Controller di compilazione selezionare un controller di compilazione diverso da quello predefinito.

7. (Facoltativo) Nell'elenco Priorità in coda selezionare uno dei valori seguenti: Alto, Superiore al normale, Normale, Inferiore al normale o Minimo.

   Nella casella Posizione viene visualizzata la posizione prevista della compilazione nella coda.

8. (Facoltativo) seguire questi passaggi per specificare la cartella in cui gli output, come file binari, della compilazione verranno scaricati:

   [!NOTA]

   Ignorare la casella Cartella di ricezione per la compilazione in quanto non ha alcun effetto in una compilazione privata.

   1. Scegliere la scheda Parametri, quindi espandere il gruppo Avanzate.

   2. Nella casella Destinazione finale privata digitare il percorso UNC della cartella in cui si desidera archiviare gli output quando la compilazione viene completata.

      [!NOTA]

      • Se non si specifica questa cartella, la compilazione funzionerà ma nel log di compilazione verrà visualizzato un avviso.

      • Se si modifica questo valore, è necessario specificare una cartella preparata per l'utilizzo come cartella di ricezione.Per ulteriori informazioni, vedere Impostare cartelle a sola scrittura.

9. (Facoltativo) Nella scheda Parametri visualizzare le altre impostazioni della definizione di compilazione ed eseguirne l'override solo per questa esecuzione.

   Se la definizione di compilazione è basata su Modello predefinito o su Aggiorna modello, vedere Definire un processo di compilazione basato sul modello predefinito o Utilizzare i processi di compilazione legacy per ulteriori informazioni su questi parametri.

10. Scegliere Accoda.

Ritenta una compilazione completata

Quando si testano alcune potenziali modifiche a un processo di compilazione o si sperimentano le opzioni, è possibile accodare rapidamente una compilazione pubblica o privata utilizzando le stesse opzioni specificate quando è stata accodata la compilazione che ora è completata.

Per ritentare una compilazione completata dalla pagina Compilazioni

• In Team Explorer:

  1. Se non si è già connessi al progetto team con cui si desidera lavorare, connettersi al progetto team.

  2. Seleziona Home, quindi seleziona Compilazioni.

  3. Nella pagina Compilazioni, in Compilazioni, aprire il menu di scelta rapida per una compilazione completata, quindi scegliere Ritenta compilazione.