Настраиваемые свойства построения Team Foundation
Обновлен: Ноябрь 2007
Свойства MSBuild представляют собой пары "ключ/значение", которые вы можете использовать для настройки построений. Дополнительные сведения см. в разделе Свойства MSBuild.
В файле Microsoft.TeamFoundation.Build.targets определено несколько целей MSBuild, заданий, и свойств для Team Foundation Build. Вы можете изменить эти свойства в файле TFSBuild.proj для:
передачи значений заданиям Team Foundation Build и целям;
переопределения некоторых действий по построению;
Дополнительные сведения о файле TFSBuld.proj см. в разделе Описание файлов конфигурации Team Foundation Build.
В этом документе имеются следующие главы:
Настройка построений VC++
Свойства, используемые для настройки заданий
Свойства, которые могут быть переопределены
В следующей таблице перечислены свойства, определенные для Team Foundation Build. Вы можете переопределить их в файле TfsBuild.proj для настройки процесса построения. Дополнительные сведения см. в разделе Настройка группы элементов SolutionToBuild.
Свойство |
Описание |
|---|---|
CustomPropertiesForClean |
Задайте этой свойство, чтобы передать специальные значения всем решениям при вызове Team Foundation Build цели Clean. |
CustomPropertiesForBuild |
Задайте это свойство для передачи специальных значений всем решениям при вызове Team Foundation Build своей цели по умолчанию (обычно Build). |
SkipClean |
Задайте это свойство, чтобы пропустить цель CoreClean. |
IncrementalGet |
Задайте это свойство равным true, чтобы выполнить добавочную загрузку. Это свойство предназначено для удобства и устанавливает свойство CleanCompilationOutputOnly равным true, свойство SkipInitializeWorkspace равным true и свойство ForceGet равным false. |
IncrementalBuild |
Задайте это свойство равным true для выполнения инкрементного построения. Это свойство предназначено для удобства и устанавливает свойство SkipClean равным true, свойство SkipInitializeWorkspace равным true, и ForceGet равным false. |
CleanCompilationOutputOnly |
Задайте это свойство равным true для удаление только промежуточных сборок из исходных каталогов во время выполнения цели CoreClean. Если это свойство установлено равным false, весь исходный каталог очищается во время выполнения цели CoreClean. |
SkipGetChangesetsUpdateWorkItems |
Установите это свойство равным true, чтобы пропустить этапы связи наборов изменений и обновления рабочих элементов для успешных построений. |
SolutionRoot |
Задайте это свойство, чтобы указать корень папки источников на компьютере построения. |
BinariesRoot |
Задайте это свойство, чтобы указать корень папки двоичных файлов на компьютере построения. |
LabelComment |
Задайте это свойство, чтобы определить комментарий, используемый задачей Label. |
LabelName |
Задайте имя метки, чтобы определить имя, используемое задачей Label. По умолчанию для имени метки установлено значение $(BuildNumber) в цели InitializeEndToEndIteration. |
OutDir |
Задайте это свойство, чтобы определить расположение выходных файлов в рабочей папке построения. |
UpdateAssociatedWorkItemsOnBuildBreak |
Задайте этой свойство равным true для обновления связанных рабочих элементов даже в случае прерванного построения. |
StopOnFirstFailure |
Задайте это свойство равным true для остановки процессов чистки, компиляции и/или тестирования при первом сбое, возникшем во время выполнения построения. |
SkipGet |
Задайте это свойство, чтобы пропустить цель CoreGet. |
SkipLabel |
Задайте это свойство, чтобы пропустить цель CoreLabel. |
SkipInitializeWorkspace |
Задайте это свойство, чтобы пропустить цель CoreInitializeWorkspace. |
SkipInvalidConfigurations |
Задайте это свойство равным false, чтобы сгенерировать ошибку, а не предупреждение при обнаружении неверной конфигурации. |
SkipPostBuild |
Задайте это свойство, чтобы пропустить этап сборки связанных наборов изменений и рабочих элементов. |
SkipDropBuild |
Задайте это свойство, чтобы пропустить цель CoreDropBuild. |
SkipWorkItemCreation |
Задайте это свойство, чтобы пропустить цель CoreCreateWorkItem. |
CustomizableOutDir |
Задайте это свойство равным true, когда хотите запретить Team Foundation Build отдельную установку OutDir для каждого решения. Обратите внимание, что вы можете использовать свойство TeamBuildPublishDir для извлечения значения, которое Team Foundation Build присвоил бы PublishDir, если бы CustomizablePublishDir было равно false. |
CustomizablePublishDir |
Задайте это свойство равным "true", когда вы ходите запретить Team Foundation Build отдельную установку каталога PublishDir для каждого решения. Обратите внимание, что вы можете использовать свойство TeamBuildPublishDir для извлечения значения, которое Team Foundation Build присвоил бы PublishDir, если бы CustomizablePublishDir было равно false. |
Настройка построений VC++
Team Foundation Build также поддерживает настройку построений для проектов Visual C++. Вы можете использовать следующие свойства для задания соответствующих свойств задания VCBuild, используемого MSBuild для построения проектов Visual C++. Дополнительные сведения см. в разделе Задача VCBuild.
Свойство Team Build |
Свойство задания VCBuild |
Описание |
|---|---|---|
VCBuildAdditionalLibPaths |
AdditionalLibPaths |
Задает дополнительные маршруты для поиска библиотек перед поиском в каталогах, заданных в переменной окружения LIB (соответствует параметра LIBPATH для LINK.exe). |
VCBuildAdditionalOptions |
AdditionalOptions |
Задает дополнительные опции командной строки, для которых отсутствуют выделенные параметры задания. |
VCBuildToolPath |
ToolPath |
Указывает местоположение, откуда задание VCBuild загружает свой исполняемый файл (vcbuild.exe). |
VCBuildUseEnvironment |
UseEnvironment |
Установите это свойство равным true, чтобы использовать переменные окружения для PATH, INCLUDE, LIBS, и LIBPATH. В противном случае задайте false. Это свойство соответствует параметра /useenv в VCBuild.exe. Дополнительные сведения см. в разделе /useenv. |
AdditionalVCOverrides |
Отсутствует |
Это свойство используется для задания дополнительных опций для файла (файлов) вкладки свойств задания VCBuild, генерируемых Team Foundation Build и заданных свойством Override задания VCBuild. |
Свойства, используемые для настройки заданий
Каждое задание по умолчанию Team Foundation Build в файле Microsoft.TeamFoundation.Build.targets также включает набор свойств, которые можно использовать для настройки задания. Дополнительные сведения о заданиях Team Foundation Build см. в разделе Задачи Team Foundation Build. Например, задание CreateNewWorkItem определяется следующим образом.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
Для настройки рабочего элемента, создаваемого в случае сбоя при построении, установите значение свойства WorkItemFieldValues в файле TFSBuild.proj:
.gif "Примечание") Примечание. |
|---|
В следующем примере предполагается, что свойства Areapath и 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>
См. также
Задачи
Практическое руководство. Использование переменных среды в построении