Condividi tramite


Proprietà personalizzabili di Team Foundation Build

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 Visual C++

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 Personalizzare il gruppo di elementi SolutionToBuild.

Proprietà

Descrizione

BinariesRoot

Impostare questa proprietà per puntare alla radice della cartella dei binari sul computer di compilazione.

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, verrà eliminata l'intera directory di origine durante l'esecuzione della destinazione CoreClean.

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à TeamBuildOutDir per recuperare il valore che Team Foundation Build avrebbe assegnato a PublishDir se CustomizableOutDir fosse stato impostato su false.

CustomizablePublishDir

Impostare questa proprietà su true quando si desidera impedire a Team Foundation Build di impostare 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.

CustomPropertiesForBuild

Impostare questa proprietà per passare valori personalizzati ad ogni soluzione quando la destinazione predefinita (generalmente Build) viene chiamata in Team Foundation Build.

CustomPropertiesForClean

Impostare questa proprietà per passare valori personalizzati ad ogni soluzione quando la destinazione Clean viene chiamata da Team Foundation Build.

GetAllowUnmapped

Impostare questa proprietà su false per causare la mancata riuscita della compilazione se sono presenti file non mappati in un'area di sospensione (per le compilazioni private e di archiviazione gestita).

GetAutoMerge

Impostare questa proprietà su false per causare la mancata riuscita della compilazione se si verificano conflitti durante l'operazione get del controllo della versione in una compilazione privata o di archiviazione gestita.

GetNoCIOption

Impostare questa proprietà su false per escludere l'inserimento della stringa ***NO_CI*** nei commenti di archiviazione durante l'esecuzione di una compilazione di archiviazione gestita. Tenere presente che impostando questa proprietà su false si causerà l'accodamento delle compilazioni di integrazione continuata.

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.

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.

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.

PerformTestImpactAnalysis

Impostare questa proprietà su false per disabilitare l'analisi dell'impatto sui test.

PublishTestResults

Impostare questa proprietà su false per ignorare la pubblicazione dei risultati del test.

SkipClean

Impostare questa proprietà per ignorare la destinazione CoreClean.

SkipDropBuild

Impostare questa proprietà per ignorare la destinazione CoreDropBuild.

SkipGet

Impostare questa proprietà per ignorare la destinazione CoreGet.

SkipGetChangesetsAndUpdateWorkItems

Impostare questa proprietà su true per ignorare l'associazione di insiemi di modifiche e l’aggiornamento di elementi di lavoro per le compilazioni riuscite.

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.

SkipLabel

Impostare questa proprietà per ignorare la destinazione CoreLabel.

SkipPostBuild

Impostare questa proprietà per ignorare la raccolta degli elementi di lavoro e degli insiemi di modifiche associati.

SkipWorkItemCreation

Impostare questa proprietà per ignorare la destinazione CoreCreateWorkItem.

SolutionRoot

Impostare questa proprietà per puntare alla radice della cartella delle origini sul computer di compilazione.

StopOnFirstFailure

Impostare questa proprietà su true per interrompere la pulizia, la compilazione o il test al primo errore rilevato durante l'esecuzione della compilazione.

UpdateAssociatedWorkItemsOnBuildBreak

Impostare questa proprietà su true per aggiornare gli elementi di lavoro associati anche in presenza di una per una compilazione interrotta.

Personalizzazione delle compilazioni di Visual C++

Team Foundation Build supporta inoltre la personalizzazione della compilazione di progetti Visual C++ 9.0. È 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 VCBuild Task.

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