Condividi tramite


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