# Сборка обновлений

Обязательно ознакомиться с документацией по обновлениям в курсе для разработчиков.

# Последовательность действий

1. Меняем в install/version.php дату на текущую, номер версии на следующую
2. Коммитим изменения с сообщением «Номер версии»
3. Отмечаем последний коммит с измененным номером версии тегом с номером версии (вида 0.0.1)
4. Пушим изменения на сервер.
5. На портале в группе решения, вкладка Marketplace скачиваем архив обновления
   Архив содержит измененные файлы, сгенерированный updater.php, миграцию таблиц БД
6. Проверяем всё ли правильно сгенерилось в updater.php, при необходимости дополняем его
   • если в репозитории есть код в папке /.updates/.next/, включаем его в обновление и переносим (обязательно с помощью git mv) содержимое /.updates/.next/ в /.updates/<номер_версии>/
7. Заливаем архив обновления в личном кабинете Marketplace (как alpha или beta чтобы его не могли поставить клиенты)
8. Тестируем установку обновления на своей копии старой версии решения (для alpha — с NFR-ключом)
9. При необходимости исправляем обновление одним из следующих способов:
   • новыми коммитами в гит и последующим исправлением обновления (см. #Исправления)
   • внесением правоки в файлы сгенерированного архива обновления (дублируем их коммитами для будущей версии)
   • выпускаем еще одну версию с исправлениями
10. После финальной проверки публикуем стабильную версию обновления:

• меняем статус обновления на стабильное
• скачиваем с портала архив .last_version и загружаем его на форме редактирования решения в личном кабинете Marketplace

# Исправления

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

Важно! Нельзя вносить изменения в версию, которую кто-то уже успел установить.
В таких случаях исправления нужно вносить только в виде новой версии.

Проверить кто устанавливал обновление можно в личном кабинете Marketplace пункт Лог обновлений в контекстном меню решения.

1. Удаляем версию локально

   git tag -d <номер_версии>
   

2. Удаляем версию на сервере (если уже сделали push)

   git push origin master :<номер_версии>
   

3. На вкладке Marketplace на портале нажимаем кнопку Обновить список версий
4. Повторяем обычную последовательность выпуска обновления