Informazioni sui file di configurazione di Team Foundation Build

Aggiornamento: novembre 2007

Team Foundation Build utilizza il motore di MSBuild. L'intero processo di Team Foundation Build è controllato da un insieme 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 insieme 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.

Due 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 destinazioneBeforeCompile in modo che tutte le attività definite in quest'ultimo 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 Team System 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 importante:
  Do not modify Microsoft.TeamFoundation.Build.targets. If this file is modified, each build definition is affected. 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 nuovo file di progetto per una nuova definizione di compilazione. Per ulteriori informazioni, vedere la classe Procedura: creare una definizione di compilazione. 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, è memorizzato per impostazione predefinita nel controllo del codice sorgente sotto la cartella $\MyProject\TeamBuildTypes\BuildDefinition  dove MyProject è il nome del progetto mentre BuildDefinition è il nome della definizione di compilazione. È 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.

Anche i seguenti file sono importanti:

• TfsBuildService.exe.config

  È possibile utilizzare il file TfsBuildService.exe.config per configurare alcuni aspetti di Team Foundation Build. Il file TfsBuildService.exe.config contiene le impostazioni per la porta che viene utilizzata per comunicare con il server di Team Foundation; per la configurazione del numero massimo di processi utilizzato da Team Foundation Build; per la generazione di errori ed avvisi per progetto o per piattaforma e combinazione di configurazione; per la modifica dei nomi delle cartelle di origine, dei binari e dei nomi delle sottodirectory dei risultati dei test su un agente di compilazione. Per ulteriori informazioni, vedere Procedura: modificare le impostazioni contenute nel file TfsBuildService.exe.config.

  Il file TfsBuildService.exe.config si trova in <unità>:\Programmi\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies su un server di livello applicazione.

• 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. Include 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. Questo argomento include 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. Questo argomento include esempi.

Vedere anche

Attività

Procedura dettagliata: personalizzazione di Team Foundation Build con un'attività personalizzata

Altre risorse

Personalizzazione di Team Foundation Build

Concetti relativi a MSBuild