Описание файлов конфигурации Team Foundation Build
Обновлен: Ноябрь 2007
Процесс Team Foundation Build использует модуль MSBuild. Процесс Team Foundation Build управляется набором XML-файлов, которые соответствуют схеме файла проекта MSBuild. Следующие элементы в данных XML-файлах играют важную роль в процессе построения:
Элемент Target Элемент Target определяет метод построения проекта. Элементы Target содержат набор задач, которые MSBuild выполняет последовательно. Дополнительную информацию о целях см. в разделе Цели MSBuild.
Элемент Task Элемент Task определяет код, который запускается в ходе построения. Дополнительные сведения о задачах см. в разделе Задачи MSBuild.
Процесс MSBuild включает коллекцию общих задач, которые можно использовать для настройки процесса построения. Дополнительные сведения см. в разделе Справочные сведения о задачах MSBuild.
Элемент UsingTask Элемент UsingTask определяет сборку, которая содержит задачи, используемые в процессе построения.
Файлы сценариев MSBuild могут импортировать другие файлы сценариев. Например, можно определить общую конфигурацию в одном файле, а затем включить ее в другие конфигурации. Дополнительные сведения см. в разделе Как использовать одинаковый целевой объект в нескольких файлах проектов.
Два файла управляют процессом Team Foundation Build:
Microsoft.TeamFoundation.Build.targets
Данный файл определяет набор задач и целей по умолчанию, который включается в процесс Team Foundation Build. Например, Clean, DropBuild и Compile. Каждая цель содержит задачи, которые вызываются конкретно для данной цели. Некоторые цели в данном файле зависят от других целей: таким образом образуется цепочка целей, которая обрабатывается в определенном порядке. Например, цель Compile зависит от цели BeforeCompile, таким образом, любые задачи, определенные в цели BeforeCompile, выполняются до задач цели Compile. Не все цели, определенные в данном файле, обязательно выполняются в каждом построении. Например, построения рабочего стола не исполняют цель Clean.
Файл Microsoft.TeamFoundation.Build.targets включается в Visual Studio Team System и располагается в каталоге <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild\. На компьютере имеется только одна копия этого файла, и она совместно используется всеми построениями, запущенными на этом компьютере.
.gif "Важное примечание")
Важное примечание.Не изменяйте файл Microsoft.TeamFoundation.Build.targets. Изменения данного файла влияют на все определения построения. Для настройки определений построения необходимо изменить связанный с ними файл TfsBuild.proj.
TfsBuild.proj
Это основной файл конфигурации для Team Foundation Build. Его можно связать только с одним определением построения, или он может совместно использоваться несколькими определениями построения. Данный файл сохраняет параметры конфигурации, указанные в мастере создания файла проекта MSBuild. Сюда включается командный проект, тип рабочего элемента, созданный при разрыве построения, конфигурация построения и решения построения. Мастер создания файла проекта MSBuild создает данный файл, когда создается новый файл проекта для нового определения построения. Дополнительные сведения см. в разделе Создание определения построения. Данный файл импортирует файл Microsoft.TeamFoundation.Build.targets, который передается в MSBuild. Любые изменения данного файла влияют на построения всех связанных с ним определений построения. Данный файл по умолчанию сохраняется в системе управления версиями в папке $\MyProject\TeamBuildTypes\BuildDefinition , где MyProject — это имя командного проекта, а BuildDefinition — имя определения построения. Также можно сохранить данный файл в другом расположении: для этого нужно указать его в диалоговом окне Определение построения.
Файл TfsBuild.proj включает примеры использования в тексте комментариев. Данные примеры включают вызов пользовательских целей в элементе SolutionToBuild и передачу пользовательских свойств в другие элементы.
Кроме того, важную роль играют следующие файлы:
TfsBuildService.exe.config
Файл TfsBuildService.exe.config используется для настройки определенных характеристик Team Foundation Build. Файл TfsBuildService.exe.config включает параметры порта, используемого для связи с сервером Team Foundation; для настройки максимального количества процессов, используемых Team Foundation Build; для генерирования сообщений об ошибке и предупреждений в проекте или для платформы и комбинации конфигурации; и для изменения имен подкаталогов для источника, двоичных файлов и результатов тестов в агенте построения. Дополнительные сведения см. в разделе Практическое руководство. Изменение параметров в файле TfsBuildService.exe.config.
Файл TfsBuildService.exe.config расположен в папке <корень>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\PrivateAssemblies на сервере уровня приложений.
TfsBuild.rsp
Это пустой файл, который создается мастером создания файла проекта MSBuild. Данный файл может использоваться для определения пользовательского средства ведения журнала или для переопределения свойств MSBuild. Дополнительные сведения см. в разделе Файлы ответов MSBuild.
Цели, свойства и задачи
В следующих разделах описываются цели, задачи и свойства по умолчанию, определенные в файле Microsoft.TeamFoundation.Build.targets.
Настраиваемые цели Team Foundation Build
Содержит список целей, определенных в файле Microsoft.TeamFoundation.Build.targets, которые можно переопределить путем записи пользовательских задач. Включает примеры, которые описывают настройку процесса построения.Настраиваемые свойства построения Team Foundation
Содержит список свойств по умолчанию, определенных в файле Microsoft.TeamFoundation.Build.targets, которые можно определить в файле TfsBuild.proj. Данный раздел включает примеры.Задачи Team Foundation Build
Содержит список задач по умолчанию, определенных в файле Microsoft.TeamFoundation.Build.targets, которые можно изменить в файле TfsBuild.proj для настройки определений построения. Данный раздел включает примеры.
См. также
Задачи
Пошаговое руководство. Расширение возможностей Team Foundation Build с помощью настраиваемых задач