Введение

В Comindware Platform предусмотрены импорт и экспорт версий приложения посредством системы контроля версий Git.

Для работы этой функции требуется настроить подключение к репозиторию. См. статью «Управление версиями через Git. Настройка подключения».

Переход к странице управления версиями через Git

1. На странице «Администрирование» приложения выберите пункт «Управление версиями» ‌.

2. Если отображается страница ручного управления версиями, нажмите заголовок «Ручное управление версиями» и в раскрывающемся меню выберите пункт «Управление версиями через Git».

   

3. Отобразится страница «Управление версиями через Git».

4. Выполните необходимую операцию:

   • Инициализация — выбор репозитория, настройка аккаунта для создания коммитов и выбор или создание ветви в репозитории для управления версиями приложения.
   • Импортировать из Git — импорт последней версии приложения из ветви, выбранной при инициализации репозитория Git.
   • Экспортировать в Git — экспорт текущей версии приложения ветвь, выбранную при инициализации репозитория Git.

   

Инициализация репозитория

Чтобы использовать функцию управления версиями через Git, сначала инициализируйте репозиторий.

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

Перед этим необходимо настроить подключение к репозиторию.

1. Нажмите кнопку «Инициализация» на странице «Управление версиями через Git».
2. В окне «Инициализация репозитория» выберите репозиторий Git — одно из настроенных подключений к Git.

3. Нажмите кнопку «Далее».

   

4. Отобразится окно «Настройка аккаунта Git».

Настройка аккаунта Git

При настройке аккаунта Git укажите учётные данные пользователя, от имени которого будут создаваться коммиты (версии приложения) в репозитории.

1. В окне «Настройка аккаунта Git» заполните перечисленные ниже поля:

   • Имя пользователя — укажите логин для подключения к репозиторию.
   • Пароль — укажите пароль для подключения к репозиторию.
   • Ф. И. О — укажите имя, которое будет отображаться в качестве имени автора коммитов.
   • Адрес эл. почты — укажите адрес электронной почты, который храниться в репозитории в качестве адреса автора коммитов.

2. Нажмите кнопку «Подключиться к Git».

   

3. Должно отобразиться сообщение «Соединение установлено» на зеленом фоне в правом нижнем углу страницы.

   

4. Нажмите кнопку «Далее».

5. Отобразится окно «Ветви в репозитории Git».

Использование ветвей в репозитории Git

В окне «Ветви в репозитории Git» отображаются список ветвей репозитория и список версий приложения хранящихся в выбранной ветви.

1. В раскрывающемся списке «Ветвь», выберите ветвь репозитория Git для импорта и экспорта версий приложения.

2. Отобразится список хранящихся в ветви версий приложения (коммитов) со следующими сведениями:

   • Описание — автоматически сгенерированное наименование версии приложения, хранящейся в репозитории.
   • Дата — дата сохранения версии приложения в репозитории.
   • Автор — пользователь, под именем которого была сохранена версия приложения.
   • Коммит — уникальный идентификатор версии приложения в репозитории.

3. Нажмите кнопку «Создать новую ветвь», чтобы создать в репозитории Git новую ветвь для хранения версий приложения.

4. Нажмите кнопку «Импортировать из Git», чтобы загрузить выбранную версию приложения из выбранной ветви репозитория.
5. Нажмите кнопку «Экспортировать в Git», чтобы сохранить последнюю версию приложения в выбранную ветвь репозитория.

6. Нажмите кнопку «Назад», если требуется вернуться к предыдущему шагу инициализации репозитория.

   

Создание новой ветви в репозитории Git

1. Нажмите кнопку «Создать новую ветвь» в окне «Ветви в репозитории Git».

2. Отобразится окно «Новая ветвь в репозитории Git».

   

3. Введите название новой ветви — оно может содержать латинские буквы (A–Z, a–z) и цифры (0–9).

4. Нажмите кнопку «Сохранить».

Экспорт приложения в репозиторий Git

При экспорте в репозиторий Git в репозитории будет создан коммит с текущей версией приложения из Comindware Platform.

1. Перейдите на страницу «Управление версиями через Git».

   • Чтобы экспортировать текущую версию приложения в ветвь, выбранную при инициализации репозитория, нажмите кнопку «Экспортировать в Git».

   • Чтобы экспортировать текущую версию приложения в конкретную ветвь репозитория:

     1. Нажмите кнопку «Инициализация».
     2. Отобразится окно «Инициализация репозитория».
     3. Пройдите шаги инициализации репозитория до шага «Ветви в репозитории Git».
     4. Выберите ветвь приложения.
     5. Нажмите кнопку «Экспортировать в Git».

2. Отобразится окно «Экспортировать в Git».

3. Нажмите кнопку «Выполнить».

   

4. После успешного экспорта версии приложения в репозиторий должно отобразиться сообщение «Экспорт в Git выполнен» на зелёном фоне в правом нижнем углу страницы.

   

5. Если экспорт не удалось выполнить, устраните обнаруженные проблемы в приложении и экспортируйте его заново.

Импорт приложения из репозитория Git

1. Перейдите на страницу «Управление версиями через Git».

   • Чтобы импортировать последнюю версию приложения из  ветви, выбранной при инициализации репозитория, нажмите кнопку «Импортировать из Git».

   • Чтобы импортировать конкретную версию приложения из конкретной ветви репозитория:

     1. Нажмите кнопку «Инициализация».
     2. Пройдите шаги инициализации репозитория до шага «Ветви в репозитории Git».
     3. Выберите ветвь и версию приложения.
     4. Нажмите кнопку «Импортировать из Git».

2. Отобразится окно «Импортировать из Git».

3. Нажмите кнопку «Выполнить».

   

4. После импорта версии приложения в репозиторий должно отобразиться сообщение «Импорт выполнен» на зелёном фоне в правом нижнем углу страницы.

   

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