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