Работаем с программой контроля версий правильно

Полная версия файла расположена в репозитории.

YAK S.D.

Saturday, January 08, 2011

Оглавление

Установка.

Создание сервера для репозитория.

Первое обновление \ Checkout.

Обновление \ Update.

Добавление нового файла или папки \ Add.

Удаление файлов и папок из репозитория \ Remove.

Загрузка изменений в репозиторий \ Commit.

Устранение конфликтов.

Откат.

Стрельба по проблемам \ Troubleshoot.

Установка

Рекомендуемый клиент для контроля версий – TortoiseSVN. Этот продукт бесплатный. Программу можно скачать с оффициального сайта: http://tortoisesvn.net/downloads.html.

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

Создание сервера для репозитория

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

Для создания сервера для репозитория , необходимо создать папку в удобном месте.

Заходим в папку и жмем правой кнопкой на пустом месте для вызова меню. Далее создаем репозиторий нажатием Create Repository Here.

И всё!

Ничего не трогайте тут !

Первое обновление \ Checkout

Создайте папку, где хотите разместить свою локальную копию репозитория.

Зайдите в папку и нажмите SVN Checkout.

Введите путь к серверу репозитория (это всегда URL. Например, http:// или file://) и путь к локальной папке для загрузки (автоматически вставляется текущая папка).

Остальное оставте без изменений.

Если все пути указаны верно, то загрузка произойдет успешно.

На рисунке ниже загружен пустой репозиторий (ну, потому что там было пустоJ).

Не удаляйте и не изменяйте папки с именами “.svn” и их сожержимое.

Обновление \ Update

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

Всегда обновляйте копию репозитория перед тем, как внести в репозиторий изменения!

Всегда регулярно обновляйте свою копию репозитория!

Добавление нового файла или папки \ Add

Чтобы добавить файл или папку в репозиторий, сначала обновите свой репозиторий.

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

Выделите нужные файлы и/или папки и нажмите правой кнопкой, далее Add.

Далее подтвердите выбор.

Если всё сделано успешно.

Файлы и папки добавлены. Осталось их загрузить в репозиторий. Смотрте раздел Commit.

Удаление файлов и папок из репозитория \ Remove

Выберите объект(ы) и нажмите правой кнопокой Delete.

Если всё сделано правильно.

Не удаляйте объекты вручную!

Файлы и папки удалены. Осталось их удалить из репозитория. Смотрте раздел Commit.

Объекты удалятся после следующего выполнения команды Commit.

Загрузка изменений в репозиторий \ Commit

Изменениями считаются:

Переимерование
Добавление
Удаление
Редактирование
Перемещение

Как только было произведено изменение, данный файл и все папки выше по иерархии помечаются значком . Удаленные и добавленные – соответственно и .

Неизмененные файлы и папки помечаются значком .

Объекты, не принадлежащие репозиторию помечаются значком .

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

Заполните описание изменений. Кратко и лаконично. Но не меньше 3х слов.

Выберите файлы, изменения которых хотите загрузить в репозиторий.

Не рекомендуется добавлять файлы без версий (text status: non-versioned).

Например, вот так:

Ждем некоторое время...

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

Устранение конфликтов

Например, после обновления у вас возникли конфикты. Это выглядит так.

Конфликты отображаются таким значком.

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

Откат

Стрельба по проблемам \ Troubleshoot