Пошаговое руководство. Добавление шагов построения с помощью задачи BuildStep
Обновлен: Ноябрь 2007
Задача BuildStep представляет собой задачу MSBuild, написанную специально для Team Foundation Server. Задача BuildStep добавляется в построение с помощью добавления одного или нескольких элементов в файл TFSBuild.proj определения построения данного решения.
Необходимые компоненты
Перед добавлением задачи BuildStep в определение построения необходимо убедиться в наличии следующих элементов.
Доступ к файлу TFSBuild.proj для определения построения, которое необходимо настроить. Дополнительные сведения о том, как создавать определения построений, см. в разделе Создание определения построения.
.gif "Важное примечание")
Важное примечание.При настройке файла TFSBuild.proj выполняется настройка всех определений построений, связанных с ним.
Локальная рабочая область, содержащая файлы командного проекта и файлы построения. Дополнительные сведения см. в разделах Практическое руководство. Создание сопоставленной рабочей области и Практическое руководство. Получение исходного кода для командного проекта.
Необходимые разрешения
Чтобы выполнять процедуры в данном разделе, необходимо задать для разрешений Возврат и Извлечение значение Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
Выполните следующие процедуры, чтобы добавить шаги с помощью задачи BuildStep.
Добавление задачи в файл проекта
Добавление информационного шага построения в файл проекта
Добавление задачи в файл проекта
Задачу BuildStep можно использовать для добавления и обновления шагов построения. Ниже описана процедура изменения файла TFSBuild.proj.
Добавьте шаг построения.
Выполните задачу
Установите для шага построения состояние "Успешно завершено", если задача выполнена успешно, или состояние "Ошибка", если при выполнении задачи произошел сбой.
В приведенном примере задача шага построения выполняет копирование исходных файлов в новое расположение.
Добавление и обновление шага построения в файле TFSBuild.proj
Запустите Visual Studio.
Извлеките файл TFSBuild.proj, который необходимо изменить, из Team Foundation (подсистема контроля версий) и откройте его в XML-редакторе Visual Studio.
Добавьте следующий XML-код в элемент <ItemGroup>. Можно добавлять XML-код в существующий элемент <ItemGroup> или добавить новый элемент <ItemGroup>.
.gif "Примечание")
Примечание.На этом шаге код указывает папки, где расположены копируемые исходные файлы. Для других задач MSBuild может потребоваться добавить другие XML-коды. Дополнительные сведения о требованиях к задачам MSBuild см. Справочник по задачам MSBuild.
<ItemGroup> <SourceFileFolder Include="C:\WorkingFolder\TeamBuildTypes\**\*.cs" /> </ItemGroup>Добавьте следующий XML-код в конец файла TFSBuild.proj перед элементом </Project>.
</ItemGroup> <Target Name="BeforeCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Working..."> <Output TaskParameter="Id" PropertyName="StepId" /> </BuildStep> <!-- Perform a task... --> <Copy SourceFiles="@(SourceFileFolder)" DestinationFolder="C:\NewSourceFileFolder" /> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Succeeded" /> <OnError ExecuteTargets="MarkBuildStepAsFailed" /> </Target> <Target Name="MarkBuildStepAsFailed"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Id="$(StepId)" Status="Failed" /> </Target> </Project>Примечание.Дополнительные сведения о целевых объектах Team Foundation Build и списке настраиваемых целевых объектов см. в разделе Настраиваемые цели Team Foundation Build.
Сохраните изменения и закройте файл TFSBuild.proj.
Верните файл TFSBuild.proj в систему управления версиями.
Запустите определение построения.
Дополнительные сведения см. в разделе Практическое руководство. Постановка в очередь или запуск определения построения.
В Сред. Обозреватель сборки можно просмотреть сообщение шага построения, а в журнале построения можно увидеть полные сведения о процессах создания и обновления шага построения. В указанном каталоге можно также увидеть скопированные файлы. Дополнительные сведения см. в разделе Практическое руководство. Наблюдение за ходом построения.
Добавление информационного шага построения в файл проекта
Если выполнение задачи не требуется, но необходимо добавить информационный шаг построения, не используйте свойство Id Output и немедленно установите состояние. Данная процедура только добавляет сообщение в процесс построения, которое отображается при открытии построения в Сред. Обозреватель сборки.
Добавление информационного шага построения в файл TFSBuild.proj
Запустите Visual Studio.
Извлеките файл TFSBuild.proj, который необходимо изменить, из Team Foundation (подсистема контроля версий) и откройте его в XML-редакторе Visual Studio.
Добавьте следующий XML-код в конец файла TFSBuild.proj перед тегом </Project>.
</ItemGroup> <Target Name="AfterCompile"> <BuildStep TeamFoundationServerUrl="$(TeamFoundationServerUrl)" BuildUri="$(BuildUri)" Message="Compile step complete." Status="Succeeded" /> </Target> </Project>Примечание.Дополнительные сведения о целевых объектах Team Foundation Build и списке настраиваемых целевых объектов см. в разделе Настраиваемые цели Team Foundation Build.
Сохраните изменения и закройте файл TFSBuild.proj.
Верните файл TFSBuild.proj в систему управления версиями.
Запустите определение построения.
Дополнительные сведения см. в разделе Практическое руководство. Постановка в очередь или запуск определения построения.
Сообщение можно просмотреть в Сред. Обозреватель сборки и журнале построения. Дополнительные сведения см. в разделе Практическое руководство. Наблюдение за ходом построения.