Выпуск

Чтобы сделать выпуск Weston, следуйте этим шагам.

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

    ninja -C build/ test

1. Убедитесь, что зависимости версий wayland и wayland-protocols корректны, а также что wayland-protocols выпустил версию с необходимыми обновлениями протоколов.

2. Обновите первую строчку файла meson.build до нужной версии.

   Если ABI был нарушен, убедитесь, что libweston_major был увеличен с момента последнего выпуска.

   Затем сделайте коммит ваших изменений:

   RELEASE_NUMBER="x.y.z"
   RELEASE_NAME="[alpha|beta|RC1|RC2|официальный|точечный]"
   git status
   git commit meson.build -m "build: bump to version $RELEASE_NUMBER for the $RELEASE_NAME release"
   git push

3. Запустите скрипт release.sh, чтобы создать tarballы, подписывать и загружать их, а также создать шаблон объявления о выпуске. Этот скрипт можно получить из репозитория Wayland:

   https://gitlab.freedesktop.org/wayland/wayland/-/blob/main/release.sh

4. Составьте объявление о выпуске. Скрипт создаст файл weston-x.y.z.announce со списком изменений и тегами. Предварите это человекочитаемым списком наиболее значимых изменений. Для выпусков в формате x.y.0 укажите график для выпуска x.y+1.0.

5. Подпишите электронное письмо о выпуске с помощью PGP и отправьте его на адрес wayland-devel@lists.freedesktop.org.

6. Обновите файл releases.html на сайте wayland.freedesktop.org ссылками на tarballы и URL электронного письма о выпуске. После удовлетворения всех требований выполните команды:

   git add releases.html releases/weston-${RELEASE_NUMBER}.tar.xz*
   git commit -m "releases: add weston ${RELEASE_NUMBER} release"
   git push

Для выпусков в формате x.y.0 также создайте серию выпусков x.y ветки. Ветка x.y предназначена для исправления ошибок и консервативных изменений в выпуске x.y.0, и именно отсюда создаются выпуски x.y.z. Создание ветки x.y открывает возможность для новых разработок в ветке master и позволяет новому развитию продолжаться. Мы делали это как после выпуска x.y.0 (чтобы сосредоточиться на исправлении ошибок перед выпуском x.y.1), так и до выпуска x.y.0 (как мы сделали для выпуска 1.5.0, чтобы рано освободить master для новых разработок).

git branch x.y [sha]
git push origin x.y

Ветка master должна иметь версию meson.build как минимум x.y.90, где x.y — самая последняя стабильная ветка. Версия файла meson.build в стабильной ветке просто отражает то, что было недавно выпущено из этой ветки.

Для стабильных веток мы сначала коммитим исправления в ветку master, а затем используем команду git cherry-pick -x, чтобы применить эти изменения обратно в стабильную ветку.