Поделиться через

Описание файлов конфигурации Team Foundation Build

  • Статья

В этом разделе рассматриваются файлы конфигурации, используемые шаблоном обновления. Дополнительные сведения о шаблоне обновления см. в разделе Определение построения с помощью шаблона обновления. Средства, которые используются для создания этих файлов, например мастер создания файлов проектов MSBuild, доступны только в Visual Studio Team System 2008.

При обработке построения на базе шаблона обновления Team Foundation Build использует подсистему MSBuild. Этот процесс управляется набором XML-файлов, соответствующих схеме файла проекта MSBuild. Следующие элементы в данных XML-файлах играют важную роль в процессе построения:

  • Элемент — целевой объект Элемент 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 Application Lifecycle Management и располагается в каталоге <root>:\Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild\. На компьютере имеется только одна копия этого файла, и она совместно используется всеми построениями, запущенными на этом компьютере.

    Важно!

    Не изменяйте файл Microsoft.TeamFoundation.Build.targets.Изменения данного файла влияют на все определения построения.Для настройки определений построения необходимо изменить связанный с ними файл TfsBuild.proj.

  • TfsBuild.proj

    Это основной файл конфигурации для Team Foundation Build. Его можно связать только с одним определением построения, или он может совместно использоваться несколькими определениями построения. Данный файл сохраняет параметры конфигурации, указанные в мастере создания файла проекта MSBuild. Сюда включается командный проект, тип рабочего элемента, созданный при разрыве построения, конфигурация построения и решения построения. Мастер создания файла проекта MSBuild создает данный файл, когда создается новый файл проекта для нового определения построения. Дополнительные сведения см. в разделе Создание базового определения построения. Данный файл импортирует файл Microsoft.TeamFoundation.Build.targets, который передается в MSBuild. Любые изменения данного файла влияют на построения всех связанных с ним определений построения. Данный файл по умолчанию сохраняется в системе управления версиями в папке $\Мой_проект\TeamBuildTypes\Определение_построения, где Мой_проект — это имя командного проекта, а Определение_построения — это имя определения построения. Также можно сохранить данный файл в другом расположении, указав его в диалоговом окне Определение построения.

    Файл TfsBuild.proj включает примеры использования в тексте комментариев. Данные примеры включают вызов пользовательских целей в элементе SolutionToBuild и передачу пользовательских свойств в другие элементы.

  • 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 для настройки определений построения. В этом разделе также приводятся примеры.