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

Статья
11/05/2008

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

В этом пошаговом руководстве демонстрируются функции управления версиями в Visual Studio Team System Team Foundation Server.

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

Установка Team Foundation (подсистема контроля версий) в качестве подключаемого модуля управления версиями по умолчанию для Visual Studio Team System Team Foundation Server.
Создание нового проекта в Visual Studio.
Добавление проекта в систему управления версиями и создание там локальной рабочей области для хранения, редактирования и тестирования файлов.
Возврат решения.
Добавление файла в проект с управлением версиями и изменение существующего файла.
Передача всех ожидающих изменений в локальной рабочей области на сервер управления версиями.

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

Перед тем как завершить изучение этого пошагового руководства, необходимо выполнить следующее:

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

Требуемые разрешения

Для выполнения инструкций данного пошагового руководства требуются разрешения Read и Checkin.

Установите систему управления версиями Team Foundation в качестве подключаемого модуля управления версиями

Перед использованием Team Foundation (подсистема контроля версий) нужно настроить Visual Studio для использования подключаемого модуля Team Foundation (подсистема контроля версий), как показано в следующей процедуре. Дополнительные сведения см. в разделе Практическое руководство. Настройка Visual Studio с системой управления версиями.

Примечание.
Visual Studio автоматически настраивается на использование подключаемого модуля Team Foundation (подсистема контроля версий), если установить Сред. Командный обозреватель после установки Visual Studio.

Настройка Visual Studio для использования сервера управления версиями Team Foundation

В меню "Сервис" выберите Параметры.
В диалоговом окне Параметры разверните пункт ИсточникСистема управления версиями и перейдите на страницу Выбор подключаемых модулей.
В раскрывающемся списке Текущий подключаемый модуль управления версиями выберите Visual Studio Team Foundation Server.
Нажмите кнопку ОК.

Добавьте проект в систему управления версиями

При создании проектов можно добавить их в систему управления версиями и управлять ими с помощью Team Foundation (подсистема контроля версий). При первом добавлении проекта в систему управления версиями в Team Foundation (подсистема контроля версий) создается рабочая область. Рабочая область — это клиентская копия файлов и папок с сервера Team Foundation. При добавлении, изменении, удалении, перемещении, переименовании и прочих изменениях любого элементы, находящегося в системе управления версиями, изменения происходят только в клиентской рабочей области. Они отслеживаются как ожидающие изменения в рабочей области на локальном компьютере.

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

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

Создание нового решения и проекта

В меню Файл выберите Создать и выберите Проект.
В диалоговом окне Создание проекта в области Тип проекта выберите Visual C#.
В области справа выберите Приложение Windows Forms.
В поле Имя введите MyWindowsApp, затем введите путь в поле Расположение.
Установите флажок Добавить в систему управления версиями и нажмите кнопку ОК.
В окне Добавить в систему управления версиями выберите командный проект, который нужно использовать.
Нажмите кнопку ОК.

Также можно добавлять решения и проекты с помощью командной строки и меню Visual Studio. Однако при добавлении проектов и решений таким образом они не связываются. Связывание обеспечивает функциональность управления версиями. В обозревателе решений ряд значков указывает состояние решения в системе управления версиями. Дополнительные сведения см. в разделах Практическое руководство. Выполнение и отмена привязки проектов и решений, Команда "add" и Практическое руководство. Добавление в систему управления версиям файлов и папок, не относящихся к проекту или решению.

Окно ожидающих изменений

В окне Ожидающие изменения содержатся сведения о состоянии ожидающих изменений в вашей рабочей области. Это окно можно использовать для отслеживания сведений, связанных с изменениями, таких как соответствующие рабочие элементы и примечания при возврате. Чтобы открыть окно Ожидающие изменения, используйте меню Вид. Дополнительные сведения см. в разделе Работа с окнами "Возврат" и "Ожидающие изменения".

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

Затем следует использовать окно Ожидающие изменения для возврата новых файлов решения в систему управления версиями.

Для возврата всех ожидающих изменений в систему управления версиями

В меню Построение щелкните Построить решение, чтобы убедиться в отсутствии ошибок в сборке.
Если окно Ожидающие изменения не открыто, в меню Вид выберите Другие окна, затем Ожидающие изменения.

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

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

Изменение проекта, добавленного в систему управления версиями

Управление версиями является составной частью процесса разработки в Visual Studio. Например, при добавлении файла в проект, находящийся в системе управления версиями, в Visual Studio файл проекта автоматически извлекается и обновляется.

При добавлении файла в проект, находящийся в системе управления версиями, в Visual Studio предполагается, то вы собираетесь каким-либо образом изменить файл, а затем сделать его доступным для коллег. Поэтому добавленные файлы не возвращаются на сервер автоматически. Они обрабатываются как ожидающие добавления. Когда пользователь явным образом возвращает на сервер все сделанные изменения, на сервере создается новый набор изменений.

Чтобы добавить файл в проект, находящийся в системе управления версиями

В обозревателе решений щелкните правой кнопкой, щелкните Добавить и выберите Класс.
В диалоговом окне Добавление нового элемента щелкните Добавить, чтобы добавить в проект класс Class1.cs.

Файл Class1.cs появится вместе с другими файлами проекта в окне Ожидающие изменения, в поле Изменение этого файла будет указан тип Добавление. В обозревателе решений значок проекта изменится с синего замка на красную галочку. Это означает, что файл проекта извлечен. Обратите внимание, что рядом с именем файла Class1.cs будет отображен знак плюса (+). Это означает ожидающее добавление.

Если пользователь решит изменить файл проекта, возвращенный на сервер, этот файл будет автоматически извлечен с сервера.

Изменение существующего файла в проекте с управлением версиями

В обозревателе решений в папке "Свойства" дважды щелкните AssemblyInfo.cs.
В редакторе кода добавьте в файл новую директиву, например using System.IO.Ports;.

Обратите внимание, что система Team Foundation автоматически извлекает файл AssemblyInfo.cs, как только вы начнете его редактировать. В обозревателе решений значок этого файла изменится на галочку. Система добавляет файл в список файлов исходного кода в окне Ожидающие изменения.

Синхронизация рабочей области с сервером

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

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

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

Верните ожидающие изменения на сервер

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

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

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

Вернуть ожидающие изменения на сервер можно следующими способами.

С помощью вложенного меню Управление версиями в меню Файл.
Щелкните правой кнопкой мыши извлеченный файл в обозревателе решений или в обозревателе управления исходным кодом.
В окне Ожидающие изменения щелкните Вернуть.

Для возврата всех ожидающих изменений на сервер

В меню Вид выберите "Другие окна" и щелкните Ожидающие изменения.
В окне Ожидающие изменения введите примечание в поле Примечание.

Например, введите "добавлено с помощью директивы" и, чтобы указать причину, "для поддержки вызовов в класс Directory".
Откройте Рабочие элементы и выберите все рабочие элементы, относящиеся к ожидающим изменениям.

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

Откройте Примечания при возврате и добавьте примечания при возврате для ролей Проверяющий кода, Проверяющий безопасности и Проверяющий производительности.

Примечание.
Администратор может настроить обязательность примечаний при возврате. Их будет необходимо заполнять при возврате. Затененный фон означает, что поля являются обязательными.

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

Щелкните Вернуть.

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

Администратор Team Foundation Server может назначить командному проекту набор настраиваемых политик возврата, чтобы обеспечить соответствие всех возвратов определенным требованиям.

Члены группы могут создавать рабочие элементы для отслеживания дефектов продуктов или запросы на новые компоненты. Они могут связать рабочие элементы с определенным проектом. При завершении работы над рабочим элементом его можно связать с изменениями исходного кода, пометив его нужным образом в области Рабочие элементы окна Ожидающие изменения. При связывании рабочих элементов с изменениями исходного кода обеспечивается четкое отслеживание состояния работы.

И наконец, вы и ваши коллеги могут добавлять к каждому возврату полезные заметки и примечания. Шаблон процесса, использованный при создании командного проекта, определяет форму и содержание примечаний при возврате. Администратор Team Foundation Server может настроить шаблон для вашей группы. Можно назвать следующие категории примечаний при возврате влияние на производительность, требование к документации, инструкции по тестированию и инструкции по построению.

Процесс возврата

При нажатии на кнопку Вернуть система собирает в один пакет все выбранные файлы исходного кода, примечания при возврате и рабочие элементы, указанные в окне "Ожидающиее изменения". Затем Team Foundation (подсистема контроля версий) отправляет пакет на сервер Team Foundation в качестве нового набора изменений. Набор изменений — это набор версий файлов, примечаний при возврате, связанных рабочих элементов и метаданных управления версиями, хранящийся на сервере как одно целое. Дополнительные сведения см. в разделе Работа с наборами изменений системы управления версиями.

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

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

И наконец, Team Foundation (подсистема контроля версий) отправляет по электронной почте уведомления всем членам группы, для которых настроено получение уведомлений о возвратах.

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

После выполнения этого руководства можно ознакомиться с расширенными функциями Team Foundation (подсистема контроля версий). Дополнительные сведения см. в разделе Пошаговое руководство. Дополнительные функциональные возможности системы управления версиями. В данном пошаговом руководстве показано, как разветвлять, объединять и применять метки к элементам в системе управления версиями.

См. также

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