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


Практическое руководство. Построение командных проектов на локальном компьютере

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

В Team Foundation Build предусмотрена возможность локального построения решений и выполнения тестов с локальными двоичными файлами перед возвратом изменений на общий сервер Team Foundation (подсистема контроля версий). Ниже приведены отличия локальных построений от сетевых построений.

  • При локальном построении выполняется только компиляция и тестирование.

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

  • Запись результатов в журнал осуществляется стандартным средством ведения журнала MSBuild, поскольку средство ведения журнала Team Foundation Build не включено для локальных построений.

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

  • Не создаются отчеты о состоянии. Результаты построения отображаются в окне консоли. Чтобы получить дополнительные сведения, используйте параметр Verbosity при выполнении команды MSBuild. Дополнительные сведения см. в разделе Справочные сведения о командной строке MSBuild.

Дополнительные сведения о постановке построений в очередь см. в разделе Практическое руководство. Постановка в очередь или запуск определения построения.

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

Для выполнения этой процедуры необходимо иметь надлежащие разрешения файловой системы для создания файлов на компьютере агента построения. Также необходимо иметь надлежащие разрешения файловой системы для выполнения дополнительных процессов, указанных в рамках процесса построения. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

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

  1. Выполните синхронизацию корневого каталога командного проекта с каталогом на локальном компьютере. Дополнительные сведения см. в разделе Практическое руководство. Получение исходного кода для командного проекта.

    ms181723.alert_note(ru-ru,VS.90).gifПримечание.

    Team Foundation Build хранит все файлы определений построений в системе управления версиями. Каталогом по умолчанию является каталог TeamBuildTypes в корневом каталоге командного проекта. При создании определения построения можно назначить другой каталог для этой цели.

  2. Введите команду MSBuild в командной строке Visual Studio (нажмите кнопку Пуск, выберите последовательно пункты Все программы, Microsoft Visual Studio 2008, Средства Visual Studio и Командная строка Visual Studio 2008), используя файл определения построения в качестве аргумента, как показано в следующем примере.

    C:\temp\Team Project1\TeamBuildTypes\Main> MSBuild TfsBuild.proj /p:SolutionRoot=..\..

    ms181723.alert_note(ru-ru,VS.90).gifПримечание.

    Путь к папке файлов построения может быть другим.

    Если исходные файлы уже синхронизированы с некоторым каталогом, например d:\temp\mysources\solution1, можно выполнить синхронизацию файла типа построения с другим каталогом, например c:\temp. Используйте упомянутую выше команду, изменив только местоположение исходных файлов. Команда имеет следующий синтаксис.

    MSBuild TfsBuild.proj /p:SolutionRoot= d:\temp\mysources

    Любое свойство можно переопределить с помощью командной строки с ключом /p. Единственным обязательным свойством для локального построения является свойство SolutionRoot.

    Например, можно переопределить следующие свойства локального построения:

    • Verbose

    • RunFxCopFlag

  3. Следующие команды поддерживают дополнительный синтаксис для локальных построений Team Foundation Build.

    • msbuild TfsBuild.proj

      Используется для выполнения последовательного построения и тестов.

    • msbuild TfsBuild.proj /t:Clean

      Используется для выполнения операции очистки двоичных файлов и всех промежуточных объектных папок.

    • msbuild TfsBuild.proj /t:Compile

      Используется для выполнения инкрементной компиляции.

    • msbuild TfsBuild.proj /t:Test

      Используется для выполнения только тестов.

    • msbuild TfsBuild.proj /t:DesktopRebuild

      Используется для выполнения чистой полной компиляции и выполнения тестов.

    • msbuild TfsBuild.proj /p:BinariesRoot=d:\NewBinariesRoot /p:TestResultsRoot=d:\NewTestResultsRoot

      Используется для переопределения выходного каталога путем переопределения каталога BinariesRoot, в который копируются двоичные файлы продукта, и каталога TestResultsRoot, в котором сохраняются результаты тестов.

    • msbuild TfsBuild.proj /p:RunCodeAnalysis=false

      Используется для отключения анализа кода при локальном построении.

    • msbuild TfsBuild.proj /p:RunTest=false

      Используется для отключения выполнения тестов при локальном построении.

    Дополнительные сведения о параметрах команды MSBuild см. в разделе Справочные сведения о командной строке MSBuild.

См. также

Основные понятия

Общие сведения о средстве ведении журнала в MSBuild

Свойства MSBuild

Ссылки

Справочные сведения о командной строке MSBuild

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

Выполнение построений в Team Foundation Build