Пошаговое руководство. Настройка и использование локальных построений

Обновлен: Ноябрь 2007

В Team Foundation Build разработчик, прежде чем вернуть изменения, может построить командный проект и выполнить тесты на локальном компьютере. В данном пошаговом руководстве показывается, как выполнять локальные построения.

Отличия локальных построений

Ниже приведены отличия сценария локального построения от сетевых построений.

• Выполняется только компиляция и тестирование (если они разрешены).

• Другие этапы сетевого построения, такие как синхронизация, очистка, обработка кода, копирование в специальные папки, обновление рабочих элементов и создание новых рабочих элементов, в локальных построениях не выполняются.

• По умолчанию используется средство ведения журнала MSBuild, а вывод построения производится на консоль.

• Результаты построения и тестирования не публикуются и не помещаются в хранилище данных.

Результаты локальных построений

Средство ведения журнала Team Foundation Build не используется при локальных построениях. Поэтому данные не помещаются в базу данных для создания отчетов о состоянии. Чтобы просмотреть результаты локальных построений, необходимо перенаправить выходной файл используемого по умолчанию средства ведения журнала MSBuild и просмотреть его. Чтобы управлять уровнем детализации средства ведения журнала MSBuild, используйте параметр verbose команды MSBuild. Дополнительные сведения см. в разделе Общие сведения о средстве ведении журнала в MSBuild.

Обязательные компоненты

• Visual Studio Team System.

• Подключение к серверу Team Foundation Server и по крайней мере один существующий командный проект. Дополнительные сведения см. в разделах Пошаговое руководство. Присоединение к командному проекту и Практическое руководство. Создание командного проекта.

• По крайней мере одно заданное определение построения. Дополнительные сведения см. в разделе Пошаговое руководство. Создание определения построения в Team Foundation Build.

Необходимые разрешения

Чтобы выполнить процедуру, описанную в данном пошаговом руководстве, необходимо задать для разрешения Начать построение среды Team Foundation Server значение Разрешить. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Выполнение локального построения

1. Выполните вручную синхронизацию корневого каталога командного проекта на сервере Team Foundation (подсистема контроля версий) с локальной файловой системой.

   Пример

   На сервере Team Foundation (подсистема контроля версий) создается следующая структура папок по умолчанию:

   Примечание.
   Эта структура может отличаться от структуры на конкретном сервере Team Foundation (подсистема контроля версий).

   $\

   Portfolio Project1

   **     Team Build Types**

   **          Main**

   **               TFSBuild.proj**

   **     Solution1**

   **     Solution2**

   **     Solution3**

   После синхронизации проекта team project1 с локальным каталогом C:/temp локальная структура каталогов будет иметь следующий вид.

   C:/Temp

   **          /Portfolio Project1**

   **               /Team Build Types**

   **                    /Main**

   **                         /TFSBuild.proj**

   **               /Solution1**

   **               /Solution2**

   **               /Solution3**

   Важное примечание.
   Чтобы выполнить построение без ошибок, локальная структура каталогов должна полностью совпадать со структурой на сервере.

2. Запустите процесс Team Foundation Build с помощью команд MSBuild. Для этого введите в командной строке следующую команду.

   C:\temp\Portfolio Project1\Build Configurations\Main> MSBuild TeamBuild.proj

   Пути для решений в файле TFSBuild.proj разрешаются, поскольку для корневого каталога решения по умолчанию, указанного в файле TFSBuild.proj, задано значение "…/..". Кроме того, решения, переданные в задачу MSBuild, используют для свойства этого корневого каталога решения значение ($solutionroot)/Solution1. Поэтому в данном случае значение корневого каталога решения становится C:/Temp/Portfolio Project1.

   Примечание.
   Если необходимо изменить корневой каталог решения, используйте параметр /p. Дополнительные сведения см. в подразделе "Задание свойств из командной строки" раздела Свойства MSBuild.

См. также

Другие ресурсы

Пошаговые руководства по работе с построениями в Team Foundation