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

1. In Team Explorer fare clic sul progetto team nel quale si desidera definire la compilazione. 

2. Scegliere Nuova definizione di compilazione dal menu Compila.

3. In Nome definizione di compilazione digitare un nome.

4. Fare clic sulla scheda Processo.

   Per impostazione predefinita, in Nuovo modello di processo di compilazione è selezionato Modello predefinito.

5. 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.

6. Utilizzare le informazioni riportate più avanti in questo argomento per completare i campi che forniscono la funzionalità da inserire in questa definizione di compilazione.

7. 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

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++.

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.

    Suggerimento
    Facendo 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.

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: Selezionare Tutto per eliminare tutti gli output e i file di codice sorgente esistenti prima che venga elaborata la compilazione. Utilizzare questa opzione se si desidera che il processo di compilazione che sia il più completo possibile nell'esporre i problemi del processo di compilazione. Selezionare Output per eliminare tutti gli output esistenti, mantenendo tuttavia i file di codice sorgente che non sono stati modificati dalla più recente compilazione (eseguendo un comando tf get senza l'opzione /all). Selezionare Nessuno per lasciare invariati tutti gli output esistenti e mantenere i file di codice sorgente che non sono stati modificati dalla più recente compilazione (eseguendo un comando tf get senza l'opzione /all). 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: Selezionare Come configurato per analizzare ogni progetto di codice nel quale è abilitata questa funzionalità. Selezionare Sempre per analizzare ogni progetto di codice, indipendentemente dal fatto che questa funzionalità sia abilitata o meno nei progetti di codice. Selezionare Mai per ignorare l'analisi codice. Per ulteriori informazioni, vedere uno degli argomenti riportati di seguito: Procedura: abilitare e disabilitare l'analisi automatica del codice per C/C++ Procedura: configurare l'analisi codice per un progetto di codice gestito Procedura: configurare l'analisi del codice per un'applicazione Web ASP.NET Procedura: abilitare e disabilitare l'analisi statica del codice del database
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: Specificare Auto se si desidera eseguire MSBuild con lo stesso numero di bit della CPU del servizio Team Foundation Build installato nell'agente di compilazione. Specificare X86 per elaborare sempre questa compilazione utilizzando la versione a 32 bit di MSBuild. Poiché Visual Studio viene eseguito come un'applicazione a 32 bit, si possono verificare problemi quando la compilazione viene elaborata da un agente di compilazione che esegue la versione a 64 bit del servizio Team Foundation Build. Specificando X86, è possibile risolvere questi tipi di problemi. Specificare X64 per elaborare sempre questa compilazione utilizzando la versione a 64 bit di MSBuild. Nota Se si specifica questo valore, è necessario assicurarsi che la compilazione venga elaborata da un agente di compilazione ospitato da un computer di compilazione a 64 bit, utilizzando ad esempio un tag come spiegato precedentemente in questo argomento.In caso contrario, la compilazione non verrà completata.

Vedere anche

Attività

Creare una definizione di compilazione di base

Visualizzare la finestra Risultati compilazione