Definire una compilazione utilizzando il modello predefinito
È possibile utilizzare il modello predefinito per definire rapidamente una compilazione di base selezionando i progetti di codice che si desidera compilare. È inoltre possibile utilizzare questo modello per includere funzionalità più avanzate, ad esempio l'esecuzione di test automatizzati, e modificare diversi aspetti del processo di compilazione per soddisfare le esigenze del team.
Autorizzazioni necessarie
Per eseguire questa procedura, è necessario che l'autorizzazione Modifica definizione di compilazione sia impostata su Consenti. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
Per creare una definizione di compilazione utilizzando il modello predefinito
In Team Explorer fare clic sul progetto team nel quale si desidera definire la compilazione.
Scegliere Nuova definizione di compilazione dal menu Compila.
In Nome definizione di compilazione digitare un nome.
Fare clic sulla scheda Processo.
Per impostazione predefinita, in Nuovo modello di processo di compilazione è selezionato Modello predefinito.
In Parametri processo di compilazione espandere il nodo Obbligatorio e specificare almeno una soluzione o un progetto da compilare.
Per ulteriori informazioni, vedere Specificare i progetti che si desidera compilare più avanti in questo argomento.
Utilizzare le informazioni riportate più avanti in questo argomento per completare i campi che forniscono la funzionalità da inserire in questa definizione di compilazione.
Dopo avere completato i campi nella scheda Processo, completare i campi nelle schede Trigger, Area di lavoro, Impostazioni predefinite compilazione e Criteri di conservazione.
Per ulteriori informazioni, vedere Specificare trigger e motivi di compilazione, Utilizzare aree di lavoro di compilazione e Creare una definizione di compilazione di base.
In questo argomento
Informazioni sui parametri del processo di compilazione per il modello predefinito
Specificare i progetti che si desidera compilare
Specificare le piattaforme e le configurazioni che si desidera compilare
Specificare quali agenti di compilazione elaborano la compilazione
Specificare i limiti di tempo dell'agente di compilazione
Eseguire test automatizzati e abilitare l'analisi dell'impatto sui test
Specificare i parametri base del processo di compilazione
Specificare i parametri avanzati del processo di compilazione
Informazioni sui parametri del processo di compilazione per il modello predefinito
In questo argomento viene illustrato come definire una compilazione utilizzando i parametri del processo di compilazione nelle compilazioni basate sul modello predefinito. Le informazioni contenute in questo argomento descrivono le funzionalità che dovrebbero corrispondere in Visual Studio Application Lifecycle Management (ALM) se le condizioni seguenti sono vere:
Si collabora a un progetto team creato da uno dei due modelli di processo inclusi in ALM di Visual Studio: MSF for Agile Software Development v5.0 o MSF for CMMI Process Improvement v5.0.
Nessun membro del team ha rimosso o personalizzato il modello predefinito.
Specificare i progetti che si desidera compilare
Nella casella Progetti da compilare è possibile specificare una o più soluzioni o progetti da compilare. (Per visualizzare questa casella, espandere il nodo Obbligatorio, quindi espandere il nodo relativo agli elementi da compilare). È necessario specificare almeno una soluzione o un progetto.
Se si compilano diversi progetti correlati, è solitamente necessario aggiungerli a un'unica soluzione e specificare tale soluzione nella casella Progetti da compilare anziché elencare ogni progetto separatamente.
Nella casella Progetti da compilare è possibile fare clic sul pulsante con i puntini di sospensione (...) per aprire e utilizzare la finestra di dialogo Soluzioni/Progetti per specificare le soluzioni o i progetti da compilare.
Per compilare manualmente la casella Progetti da compilare, specificare il percorso completo del controllo della versione per ogni progetto o soluzione che si desidera compilare. Delimitate ogni valore con una virgola, come illustrato nell'esempio seguente:
$/Features/FeatureA/Server/All Server Projects.sln, $/Features/FeatureA/Client/All Client Projects.sln
.gif "Nota importante") Importante |
|---|
Assicurarsi che il percorso di ogni progetto o soluzione sia un elemento figlio di uno dei valori di Cartella del controllo del codice sorgente elencati nella scheda Area di lavoro della definizione di compilazione. |
Specificare le piattaforme e le configurazioni che si desidera compilare
Nella casella Configurazioni da compilare è possibile specificare quali piattaforme e configurazioni si desidera compilare. (Per visualizzare questa casella, espandere il nodo Obbligatorio, quindi espandere il nodo relativo aglielementi da compilare). Ad esempio, includendo Versione|x86 in questa casella è possibile specificare che per questa compilazione dovrà essere compilata solo la configurazione per il rilascio della versione a 32 bit del progetto C++.
.gif "Suggerimento") Suggerimento |
|---|
Se si dispone di una codebase di grandi dimensioni, è possibile aumentare significativamente la velocità di elaborazione della compilazione compilando solo le configurazioni e le piattaforme necessarie. |
Se si lascia vuota la casella Configurazioni da compilare, verranno compilate la configurazione predefinita e la piattaforma definita in ogni soluzione o progetto.
Nella casella Elementi da compilare è possibile fare clic sul pulsante con i puntini di sospensione (...) per aprire e utilizzare la finestra di dialogo Configurazioni per specificare gli elementi da compilare. È inoltre possibile specificare tali elementi manualmente.
Ogni configurazione nella casella Configurazioni da compilare deve essere espressa nel seguente formato:
Configurazione|Piattaforma
È necessario sostituire i seguenti segnaposto:
Configurazione è un valore quale Debug, Release o Tutte le configurazioni.
Piattaforma è un valore quale Win32, x86, x64 o Qualsiasi CPU.
Nell'elenco le configurazioni devono essere delimitate da virgole.
Ad esempio, se si desidera compilare entrambe le configurazioni Debug e Release del progetto C#, nella casella Configurazioni da compilare specificare Debug|Qualsiasi CPU, Release|Qualsiasi CPU.
I token utilizzati per la configurazione e la piattaforma devono corrispondere ai token impostati nelle proprietà della soluzione o nelle proprietà del progetto di codice. Se non corrispondono, è possibile che al completamento della compilazione si verifichino risultati imprevisti.
Specificare quali agenti di compilazione elaborano la compilazione
Per specificare quali agenti di compilazione vengono utilizzati per elaborare la compilazione, espandere il nodo Avanzate, espandere il nodo Impostazioni agente, quindi specificare i valori per i seguenti parametri:
Filtro nomi: è possibile filtrare gli agenti di compilazione utilizzati per elaborare questa definizione di compilazione digitando il nome dell'agente in questo campo. È inoltre possibile specificare un set di nomi tramite i caratteri jolly * e ? . Ad esempio, è possibile specificare CI * per indicare qualsiasi agente il cui nome inizia con i caratteri CI. Gli agenti che possono corrispondere a questi criteri includono CI, CI1 o CI_Agente2.
Filtro tag: specificare uno o più tag per assicurarsi che solo gli agenti di compilazione con tag corrispondenti eseguiranno questa compilazione. In genere si applicano i tag a determinati agenti di compilazione per riservarli per scopi speciali. Ad esempio, viene impostato un agente di compilazione su un computer di compilazione progettato per elaborare le compilazioni di archiviazione gestita. Viene applicato il tag gestito a questo agente di compilazione. Infine viene applicato il tag gestito alla definizione di compilazione in modo che venga elaborata solo dall'agente anch'esso contrassegnato con il tag gestito. Per specificare tag, fare clic sul pulsante con i puntini di sospensione (...).
Nota
Il pool di agenti di compilazione disponibili per l'elaborazione di questa compilazione è determinato dal controller di compilazione specificato per questa definizione di compilazione. Per modificare il controller di compilazione, fare clic sulla scheda Impostazioni predefinite compilazione, quindi scegliere un controller di compilazione dal menu Controller di compilazione.
Operatore di confronto tag: dal menu scegliere uno dei seguenti valori:
MatchExactly: fare clic su questo valore se si desidera che questa definizione di compilazione venga elaborata solo dagli agenti di compilazione che hanno esattamente lo stesso set di tag specificato nella casella Filtro tag. Se non si specifica alcun tag, la definizione di compilazione potrà essere elaborata da qualsiasi agente.
SuggerimentoFacendo clic su MatchExactly, si limitano gli agenti disponibili per questa definizione di compilazione solo a quelli che dispongono esattamente dello stesso set di tag specificato nel campo Filtro tag.
MatchAtLeast: fare clic su questo valore se si desidera che questa definizione di compilazione venga elaborata da qualsiasi agente che abbia almeno lo stesso set di tag specificato nella casella Filtro tag. Se non si specifica alcun tag, la definizione di compilazione potrà essere elaborata solo da agenti privi di tag.
Specificare i limiti di tempo dell'agente di compilazione
Per specificare limiti di tempo, espandere il nodo Avanzate, espandere il nodo Impostazioni agente, quindi specificare i parametri riportati nella tabella seguente.
Per... |
Impostare il parametro… |
Seguendo queste istruzioni… |
|---|---|---|
Specificare il tempo massimo consentito all'agente di compilazione per elaborare la compilazione |
Tempo massimo di esecuzione |
Digitare un valore per l'intervallo di tempo nel formato hh:mm:ss. Ad esempio, la compilazione non verrà completata e restituirà un errore di timeout se si specifica il valore 04.30.15 e l'agente di compilazione non ha completato il lavoro dopo 4 ore, 30 minuti e 15 secondi. Specificare il valore 00.00.00 se si desidera assegnare all'agente di compilazione un tempo illimitato per elaborare la compilazione. |
Specificare il tempo massimo consentito per assegnare la richiesta di compilazione a un agente di compilazione |
Tempo massimo di attesa |
Digitare un valore per l'intervallo di tempo nel formato hh:mm:ss. Ad esempio, la compilazione non verrà completata e restituirà un errore di timeout se si specifica il valore 01.30.45 e la compilazione non è stata assegnata a un agente di compilazione dopo 1 ora, 30 minuti e 45 secondi. Specificare il valore 00.00.00 se si desidera assegnare al controller di compilazione un tempo illimitato per trovare un agente di compilazione per elaborare la definizione di compilazione. |
Eseguire test automatizzati e abilitare l'analisi dell'impatto sui test
È possibile progettare la compilazione affinché esegua una o più esecuzioni dei test automatizzati e analizzi l'impatto delle modifiche al codice nei test. Per ulteriori informazioni, vedere Utilizzare il sistema di compilazione per eseguire test.
Specificare i parametri base del processo di compilazione
Spesso è necessario modificare i parametri del processo di compilazione nel nodo Base per completare correttamente alcuni degli scenari più comuni.
Per... |
Impostare il parametro… |
Seguendo queste istruzioni… |
|---|---|---|
Personalizzare la convenzione utilizzata per assegnare un nome alle compilazioni completate |
Formato numero build |
È possibile caricare dati utili nel nome di ogni compilazione completata. Per ulteriori informazioni, vedere Utilizzare numeri di compilazione. Per personalizzare questo parametro, è possibile digitare il testo direttamente in questo campo. È tuttavia possibile modificare più facilmente il valore e visualizzare i token disponibili facendo clic sul pulsante con i puntini di sospensione (...) per aprire e utilizzare la finestra di dialogo Editor formato BuildNumber. In questa finestra di dialogo fare clic su Macro per visualizzare e inserire i token che si desidera utilizzare. |
Specificare se e come pulire l'area di lavoro dell'agente di compilazione prima che elabori la compilazione |
Pulizia ambiente di lavoro |
Da questo menu scegliere uno dei seguenti valori:
Suggerimento
Se il processo di compilazione non richiede la pulizia aggiuntiva eseguita dall'opzione Tutto, è possibile ridurre notevolmente il tempo necessario per eseguire la compilazione specificando Nessuno (l'opzione più veloce) oppure Output.
|
Specificare il livello di dettaglio desiderato per il log di compilazione |
Livello di dettaglio registrazione |
Anche se le informazioni di compilazione sono importanti per il team, un processo di compilazione che registra una quantità eccessiva di informazioni può causare problemi. Tali problemi possono includere l'esaurimento dello spazio di archiviazione e delle risorse della CPU del server, rallentare le prestazioni del server e limitare l'esperienza utente nella finestra Risultati compilazione sul computer client. È possibile controllare la quantità di informazioni che devono essere elaborate, archiviate e visualizzate dalle istanze di Team Foundation Server. Per ulteriori informazioni, vedere Gestire le informazioni di compilazione e controllare il dettaglio. |
Analizzare il codice per trovare difetti comuni |
Esegui analisi codice |
Da questo menu scegliere uno dei seguenti valori:
Per ulteriori informazioni, vedere uno degli argomenti riportati di seguito:
|
Archiviare i simboli per abilitare funzionalità come il debug cronologico |
Indicizza origini e Percorso per pubblicare i simboli |
È possibile configurare la definizione di compilazione affinché pubblichi i dati dei simboli per abilitare funzionalità quale il debug cronologico. Per ulteriori informazioni, vedere Pubblicare dati dei simboli. |
Specificare i parametri avanzati del processo di compilazione
Nel nodo Avanzate sono presenti i parametri del processo di compilazione che è necessario modificare per completare correttamente alcuni degli scenari più comuni.
Per... |
Impostare il parametro… |
Seguendo queste istruzioni… |
|---|---|---|
Convalidare il codice in base ai diagrammi livello |
Argomenti MSBuild |
Includere la stringa seguente nel valore di questo parametro: /p:ValidateArchitecture=true. Per ulteriori informazioni, vedere Procedura: convalidare il codice .NET in base ai diagrammi livello. |
Specificare gli argomenti della riga di comando da passare a MSBuild. |
Argomenti MSBuild |
Se il processo di compilazione richiede il passaggio di argomenti a MSBuild, digitarli nel parametro Argomenti MSBuild. Per ulteriori informazioni, vedere Riferimenti alla riga di comando di MSBuild. |
Collegare ogni compilazione completata a tutti i set di modifiche inseriti nel codice, così come gli elementi di lavoro associati |
Associa set di modifiche ed elementi di lavoro |
Nella maggior parte dei casi la procedura consigliata consiste nell'impostare questo parametro su Vero (il valore predefinito). Ciò vale specialmente per le compilazioni pianificate (ad esempio una compilazione notturna), perché spesso si utilizzano compilazioni pianificate correttamente completate per verificare correzioni o eseguire test aggiuntivi. Ogni definizione di compilazione gestisce un record dei set di modifiche e degli elementi di lavoro in attesa di essere associati alla successiva compilazione completata. Ad esempio, il set di modifiche 382 viene compilato sia da Compilazione A che da Compilazione B. La Compilazione A viene accodata e completata correttamente. La Compilazione B viene accodata ma non viene completata. Il set di modifiche 382 è ora collegato alla compilazione correttamente completata di Compilazione A e alla compilazione non completata di Compilazione B. Il set di modifiche 382 non sarà collegato alla successiva compilazione completata di Compilazione A, ma lo sarà alla successiva compilazione completata di Compilazione B. |
Copiare nella cartella di ricezione i file eseguibili e gli altri file binari risultanti dalla compilazione dei progetti |
Copia output nella cartella di ricezione |
Impostare questo parametro su Vero per copiare i file eseguibili e gli altri file binari risultanti dalla compilazione dei progetti in tale cartella di ricezione. Nota
La cartella di ricezione viene specificata nella scheda Impostazioni predefinite compilazione.
|
Creare un elemento di lavoro quando la compilazione non riesce |
Crea un elemento di lavoro in caso di errore |
Impostare questo parametro su Vero se si desidera che il sistema crei un elemento di lavoro quando la compilazione non riesce. |
Compilare una versione specifica del codice sorgente |
Leggi versione |
Specificare l'elemento versionspec che identifica la versione che si desidera compilare. Per ulteriori informazioni su versionspec, vedere Sintassi della riga di comando (controllo della versione). |
Etichettare la versione di ciascuno dei file compilati in ogni compilazione completata |
Origini etichette |
Impostare questo parametro su Vero se si desidera che il sistema contrassegni ogni file di codice sorgente con un'etichetta. Questa azione consente al team di identificare facilmente quale versione di ogni file è inclusa nella compilazione completata. |
Specificare il numero di bit della versione MSBuild utilizzati per elaborare la compilazione |
Piattaforma MSBuild |
Specificare uno dei seguenti valori:
|