Condividi tramite

Informazioni sui file di configurazione di Team Foundation Build

  • Articolo

In questo argomento vengono illustrati i file di configurazione utilizzati dal modello di aggiornamento. Per ulteriori informazioni sul modello di aggiornamento, vedere Definire una compilazione utilizzando il modello di aggiornamento. Le funzionalità utilizzate per produrre questi file, ad esempio MSBuild Project File Creation Wizard, sono disponibili solo in Visual Studio Team System 2008.

Per l'elaborazione della compilazione di un modello di aggiornamento Team Foundation Build utilizza il motore di MSBuild. Il processo è controllato da un set di file XML che corrispondono allo schema del file di progetto MSBuild. Gli elementi di questi file XML indicati di seguito sono importanti per il processo di compilazione.

  • Elemento Target   L'elemento Target definisce la modalità di compilazione del progetto. Gli elementi Target contengono un set di attività che MSBuild esegue in sequenza. Per ulteriori informazioni sulle destinazioni, vedere Destinazioni di MSBuild.

  • Elemento Task   L'elemento Task specifica il codice che viene eseguito durante il processo di compilazione. Per ulteriori informazioni sulle attività, vedere Attività di MSBuild.

    MSBuild include una raccolta di attività comuni che è possibile utilizzare per personalizzare il processo di compilazione. Per ulteriori informazioni, vedere Riferimenti delle attività MSBuild.

  • Elemento UsingTask   L'elemento UsingTask specifica l'assembly che contiene le attività utilizzate nel processo di compilazione.

Tramite i file di script di MSBuild è possibile importare altri file di script. Ad esempio, è possibile definire una configurazione comune in un file e quindi includerla in altre configurazioni. Per ulteriori informazioni, vedere Procedura: utilizzare la stessa destinazione in più file di progetto.

Tre file controllano il processo di Team Foundation Build:

  • Microsoft.TeamFoundation.Build.targets

    Questo file definisce l'insieme di attività e destinazioni predefinite incluse con Team Foundation Build. Ad esempio, Clean, DropBuild, e Compile. Ogni Target contiene le attività da chiamare per lo specifico elemento Target. Alcuni Target contenuti in questo file dipendono da altri elementi Target per formare una catena di Target da eseguire in un ordine particolare. Ad esempio, la destinazione Compile dipende dalla destinazione BeforeCompile in modo che tutte le attività definite in quest'ultima vengono eseguite prima di Compile. Non tutti i Target definiti in questo file vengono necessariamente eseguiti in ogni compilazione. Ad esempio, per le compilazioni su desktop non viene eseguito il Target Clean.

    Microsoft.TeamFoundation.Build.targets è incluso in Visual Studio Application Lifecycle Management e si trova nella directory <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild\. Su un computer esiste una sola copia di questo file, condivisa da tutte le compilazioni eseguite su tale macchina.

    Nota importanteImportante

    Non modificare il file Microsoft.TeamFoundation.Build.targets. La modifica di questo file influirà su tutte le definizioni di compilazione. Per personalizzare le definizioni di compilazione è necessario modificare il file TfsBuild.proj ad esse associato.

  • TfsBuild.proj

    Si tratta del file di configurazione principale per Team Foundation Build. Esso può essere associato ad una o più definizioni di compilazione. Questo file contiene i parametri di configurazione che vengono forniti nella Creazione guidata file progetto MSBuild. Questi includono il progetto team, il tipo di elemento di lavoro creato in caso di interruzione della compilazione, la configurazione e le soluzioni da compilare. Questo file viene creato dalla Creazione guidata file progetto MSBuild quando si crea un file di progetto per una nuova definizione di compilazione. Per ulteriori informazioni, vedere Creare una definizione di compilazione di base. Questo file importa Microsoft.TeamFoundation.Build.targets e viene passato a MSBuild. Qualsiasi modifica viene apportata a questo file, influisce sulle compilazioni di tutte le definizioni di compilazione ad esso associate. Questo file viene archiviato per impostazione predefinita nel controllo del codice sorgente sotto la cartella $\Progetto\TeamBuildTypes\DefinizioneCompilazione dove Progetto è il nome del progetto team mentre DefinizioneCompilazione è il nome della definizione di compilazione. È inoltre possibile archiviare questo file in un percorso diverso specificandolo nella finestra di dialogo Definizione di compilazione.

    Il file TfsBuild.proj include, sotto forma di testo del commento, esempi sul suo utilizzo. Questi esempi comprendono le istruzioni per chiamare le destinazioni personalizzate nell'elemento SolutionToBuild e per passare le proprietà personalizzate ad altri elementi.

  • TfsBuild.rsp

    Si tratta di un file vuoto generato dalla Creazione guidata nuovo tipo di compilazione Team Foundation. Questo file può essere utilizzato per specificare un logger personalizzato o sostituire le proprietà di MSBuild. Per ulteriori informazioni, vedere la classe File di risposta MSBuild.

Destinazioni, proprietà e attività

Nei seguenti argomenti vengono fornite informazioni su proprietà, attività e destinazioni predefinite definite in Microsoft.TeamFoundation.Build.targets.

  • Destinazioni personalizzabili di Team Foundation Build
    Elenca le destinazioni definite in Microsoft.TeamFoundation.Build.targets di cui è possibile eseguire l’override scrivendo attività personalizzate. In questo argomento vengono forniti alcuni esempi che illustrano come personalizzare il processo di compilazione.

  • Proprietà personalizzabili di Team Foundation Build
    Vengono elencate le proprietà predefinite specificate all’interno di Microsoft.TeamFoundation.Build.targets che è possibile sostituire nel file TfsBuild.proj. In questo argomento vengono inoltre forniti alcuni esempi.

  • Attività di Team Foundation Build
    Elenca le attività predefinite specificate in Microsoft.TeamFoundation.Build.targets che è possibile modificare nel file TfsBuild.proj per personalizzare le definizioni di compilazione. In questo argomento vengono inoltre forniti alcuni esempi.