Сборки на GitHub: как устроен список релизов

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

Что где лежит

Оба лежат в одной учётной записи проекта — https://github.com/Happ-proxy. Настольные сборки нужны нам: их страница релизов — https://github.com/Happ-proxy/happ-desktop/releases.

Как читать страницу релизов

1. Найдите верхнюю запись с пометкой Latest

   Это последний стабильный выпуск. Записи ниже — предыдущие версии, они остаются доступными и никуда не пропадают.

2. Отличите бета-сборку

   Предварительные выпуски помечаются как Pre-release. Они могут стоять выше стабильной по дате, но пометку Latest не получают. Брать их стоит только осознанно.

3. Раскройте список файлов

   Под описанием выпуска прячется список Assets. Там и лежат установщики: setup-Happ.x64.exe, Happ.macOS.universal.dmg, пакеты для Linux.

   SHOT-U01

4. Скачайте один файл

   Скачивать нужно ровно один — под вашу систему. Исходники (Source code) вам не нужны: это не программа, а её код.

Что делать, если страница релизов не открывается

Так бывает: сервис репозиториев временами недоступен из некоторых сетей. Первое, что стоит попробовать, — открыть её с телефона по мобильному интернету и скачать файл туда, а потом перенести на компьютер.

Второй путь — страница проекта: там есть переходы к тем же файлам, и она обычно открывается там, где репозиторий не открывается. Третьего пути мы не предлагаем: скачивать сборку с посторонних сайтов ради удобства не стоит (почему).

Зачем открывать релизы вообще

• Нужна свежая версия. В магазинах обновления проходят проверку и приезжают позже.
• Нужна предыдущая версия. После обновления что-то сломалось — можно вернуться (откат).
• Нужен файл под нестандартную систему. Linux и ARM живут только в релизах.
• Нужно убедиться в подлинности. Релизы проекта — это первоисточник, всё остальное пересказ (где скачать).

Что написано в описании выпуска

Над списком файлов у каждого выпуска есть текст: что изменилось. Читать его полезно ровно в двух случаях. Первый — когда вы обновляетесь после долгого перерыва и хотите понять, не поменялось ли что-то в настройках. Второй — когда после обновления что-то сломалось: описание подскажет, где искать.

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

Как понять, какой файл ваш

Разбор имени файла по частям — на отдельной странице: там объясняется, что означает каждый кусок и почему в имени нет слова Utility.

Почему GitHub, а не сайт

Файл, выложенный в релизах, лежит там, где его выложил автор, и никем по дороге не подменяется. Любой промежуточный сайт — это ещё одно звено, которому нужно верить: он может отдать старую версию, свою пересборку или установщик с довеском.

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

Единственное, чего в релизах нет, — удобства для новичка: страница выглядит по-инженерному и пугает списками. Разобравшись один раз, вы получаете самый короткий и самый честный путь к файлу (что за файл).

Чего на странице релизов нет

Там нет ссылок-подписок, ключей и «бесплатных конфигураций»: репозиторий раздаёт программу, а не доступ. Если в комментариях или в чьём-то форке попадаются такие ссылки — это чужие раздачи, и жить они обычно несколько дней (про бесплатные ключи).