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:
.gif "Nota") 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