Attività di Team Foundation Build

Aggiornamento: novembre 2007

Le attività di MSBuild sono contenute nelle destinazioni. Tali attività forniscono il codice da eseguire durante il processo di compilazione. MSBuild fornisce una libreria di attività comuni. Per ulteriori informazioni, vedere Riferimenti delle attività MSBuild.

Il file .target di MSBuild file Team Foundation Build, Microsoft.TeamFoundation.Build.targets definisce alcune attività predefinite di Team Foundation Build che è possibile personalizzare impostando alcune proprietà nel file TfsBuild.proj. Ad esempio, la destinazione CoreGet include un'attività Get che consente il recupero di uno specifico insieme di modifiche per un tipo di compilazione. Per impostazione predefinita, l'attività Get recupera i file più recenti. Per ulteriori informazioni sui file .targets, vedere File con estensione targets di MSBuild.

Elenco delle attività predefinite in Microsoft.TeamFoundation.Build.targets

È possibile personalizzare le seguenti attività modificandone le proprietà.

Attività di Team Foundation Build	Destinazione associata
Attività Get Sincronizza i sorgenti sul computer di compilazione. L'attività genera inoltre eventi di registro per informare il logger di ogni file e versione recuperati nell'area di lavoro locale.	Get
Attività Label Etichetta tutti i file di origine di un'area di lavoro specificata.	Label
Attività GenCheckinNotesUpdateWorkItems Genera l'elenco di tutti gli insiemi di modifiche e gli elementi di lavoro creati o interessati durante una generazione. Le etichette vengono utilizzate per contrassegnare una generazione specifica.	Viene richiamata la destinazione GetChangeSetsAndUpdateWorkitems se la generazione ha esito positivo. Viene richiamata la destinazione GetChangeSetsOnBuildBreak se la generazione ha esito negativo.
Attività CreateNewWorkItem Crea un nuovo elemento di lavoro per gli errori che si verificano durante il processo di generazione. Inoltre il campo Found In nell'elemento di lavoro viene aggiornato con un collegamento al numero di generazione specifico.	CreateWorkItem
Attività CreateWorkspaceTask Crea una nuova area di lavoro sul computer di compilazione.	InitializeWorkspace
Attività DeleteWorkspaceTask Elimina l'area di lavoro creata durante l'esecuzione della compilazione. I file non vengono eliminati dal computer di generazione. Se l'area di lavoro specificata non esiste, DeleteWorkspaceTask genera un avviso.	InitializeWorkspace
Attività UpdateBuildNumberDropLocation Crea una cartella al percorso specificato per ricevere i file generati. Aggiorna inoltre il numero di build.	InitializeEndToEndIteration
Attività TestToolsTask Esegue un insieme di test durante la compilazione e ne pubblica i risultati.	RunTestWithConfiguration
Attività BuildStep Inserisce le istruzioni di compilazione nella compilazione.	Nessuno
Attività GetBuildProperties Restituisce i valori iniziali per le proprietà di compilazione.	InitializeBuildProperties
Attività SetBuildProperties Imposta tutte le proprietà che possono essere impostate sulla compilazione.	Nessuno
Attività WorkspaceItemConverterTask Converte gli elementi del server di controllo della versione in elementi dell'area di lavoro locali e viceversa.	ResolveSolutionPathsForEndToEndIteration e ResolveTestFilesForEndToEndIteration.

Modifica delle attività di Team Foundation Build

Per modificare le attività definite nel file Microsoft.TeamFoundation.Build.targets, esaminare le proprietà dell'attività che si desidera modificare, quindi specificare tali proprietà nel file TfsBuild.proj per il tipo di generazione di Team Foundation Build. L'attività CreateNewWorkItem viene definita nel seguente modo:

<!-- Create WorkItem for build failure -->
    <CreateNewWorkItem
          BuildId="$(BuildNumber)"
          Description="$(WorkItemDescription)"
          TeamProject="$(TeamProject)"
          TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
          Title="$(WorkItemTitle)"
          WorkItemFieldValues="$(WorkItemFieldValues)"
          WorkItemType="$(WorkItemType)"
          ContinueOnError="true" />

Per personalizzare l'elemento di lavoro generato quando si verifica un errore di compilazione, impostare WorkItemFieldValues nel file TFSBuild.proj:

Nota:
Nel seguente esempio si presuppone che siano state impostate anche le proprietà Areapath e IterationPath.

<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>

Vedere anche

Attività

Procedura: utilizzare le variabili di ambiente in una compilazione

Concetti

Informazioni sui file di configurazione di Team Foundation Build

Proprietà personalizzabili di Team Foundation Build

Destinazioni personalizzabili di Team Foundation Build