Procedura: creare una definizione di compilazione
Aggiornamento: novembre 2007
In Team Foundation Build le definizioni di compilazione vengono utilizzate per configurare le condizioni in base alle quali viene compilata una singola soluzione o un insieme di soluzioni in un progetto team. Per eseguire una compilazione, è necessario creare una nuova definizione di compilazione o utilizzarne una esistente.
Quando si creano definizioni di compilazione utilizzando la finestra di dialogo Definizione di compilazione, è possibile impostare diverse opzioni. Tali opzioni includono il nome di compilazione, l'area di lavoro del controllo del codice sorgente per i file da compilare e il percorso del file di progetto TFSBuild.proj, l'agente di compilazione, i criteri di conservazione delle compilazioni e il trigger di compilazione. Se non esiste alcun file di progetto MSBuild, è possibile utilizzare la finestra di dialogo Definizione di compilazione per avviare la Creazione guidata file progetto MSBuild e creare un nuovo file TFSBuild.proj per la definizione di compilazione. È inoltre possibile aprire la finestra di dialogo Proprietà agente di compilazione per creare un nuovo agente di compilazione.
Dopo avere creato una nuova definizione di compilazione, è possibile modificare tali opzioni. Per ulteriori informazioni, vedere Procedura: modificare una definizione di compilazione.
È possibile personalizzare ulteriormente le definizioni di compilazione modificando il file TFSBuild.proj scritto in formato MSBuild. Per ulteriori informazioni, vedere Personalizzazione di Team Foundation Build.
La rimozione delle definizioni di compilazione implica in primo luogo l'eliminazione delle compilazioni associate alla definizione di compilazione. È quindi possibile eliminare la definizione di compilazione stessa. Per ulteriori informazioni, vedere Procedura: eliminare una definizione di compilazione.
Autorizzazioni necessarie
Per eseguire questa procedura, è necessario disporre dell'autorizzazione Amministra compilazione impostata su Consenti. Inoltre, l'account del servizio di livello applicazione e l'account del servizio di Team Foundation Build devono disporre di autorizzazioni di lettura/scrittura per la destinazione finale della compilazione. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
Per creare una definizione di compilazione
In Team Explorer selezionare il progetto per il quale si desidera creare una nuova definizione di compilazione.
Scegliere Nuova definizione di compilazione dal menu Compila.
Verrà visualizzata la finestra di dialogo Definizione di compilazione con l’elementoGenerale selezionato.
.gif "Suggerimento:")
Suggerimento:Le schede che presentano un'icona di avviso richiedono input da parte dell'utente.
Specificare il nome da associare alla definizione di compilazione nella casella di testo Nome definizione di compilazione.
È necessario immettere un nome univoco e conforme alle regole di Windows per la composizione di nomi di file validi.
Aggiungere una descrizione appropriata nella casella di testo Descrizione.
Tale descrizione viene visualizzata nella finestra di dialogo Accoda compilazione" <nome progetto team>". Per ulteriori informazioni, vedere Procedura: accodare o avviare una definizione di compilazione.
Fare clic sulla scheda Area di lavoro.
Per impostazione predefinita, nella tabella Cartelle di lavoro è inclusa la cartella del controllo del codice sorgente del progetto team per il quale si stanno creando le nuove definizioni di compilazione e una cartella locale nell'agente di compilazione. La cartella locale nell'agente di compilazione viene elencata nella colonna Cartella locale. Tutti i percorsi dell'area di lavoro nell'agente di compilazione sono mappati in relazione alla directory radice predefinita mostrata.
Per copiare un'area di lavoro esistente nell'elenco delle cartelle di lavoro, fare clic sul pulsante Copia area di lavoro esistente per aprire la finestra di dialogo Seleziona area di lavoro.
L'area di lavoro selezionata diventa un elemento figlio della directory radice comune nell'agente di compilazione.
È inoltre possibile fare clic su una cella vuota della tabella in Cartella del controllo del codice sorgente, quindi sui puntini di sospensione (…) per selezionare una cartella del controllo del codice sorgente da aggiungere come cartella di lavoro. Anche la cartella del controllo del codice sorgente selezionata viene normalizzata alla directory radice comune nell'agente di compilazione.
Fare clic sulla scheda File di progetto. Nel riquadro File di progetto è possibile selezionare un file di progetto TFSBuild.proj esistente o avviare la Creazione guidata file progetto MSBuild per creare un nuovo file TFSBuild.proj.
Per selezionare un file TFSBuild.proj esistente, fare clic su Sfoglia. Nella finestra di dialogo Sfoglia per cartelle selezionare una definizione di compilazione esistente dalla cartella TeamBuildTypes, quindi fare clic su OK.
Il file TFSBuild.proj è adesso condiviso tra la definizione di compilazione esistente e quella nuova.
Se un file TFSBuild.proj viene trovato, il testo File progetto MSBuild trovato: TFSBuild.proj viene visualizzato nel riquadro File di progetto. Se un file di progetto non viene trovato, nel riquadro File di progetto viene visualizzato un messaggio di avviso con il suggerimento di creare un nuovo file di progetto MSBuild.
.gif "Nota importante")
Nota importante:Qualsiasi modifica apportata a un file TFSBuild.proj condiviso comporta la personalizzazione di tutte le definizioni di compilazione alle quali il file è associato. Per ulteriori informazioni, vedere Personalizzazione di Team Foundation Build.
Per creare un nuovo file di progetto per la definizione di compilazione, fare clic su Crea. Verrà visualizzata la Creazione guidata file progetto MSBuild.
Nella pagina Selezionare e ordinare soluzioni da compilare, selezionare le soluzioni da compilare. Per ordinare le soluzioni, selezionarle una alla volta e utilizzare i tasti di direzione a destra dell'elenco per modificarne la posizione nell'ordine di compilazione.
Attenzione:Prestare attenzione alle dipendenze tra le soluzioni quando si specifica l'ordine di compilazione. Ad esempio, se Soluzione 2 ha una dipendenza da Soluzione 1, impostare Soluzione 1 in modo che venga compilata prima di Soluzione 2.
Scegliere Avanti.
Verrà visualizzata la pagina Selezionare configurazioni da compilare.
Nella griglia Specificare le configurazioni da compilare, selezionare la configurazione desiderata e le piattaforme da includere nelle definizioni di compilazione. La configurazione della build indica il tipo di configurazione e la piattaforma, ad esempio per il rilascio ed Any CPU.
Nota:Se si sta creando una definizione di compilazione per progetti Web, selezionare Piattaforme miste dal menu a discesa Piattaforma.
Scegliere Avanti.
Verrà visualizzata la pagina Selezionare opzioni di compilazione.
Specificare le opzioni di compilazione che si desidera attivare selezionando le relative caselle di controllo Esegui test (ad esempio, BVT e così via) ed Esegui analisi del codice. Se la casella di controllo Esegui test (ad esempio, BVT e così via) viene selezionata, utilizzare la casella di riepilogo a discesa per specificare File di metadati di test ed Elenco di test da eseguire in base alle esigenze.
Per ulteriori informazioni, vedere Utilizzo di elenchi di test e Scrittura di codice di qualità.
Nota importante:Per eseguire i test è necessario che Team Edition for Testers sia installato nell'agente di compilazione. Per eseguire l'analisi del codice è necessario che Team Edition for Developers sia installato nell'agente di compilazione.
Scegliere Fine.
Verrà visualizzato il riquadro File di progetto della finestra di dialogo Definizione di compilazione. Il file TFSBuild.proj che è stato creato viene archiviato in $<Team Project>\TeamBuild Types\<Nome definizione di compilazione>\TFSBuild.proj nel controllo del codice sorgente.
Fare clic sulla scheda Criteri di conservazione. Dall'elenco Specificare come devono essere gestite le compilazioni è possibile selezionare i criteri di conservazione per le compilazioni non riuscite, interrotte, parzialmente completate e interamente completate. Selezionare un criterio di conservazione dall'elenco a discesa. Se si seleziona <Specificare il numero da mantenere> viene visualizzata la finestra di dialogo Numero delle compilazioni. Nella casella di testo Specificare il numero delle compilazioni da conservare, indicare quante compilazioni conservare per il risultato di compilazione specificato.
Fare clic sulla scheda Impostazioni predefinite compilazione. Nel riquadro Impostazioni predefinite compilazione è possibile selezionare un agente di compilazione esistente dall'elenco a discesa Agente di compilazione. Se non esiste nessun agente di compilazione o se si desidera crearne un nuovo, fare clic su Nuovo. Verrà visualizzata la finestra di dialogo Proprietà agente di compilazione. Compilare le caselle di testo Nome visualizzato, Descrizione e Nome computer e fare clic su OK. Per ulteriori informazioni, vedere Procedura: creare e gestire agenti di compilazione.
Nella casella di testo Le compilazioni verranno inserite nella seguente condivisione (ad esempio, \\server\condivisione), digitare il percorso UNC (\\server\condivisione). I binari compilati ed i file di log saranno disponibili in questa cartella una volta terminata la compilazione.
Nota:Prima di completare questo passaggio, è necessario avere creato una cartella pubblica sul computer dell'agente di compilazione dove l'account TFSService ha diritti completi. Per ulteriori informazioni sugli account del servizio di Team Foundation, vedere Procedura: visualizzare i servizi di Team Foundation Server.
Fare clic sulla scheda Trigger.
Nel riquadro Trigger, selezionare Nessuna nuova compilazione attivata dalle archiviazioni per compilare solo su richiesta.
Selezionare Compila ogni archiviazione (più compilazioni) per compilare continuamente ogni volta che una modifica viene archiviata nei file compilati dalla definizione di compilazione corrente.
Selezionare Accumula archiviazioni fino al termine della compilazione precedente (meno compilazioni) per creare compilazioni sequenziali. Se viene selezionata la casella di controllo Accumula archiviazioni fino al termine della compilazione precedente (meno compilazioni), è possibile indicare con quale frequenza si desidera compilare selezionando la casella di controllo Frequenza di compilazione non superiore a e immettendo un numero nella casella di testo minuti.
L'intervallo valido per la casella di testo minuti è compreso tra 0 e 2147483647 (Int32 MaxValue).
Nota:Se si utilizza Visual Studio Team System 2008 Team Foundation Server con Service Pack 1 è possibile impostare l'intervallo di compilazione sequenziale su un valore compreso tra 120 e 240 minuti. Se si utilizza Visual Studio Team System 2008 Team Foundation Server senza Service Pack 1, Team Foundation Build ignora qualsiasi valore contenuto in tale intervallo.
Selezionare Compila ogni settimana nei seguenti giorni per creare compilazioni programmate. Utilizzare le caselle di controllo disponibili per ogni giorno della settimana per selezionare i giorni in corrispondenza dei quali si desidera eseguire la compilazione. Immettere l'ora di compilazione nella casella di testo Inserisci la compilazione in coda nell'agente di compilazione predefinito alle.
Nota:Le compilazioni pianificate non verranno eseguite se non sono state archiviate modifiche dalla compilazione precedente.
Dopo aver inserito tutte le informazioni necessarie, fare clic su OK per creare la definizione di compilazione.
La definizione di compilazione creata viene visualizzata nella cartella Compilazioni in Team Explorer. Per rivedere le informazioni archiviate sul server per la definizione di compilazione, fare clic col pulsante destro del mouse in Team Explorer, quindi scegliere Modifica definizione di compilazione. Verrà visualizzata la finestra di dialogo Definizione di compilazione con le informazioni inserite precedentemente. È anche possibile modificare le informazioni inserite. Per ulteriori informazioni, vedere Procedura: modificare una definizione di compilazione.
Nota importante:Se la definizione di compilazione condivide il file TFSBuild.proj con un'altra compilazione, la definizione di compilazione e i file associati non verranno visualizzati in Esplora controllo codice sorgente nella cartella TeamBuildTypes. Solo la definizione di compilazione originale verrà elencata.
Vedere anche
Attività
Procedura dettagliata: creazione di una definizione di compilazione in Team Foundation Build
Procedura: stabilire le autorizzazioni per l'agente di Team Foundation Build
Procedura: configurare e installare Team Foundation Build
Procedura dettagliata: personalizzazione di Team Foundation Build con un'attività personalizzata
Concetti
Cenni preliminari su Team Foundation Build
Altre risorse
Utilizzo delle definizioni di compilazione in Team Foundation Build