Вопросы и ответы: система управления исходным кодом и версиями TFS

Как управлять двоичными файлами, используемыми в нескольких проектах?

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

Возможны следующие варианты хранения двоичных файлов:

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

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

• Main - контейнер всех ресурсов, необходимых для выпуска ПО.
  • Source - контейнер для всего, что нужно для сборки.
    • Code - контейнер для исходного кода.
    • Shared Code - контейнер для исходного кода, заимствованного из других проектов.
    • Unit Tests - контейнер для модульных тестов.
    • Lib - контейнер для двоичных зависимостей.
  • Docs - контейнер для документации, поставляющейся с продуктом.
  • Installer - контейнер для исходного кода и двоичных файлов программы установки.
  • Builds - контейнер для сценариев сборки.
  • Tests - контейнер, содержащий результаты тестирования.

Дополнительные ресурсы

• Дополнительную информацию о ссылках на проект вы найдете в статье "Project References" по адресу http://msdn2.microsoft.com/en-us/library/ ez524kew(VS.80).aspx.
• Дополнительную информацию о ветвлении вы найдете в статье "How to: Branch Files and Folders" по адресу http://msdn2.microsoft.com/en-us/ library/ms181425(VS.80).aspx.
• Дополнительную информацию о рабочих областях вы найдете по адресу http://msdn2.microsoft.com/en-us/library/ms181383(VS.80).aspx.

Как организовать дерево исходного кода?

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

• Main - контейнер всех ресурсов, необходимых для выпуска ПО.
  • Source - контейнер для всего, что нужно для сборки.
    • Code - контейнер для исходного кода.
    • Shared Code - контейнер для исходного кода, заимствованного из других проектов.
    • Unit Tests - контейнер для модульных тестов.
    • Lib - контейнер для двоичных зависимостей.
  • Docs - контейнер для документации, поставляющейся с продуктом.
  • Installer - контейнер для исходного кода и двоичных файлов программы установки.
  • Builds - контейнер для сценариев сборки.
  • Tests - контейнер, содержащий результаты тестирования.

Все ветви, создаваемые из Main, повлекут за собой копирование структуры папок и файлов Main в новую ветвь.

Дополнительные ресурсы

• Дополнительную информацию о создании рабочей области вы найдете в статье "How to: Create a Workspace" по адресу http://msdn2.microsoft.com/en-us/library/ms181384(VS.80).aspx.

Отложенные правки

• Что такое отложенные правки?
• Что такое набор отложенных правок?
• Как используются отложенные правки?
• Как использовать отложенные правки для архивации?
• Для чего нужно извлекать набор отложенных правок?

Что такое отложенные правки?

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

Дополнительные ресурсы

• Дополнительную информацию о сохранении отложенных правок на сервере вы найдете в статье "How to: Shelve and Unshelve Pending Changes" по адресу http://msdn2.microsoft.com/en-us/library/ms181404(VS.80).aspx.

Что такое набор отложенных правок?

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

Дополнительные ресурсы

• Дополнительную информацию о сохранении отложенных правок на сервере вы найдете в статье "How to: Shelve and Unshelve Pending Changes" по адресу http://msdn2.microsoft.com/en-us/library/ms181404(VS.80).aspx.

Как используются отложенные правки?

Существует несколько общих сценариев использования отложенных правок:

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

Дополнительные ресурсы

• Дополнительную информацию о сохранении отложенных правок на сервере вы найдете в статье "How to: Shelve and Unshelve Pending Changes" по адресу http://msdn2.microsoft.com/en-us/library/ms181404(VS.80).aspx.

Как использовать отложенные правки для архивации?

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

Дополнительные ресурсы

• Дополнительную информацию о сохранении отложенных правок на сервере вы найдете в статье "How to: Shelve and Unshelve Pending Changes" по адресу http://msdn2.microsoft.com/en-us/library/ms181404(VS.80).aspx.

Для чего нужно извлекать набор отложенных правок?

Типичные причины извлечения набора отложенных правок таковы:

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

Дополнительные ресурсы

• Дополнительную информацию о сохранении отложенных правок на сервере вы найдете в статье "How to: Shelve and Unshelve Pending Changes" по адресу http://msdn2.microsoft.com/en-us/library/ms181404(VS.80).aspx.

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

• Дополнительные сведения о системе управления исходным кодом TFS вы найдете в статье "Team Foundation Source Control" по адресу http://msdn2.microsoft.com/en-us/library/ms181237(VS.80).aspx.