Релизы

С момента выхода Homebrew 1.0.0 большинству пользователей Homebrew (тем, кто не запускал dev-cmd или не установил HOMEBREW_DEVELOPER=1, что составляет ~99,9% по данным аналитики) для получения новых версий Homebrew требуются теги в репозитории Homebrew/brew. Существует несколько шагов по созданию новой версии Homebrew:

1. Проверьте запросы на добавление изменений в Homebrew/brew, задачи, задачи в Homebrew/homebrew-core и Homebrew/discussions (форум), чтобы убедиться, что нет ничего срочного, что необходимо исправить или объединить перед следующим релизом. В случае необходимости, исправьте и объедините эти изменения.
2. Убедитесь, что за последние пару часов (желательно 4 часа) не было внесено изменений в код, что по крайней мере одна работа по CI pull запроса в Homebrew/homebrew-core завершилась успешно, проверьте статус работы CI Homebrew/brew master (т.е. основные задачи зелёные или зелёные после перезапуска), и что вы уверены, что на текущей master, ветке нет существенных регрессий.
3. Запустите brew release для создания нового черновика выпуска. Для повышения версии до основной или малой используйте --major или --minor соответственно.
4. Опубликуйте черновик выпуска на GitHub.

Если это выпуск основной или малой версии (например, X.0.0 или X.Y.0), то есть несколько дополнительных шагов:

1. Перед созданием тега необходимо удалить все odisabled код, привести любой odeprecated код в odisabled состояние, раскомментировать любой # odeprecated код и добавить любые новые odeprecations , которые необходимы. Также удалите любые определения аргументов команд, передающие replacement: ....
2. Напишите пост о релизе в блоге на https://brew.sh, например, brew.sh#319. Этот пост должен использовать вывод brew release [--major|--minor] в качестве входных данных, но с изменённой формулировкой для большей читабельности и объяснением не только того, что изменилось, но и почему.
3. После выпуска релиза и публикации поста в блоге опубликуйте твит с этим постом от @MacHomebrew Twitter account или опубликуйте его сами и ретвитните его с аккаунтом @MacHomebrew Twitter (кредиты находятся в 1Password).
4. Подумайте о том, стоит ли опубликовать его в других источниках, например, на Hacker News или Reddit.
   • Плюсы: расширение охвата и получение отзывов от пользователей.
   • Минусы: распространены негативные комментарии, и люди используют это как возможность пожаловаться на Homebrew (независимо от их использования).

Пожалуйста, не создавайте релиз вручную на основе более старых коммитов на master ветке. Очень сложно судить о том, были ли они достаточно протестированы пользователями или могут ли они вызвать негативные последствия в текущем состоянии Homebrew/homebrew-core. Если требуется новая ветка в ближайшее время, но некоторые вещи на master ещё не могут быть выпущены (например, новые устаревания, и вы хотите выпустить патч-релиз), верните соответствующие PR, следуйте описанной выше процедуре, а затем верните отменённые PR, чтобы повторно применить их на master.