Proprietà personalizzabili di Team Foundation Build

Aggiornamento: novembre 2007

Le proprietà di MSBuild sono coppie chiave/valore che è possibile utilizzare per configurare le compilazioni. Per ulteriori informazioni, vedere Proprietà di MSBuild.

Il file Microsoft.TeamFoundation.Build.targets definisce diverse proprietà, attività e destinazioni di MSBuild per Team Foundation Build. È possibile modificare queste proprietà all’interno del file TSFBuild.proj per:

• Passaggio di valori ad attività e destinazioni di Team Foundation Build

• Override di determinate operazioni di compilazione

Per ulteriori informazioni sul file TfsBuild.proj, vedere Informazioni sui file di configurazione di Team Foundation Build.

In questo documento

Personalizzazione delle compilazioni di VC++

Proprietà utilizzate per personalizzare le attività

Proprietà di cui è possibile eseguire l'override

La seguente tabella elenca le proprietà definite per Team Foundation Build. È possibile eseguirne l'override all’interno del file TfsBuild.proj per personalizzare il processo di compilazione. Per ulteriori informazioni, vedere Procedura: personalizzare il gruppo SolutionToBuild Item.

Proprietà	Descrizione
CustomPropertiesForClean	Impostare questa proprietà per passare valori personalizzati ad ogni soluzione quando la destinazione Clean viene chiamata da Team Foundation Build.
CustomPropertiesForBuild	Impostare questa proprietà per passare valori personalizzati ad ogni soluzione quando la destinazione predefinita (generalmente Build) viene chiamata in .
SkipClean	Impostare questa proprietà per ignorare la destinazione CoreClean.
IncrementalGet	Impostare questa proprietà su true per eseguire un recupero incrementale. Si tratta di una comoda proprietà che imposta CleanCompilationOutputOnly a true, SkipInitializeWorkspace a truee ForceGet a false.
IncrementalBuild	Impostare questa proprietà su true per eseguire una compilazione incrementale. Si tratta di una comoda proprietà che imposta SkipClean a true, SkipInitializeWorkspace a truee ForceGet a false.
CleanCompilationOutputOnly	Impostare questa proprietà a true per eliminare solo gli assembly intermedi dalla cartella dei sorgenti durante l’esecuzione della destinazione CoreClean. Se questa proprietà è impostata su false, l’intera cartella sorgente sarà eliminata durante esecuzione della destinazione CoreClean.
SkipGetChangesetsUpdateWorkItems	Impostare questa proprietà su true per ignorare l'associazione di insiemi di modifiche e l’aggiornamento di elementi di lavoro per le compilazioni riuscite.
SolutionRoot	Impostare questa proprietà per puntare alla radice della cartella delle origini sul computer di compilazione.
BinariesRoot	Impostare questa proprietà per puntare alla radice della cartella dei binari sul computer di compilazione.
LabelComment	Impostare questa proprietà per definire il commento utilizzato dall'attività Label.
LabelName	Impostare questo nome di etichetta per definire il nome utilizzato dall'attività Label.   In base all'impostazione predefinita, il nome dell'etichetta è impostato su $(BuildNumber) nella destinazione InitializeEndToEndIteration.
OutDir	Impostare questa proprietà per definire il percorso dei file di output nella directory di lavoro di compilazione.
UpdateAssociatedWorkItemsOnBuildBreak	Impostare questa proprietà su true per aggiornare gli elementi di lavoro associati anche in presenza di una per una compilazione interrotta.
StopOnFirstFailure	Impostare questa proprietà su true per fermare ogni lavoro di pulitura, compilazione e/o testing, al primo errore riscontrato durante l'esecuzione.
SkipGet	Impostare questa proprietà per ignorare la destinazione CoreGet.
SkipLabel	Impostare questa proprietà per ignorare la destinazione CoreLabel.
SkipInitializeWorkspace	Impostare questa proprietà per ignorare la destinazione CoreInitializeWorkspace.
SkipInvalidConfigurations	Impostare questa proprietà su false per generare un errore anziché un avviso quando l’utente rileva una configurazione non valida.
SkipPostBuild	Impostare questa proprietà per ignorare la raccolta degli elementi di lavoro e degli insiemi di modifiche associati.
SkipDropBuild	Impostare questa proprietà per ignorare la destinazione CoreDropBuild.
SkipWorkItemCreation	Impostare questa proprietà per ignorare la destinazione CoreCreateWorkItem.
CustomizableOutDir	Impostare questa proprietà su true quando si desidera evitare che Team Foundation Build imposti OutDir per ciascuna soluzione. Si noti che è possibile utilizzare la proprietà TeamBuildPublishDir per recuperare il valore che Team Foundation Build avrebbe assegnato a PublishDir se CustomizablePublishDir fosse stato impostato su false.
CustomizablePublishDir	Impostare questa proprietà su true quando si desidera evitare che Team Foundation Build imposti la directory PublishDir per ciascuna soluzione. Si noti che è possibile utilizzare la proprietà TeamBuildPublishDir per recuperare il valore che Team Foundation Build avrebbe assegnato a PublishDir se CustomizablePublishDir fosse stato impostato su false.

Personalizzazione delle compilazioni di VC++

Team Foundation Build consente anche la personalizzazione della compilazione di progetti Visual C++. È possibile utilizzare le seguenti proprietà per impostare le corrispondenti proprietà dell'attività VCBuild utilizzata da MSBuild per compilare progetti Visual C++. Per ulteriori informazioni, vedere Attività VCBuild.

Proprietà Team Build	Proprietà Attività di VCBuild	Descrizione
VCBuildAdditionalLibPaths	AdditionalLibPaths	Specifica percorsi aggiuntivi in cui cercare le librerie prima che esse vengano cercate nei percorsi specificati dalla variabile di ambiente LIB (corrisponde all'opzione LIBPATH per LINK.exe).
VCBuildAdditionalOptions	AdditionalOptions	Specifica opzioni aggiuntive della riga di comando che non prevedono parametri dell'attività dedicati.
VCBuildToolPath	ToolPath	Specifica il percorso da cui l'attività VCBuild procederà a caricare il file eseguibile sottostante (VCBuild.exe).
VCBuildUseEnvironment	UseEnvironment	Impostare questo parametro su true per utilizzare variabili di ambiente per PATH, INCLUDES, LIBS e LIBPATH. In caso contrario, impostarlo su false. Questa proprietà corrisponde all’opzione /useenv per il comando VCBuild.exe. Per ulteriori informazioni, vedere /useenv.
AdditionalVCOverrides	Nessuna	Utilizzare questa proprietà per specificare eventuali opzioni aggiuntive per i file del foglio attività di VCBuild generati da Team Foundation Build e specificati nella proprietà Override dell'attività VCBuild.

Proprietà utilizzate per personalizzare le attività

Ogni attività di Team Foundation Build predefinita nel file Microsoft.TeamFoundation.Build.targets include anche un insieme di proprietà che possono essere utilizzate per personalizzare l'attività. Per ulteriori informazioni sulle attività di Team Foundation Build, vedere Attività di Team Foundation Build. L'attività CreateNewWorkItem è ad esempio definita nel seguente modo:

<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
          TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
          BuildUri="$(BuildUri)"
          BuildNumber="$(BuildNumber)"
          Description="$(WorkItemDescription)"
          TeamProject="$(TeamProject)"
          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