Пошаговое руководство. Настройка команды построения для построения проекта установки в Visual Studio

Статья
11/05/2008

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

Можно настроить Team Foundation Build, добавив настраиваемые задания или используя задания MSBuild, выполняющиеся на определенном этапе во время процесса построения. В этой теме изложены шаги, которые необходимо предпринять для настройки определения построения для использования задания MSBuild Exec, чтобы построить проект установки Visual Studio.

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

Для выполнения данного пошагового руководства необходимо следующее:

Клиентский компьютер с:

Установленным Development Edition
Установленным Сред. Командный обозреватель
Доступное подключение к Team Foundation Server
Локальная папка для использования в качестве рабочей области

Командного проекта с:

Созданное определение построения
Рабочую область для системы управления версиями, настроенную на локальную папку

Дополнительные сведения см. в разделе Практическое руководство. Создание сопоставленной рабочей области. В этом пошаговом руководстве используется локальная рабочая область: C:\DeploymentProjects.
Активированное управления версиями файлов
1. Чтобы убедится, что Visual Studio настроен для использования Team Foundation (подсистема контроля версий), в меню Инструменты, нажмите Параметры, а затем Управление версиями.
2. Выберите Visual Studio Team Foundation Server в списке Текущий встроенный модуль системы управления версиями.

Агент построения с установленным Team Foundation Build.

Чтобы использовать задание MSBuild Exec для вызова devenv.exe для построения проекта установки, на агенте построения должен быть установлен Visual Studio. Дополнительные сведения см. в разделах Задача Exec и Параметры командной строки для команды Devenv.

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

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

Чтобы завершить это пошаговое руководство, следует установить для разрешений Администрирование построения и Администрирование рабочих областей значение Разрешить. Также для разрешений Возвращать и Извлекать следует задать значение Разрешить.

Для создания командного проекта, необходимо разрешение Создавать новые проекты со значением Разрешить, также необходимо входить в группу Центральные администраторы SharePoint в Windows SharePoint Server с разрешением Менеджер содержимого в службах отчетов SQL.

Для запуска установщика, на компьютере необходимо иметь разрешения на запуск установщика, созданного Team Foundation Build.

Создание проекта Visual Studio

Действия, изложенные в этом пошаговом руководстве, описывают создание простого приложения C# Windows с формами, которое используется в качестве примера для настройки Team Foundation Build для построения проекта установки Visual Studio.

Чтобы создать приложение форм Windows в Visual Studio

В меню Файл укажите Создать и щелкните Проект.
В диалоговом окне Создание проекта в области Тип проекта выберите Visual C#. Выберите Приложение форм Windows в области Шаблоны.
Тип HelloWorldTest в поле Имя. В поле Расположение, введите C:\DeploymentProjects, или откройте локальную рабочую область, выбранную для командного проекта.
Нажмите кнопку ОК.

В обозревателе решений отобразится "HelloWorldTest", а в конструкторе Windows Forms отобразится "Form1.cs".
В меню Вид щелкните Панель элементов, чтобы открыть список элементов управления.
Переместите на форму элемент управления "Кнопка".
Дважды щелкните по новой кнопке, чтобы открыть редактор кода.

Visual C# вносит метод "button1_Click".

Добавьте следующий код в метод:

private void button1_Click(object sender, EventArgs e)
        {
            MessageBox.Show("Hello World!");

        }

В меню Файл выберите команду Сохранить все для сохранения изменений.
В меню Построение, нажмите Build HelloWorldTest для построения решения и проверки наличия возможных ошибок построения.

Чтобы создать проект развертывания

Выберите решение "HelloWorldTest" solution в обозревателе решений, в меню Файл, укажите на Добавить, далее нажмите Новый проект.
В диалоговом окне Добавить новый проект в Тип проекта разверните узел Другие типы проектов, нажмите Проекты установки и развертывания, а затем в области Шаблоны нажмите Проект установки. В поле Имя введите HelloWorldTestInstaller.
Нажмите кнопку ОК, чтобы закрыть диалоговое окно.

Проект будет добавлен в Обозреватель решений, и откроется Редактор файловой системы.

Добавление приложения "HelloWorldTest" в установщик

Выберите HelloWorldTestInstaller в обозревателе решений. В Редактор файловой системы, щелкните правой клавишей по узлу Каталог приложения, укажите на Добавить и нажмите Файл.
В диалоговом окне Добавить файлы, откройте расположение "HelloWorldTest.exe", выберите его, и нажмите кнопку Открыть.

Расположение в данном пошаговом руководстве: C:\DeploymentProjects\HelloWorldTest\HelloWorldTest\obj\Debug\HelloWorldTest.exe. Путь к файлу может разнится в зависимости от его расположения в рабочем пространстве.
В меню Файл выберите команду Сохранить все для сохранения изменений.

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

Чтобы проверить, был ли создан установщик построением проекта установки, следует открыть расположение созданного файла. В нем должны располагаться файлы "HelloWorldTestInstaller.msi" и "setup.exe".

Примечание.
Чтобы найти созданный файл, щелкните правой клавишей по проекту HelloWorldTestInstaller в обозревателе решений, далее нажмите Свойства. В диалоговом окне Станицы свойств HelloWorldTestInstaller, поле Имя выводимого файла содержит расположение файлов установщика.

Чтобы найти созданный файл, щелкните правой клавишей по проекту HelloWorldTestInstaller в обозревателе решений, далее нажмите Свойства. В диалоговом окне Станицы свойств HelloWorldTestInstaller, поле Имя выводимого файла содержит расположение файлов установщика.

Настройка файла vdproj для работы с построением Team Foundation

Щелкните правой клавишей мыши по проекту HelloWorldTestInstaller в обозревателе решений, далее нажмите Свойства. В диалоговом окне Страницы свойств HelloWorldTestInstaller, нажмите Диспетчер конфигурации.

Убедитесь, что поле Построение выбрано для "HelloWorldTest" и "HelloWorldTestInstaller".
Нажмите кнопку Закрыть в диалоговом окне Диспетчер конфигураций, а затем нажмите кнопку ОК, чтобы закрыть диалоговое окно Страницы свойств HelloWorldTestInstaller.
В меню Файл выберите команду Сохранить все для сохранения изменений.
Найдите файл "HelloWorldTestInstaller.vdproj".

Расположение в данном пошаговом руководстве: C:\DeploymentProjects\HelloWorldTest\HelloWorldTestInstaller. Путь к файлу может разнится в зависимости от его расположения в рабочем пространстве.
Щелкните правой клавишей по HelloWorldTestInstaller.vdproj, укажите на Открыть с помощью, далее нажмите Выбрать программу. В диалоговом окне Открыть с помощью, выберите Блокнот из области Программы, далее нажмите кнопку ОК, чтобы открыть "HelloWorldTestInstaller" в блокноте.
Убедитесь, что все заданные пути указаны относительно расположения файлов "HelloWorldTestInstaller.vdproj".

Абсолютных путей быть не должно.

Добавление и возвращение HelloWorldTest в систему управления версиями Team Foundation

Щелкните правой клавишей мыши по решению HelloWorldTest в обозревателе, далее нажмите Добавить решение в систему управления версиями.

Рядом с файлами отобразится желтый знак плюса. Это означает, что файлы ожидают добавления в систему управления версиями.

В обозревателе решений щелкните правой кнопкой мыши решение HelloWorldTest и нажмите Вернуть. В диалоговом окне Вернуть – Исходные файлы – Рабочая область: <Workspace name>, осуществите прокрутку до выбранных файлов. Очистите поле Имя для HelloWorldTest.exe и нажмите кнопку Возвратить.

Теперь файлы возвращены в Team Foundation (подсистема контроля версий).

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

Изменение файла "TFSBuild.proj"

Перед построением проекта "HelloWorldTestInstaller" с использованием Team Foundation Build, следует либо создать новое определение, либо использовать существующее определение построения, которое можно изменять. Дополнительные сведения см. в разделе Создание определения построения. Следует изменить файл проекта "TFSBuild.proj", связанный с определением построения, чтобы он построил проект установки.

Чтобы изменить файл "TFSBuild.proj" для построения проекта установки

В меню Вид укажите на Другие окна, затем нажмите Обозреватель управления исходным кодом.
В обозревателе управления исходным кодом, раскройте командный проект в области Папки, и найдите созданный файл "TFSBuild.proj". По умолчанию, расположением является папка "TeamBuildTypes", расположенная в папке командного проекта.
В панели просмотра, выберите тип построения для построения "HelloWorldTest" и "HelloWorldTestInstaller". Если копия файла отсутствует в локальной рабочей области, щелкните правой кнопкой по папке TeamBuildType, далее нажмите Получить последнюю версию.

Это позволяет сделать файлы доступными для извлечения и правки.
В панели просмотра, дважды щелкните по типу построения, щелкните правой клавишей по "TFSBuild.proj", далее нажмите Извлечь для правки. В диалоговом окне Извлечь, выберите Отсутствует — разрешить общий доступ при извлечении, далее нажмите кнопку Извлечь.

Рядом с файлом "TFSBuild.proj" появится красный маркер, указывающий на состояние файла в системе управления версиями.
Дважды щелкните по файлу "TFSBuild.proj", чтобы открыть его в XML-редакторе Visual Studio.
Добавьте следующий код, полужирным, в конец файла "TFSBuild.proj", перед закрывающим тэгом </Project>.
```
<Target Name="AfterCompile">     <Exec Command="&quot;$(ProgramFiles)\Microsoft Visual Studio 9.0\Common7\IDE\devenv&quot; &quot;$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj&quot; /Build &quot;Debug|Any CPU&quot;"/>     <Copy SourceFiles="$(SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\HelloWorldTestInstaller.msi; SolutionRoot)\HelloWorldTest\HelloWorldTestInstaller\Debug\setup.exe" DestinationFolder="$(OutDir)" /> </Target> 
```
Таким образом будет использовано задание MSBuild exec для построения проекта установки "HelloWorldTestInstaller" при помощи программы devenv.exe. Дополнительные сведения см. в разделе Задача Exec. Задание MSBuild copy используется для копирования файлов .msi и .exe в папку Team Foundation Build. Дополнительные сведения см. в разделе Задача Copy.

Целевой AfterCompile выполняется после того, как Team Foundation Build закончил выполнение цели CoreCompile, при чем приложение "HelloWorldTest" компилируется. Дополнительные сведения об именах цели см. в разделе Описание файлов конфигурации Team Foundation Build.
В меню Файл, нажмите Сохранить чтобы сохранить изменения, далее закройте "TFSBuild.proj".
В обозревателе управления исходным кодом щелкните правой кнопкой мыши файл "TFSBuild.proj" и выберите нажмите Вернуть ожидающие изменения. Также можно добавить комментарий в диалоговом окне Вернуть- Исходные файлы – Рабочая область: <workspace name>. Нажмите Вернуть чтобы вернуть "TFSBuild.proj" в систему управления версиями.

Запуск определения построения

После изменения файла "TFSBuild.proj" и сохранения изменений в Team Foundation (подсистема контроля версий), запустите определения построения для построения проекта развертывания.

Запуск определения командного построения

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

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

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

В Сред. Обозреватель сборки, щелкните по файлу журнала под заголовком Сводка. Проверьте файл журнала на наличие ошибок.

Примечание.
Можно не беспокоясь игнорировать предупреждение MSB4078: Файл проекта "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" не поддерживается MSBuild и не может быть построен. Построение файла осуществляется программой devenv.exe, использующей задание MSBuild Exec.

Можно не беспокоясь игнорировать предупреждение MSB4078: Файл проекта "HelloWorldTestInstaller\HelloWorldTestInstaller.vdproj" не поддерживается MSBuild и не может быть построен. Построение файла осуществляется программой devenv.exe, использующей задание MSBuild Exec.

Установка созданного файла установки

Найдите расположения для перетаскивания \\<расположение перемещения>\Public_build\HelloWorldTestBuild_<номер построения>\Release.

Расположение перемещения – то же самое совместное использование файла, что и расположение файла журнала, и приводится в списке под заголовком Сводка в Сред. Обозреватель сборки.
Скопируйте файлы "HelloWorldTestInstaller.msi" и "setup.exe" на компьютер, где разработчик является участником группы администраторов безопасности Windows или имеет разрешение Установка со значение Разрешить.
Осуществите двойной щелчок по файлу "setup.exe" и следуйте инструкциям мастера установки.

"HelloWorldTestInstaller.exe" устанавливается по адресу <root>:\Program Files\Microsoft\HelloWorldTestInstaller.
Перейдите в <root>:\Program Files\Microsoft\HelloWorldTestInstaller.
Дважды щелкните файл .exe для запуска приложения.

Следующие действия

Можно изменять проект установки Visual Studio чтобы настроить мастер установки для выполнения дополнительных действий. Дополнительные сведения см. в разделе Основные понятия развертывания с помощью установщика Windows.

См. также

Задачи

Пошаговое руководство. Расширение возможностей Team Foundation Build с помощью настраиваемых задач

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

Работа с определениями построений в Team Foundation Build

Управление построениями с помощью Team Foundation Build

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