Выпуск Oleafly

Релизы Oleafly проходят два отдельных этапа. Тег версии собирает и проверяет черновик. Мейнтейнер публикует тот же черновик отдельным запуском рабочего процесса.

Отправка изменений в main запускает CI, но не создаёт релиз.

Сборка черновика

Начните с актуальной ветки main и зелёным CI.

git switch main
git pull --ff-only
./scripts/bump-version.sh 0.3.6
git commit -am "chore: release v0.3.6"
git push origin main
git tag v0.3.6
git push origin v0.3.6

Тег запускает .github/workflows/release.yml. Он собирает эти целевые платформы:

Платформа	Установщики
macOS Apple Silicon	.dmg
Windows x64	.msi и -setup.exe
Linux x64	.AppImage и .deb
Linux ARM64	.AppImage и .deb

Каждая платформа загружает и проверяет свои закреплённые сайдкары компиляторов. Затем рабочий процесс объединяет все четыре фрагмента обновления в один latest.json. Черновик считается готовым, только когда присутствуют все требуемые установщики и записи обновления.

Проверка черновика

Откройте черновик на странице релизов GitHub (откроется в новой вкладке). Проверьте примечания к релизу, имена установщиков, контрольные суммы, подписи и latest.json. Не публикуйте неполный черновик.

Публикация

Откройте Actions → Release → Run workflow. Введите тот же тег и выберите Publish the release.

Запуск публикации повторяет сборку и проверки артефактов. Он также выполняет живые контрактные тесты против Anthropic и Google на релиз-кандидате. Последнее задание отказывается публиковать, если отсутствует хотя бы одна поддерживаемая платформа или полная лента обновления.

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

Номера версий

Oleafly следует семантическому версионированию:

• Патч, например с 0.3.5 до 0.3.6, для совместимых исправлений.
• Минорная, например с 0.3.5 до 0.4.0, для совместимых функций.
• Мажорная, например с 0.3.5 до 1.0.0, для ломающих изменений или первого стабильного релиза.

Важные проверки

• Тег должен соответствовать package.json, src-tauri/tauri.conf.json, src-tauri/Cargo.toml и src-tauri/Cargo.lock. Используйте scripts/bump-version.sh вместо раздельного редактирования.
• Примечания к релизу берутся из раздела соответствующей версии в CHANGELOG.md.
• Не используйте опубликованный тег повторно. Для неудачного черновика исправьте ветку и создайте новую версию, если нет явной причины заменить неопубликованный тег.
• Подписывание и нотаризация macOS используют секреты релиза Apple. Windows Authenticode использует Azure Artifact Signing, когда его секреты настроены. Подписи обновления используют отдельный ключ подписывания Tauri.

См. Автообновления о подписывании и откате обновлений. Инструкции по установке для пользователей — в разделе Скачать и установить.