| name | release-jarvis |
| description | Выпустить новый релиз Jarvis (macOS, Tauri) — поднять версию, собрать ad-hoc-подписанный .dmg через GitHub Actions (без Apple Developer), опубликовать draft-релиз и обеспечить работу авто-обновления. Использовать при словах «катить релиз», «новый релиз», «зарелизь», «bump версию», «выпусти обновление». |
Релиз Jarvis
Jarvis — это Tauri-приложение под macOS. Релиз = тег vX.Y.Z → GitHub Actions
(.github/workflows/release.yml) собирает ad-hoc-подписанный .dmg (без
Apple Developer) + артефакты авто-апдейтера и создаёт draft-релиз.
Публикация — вручную.
TL;DR (happy path)
- Версия: реши номер по semver (см. «Политика версий»).
- Подними версию в 4 файлах через PR (прямой пуш в master закрыт protection):
package.json, src-tauri/tauri.conf.json, src-tauri/Cargo.toml,
src-tauri/Cargo.lock (секция [[package]] name = "jarvis").
- Смержи PR (squash), дождавшись чека
fmt · clippy · test.
- Поставь тег на свежий master и запушь:
git fetch origin
git tag vX.Y.Z origin/master
git push origin vX.Y.Z
- Тег запускает
release.yml. Дождись completed/success:
gh run list --workflow=release.yml --limit 1
- Проверь draft-релиз и опубликуй:
gh release view vX.Y.Z --json isDraft,assets
gh release edit vX.Y.Z --draft=false
Предусловия и подводные камни
- Workflow может быть выключен.
release.yml бывает в состоянии
disabled_manually — тогда пуш тега ничего не запустит. Проверь и включи:
gh api repos/Sergey-Chernyshev/jarvis/actions/workflows --jq '.workflows[]|select(.path|test("release"))|.state'
gh workflow enable release.yml
- Сборка только aarch64 (Apple Silicon). В
release.yml стоит
--target aarch64-apple-darwin. НЕ ставить universal-apple-darwin: у проекта
второй бинарь jarvis-setup ([[bin]]), который tauri не лило для universal →
бандл падает с Failed to copy binary ... jarvis-setup does not exist.
Intel-сборка = отдельная задача (нужно отдельно лило все бинари).
- Подпись — ad-hoc, без Apple Developer. В
tauri.conf.json
macOS.signingIdentity: "-"; Apple-сертификата у проекта НЕТ (ни в CI, ни
локально). Workflow НЕ должен требовать APPLE_* секретов — их не существует,
сборка упадёт на codesign. Минус: Gatekeeper при первом запуске скажет
«неустановленный разработчик» → пользователь ПКМ→Открыть. Нотаризации нет.
- Ключ апдейтера (независим от Apple): секрет
TAURI_SIGNING_PRIVATE_KEY
должен соответствовать plugins.updater.pubkey в tauri.conf.json. Уже
настроено (ключ сгенерён tauri signer generate, пароль пустой). Иначе подпись
latest.json не сойдётся и клиенты не примут апдейт. Перегенерация:
node_modules/.bin/tauri signer generate -w /tmp/k -p "" --ci, затем
gh secret set TAURI_SIGNING_PRIVATE_KEY < /tmp/k и обнови pubkey в конфиге.
- Endpoint апдейтера в
tauri.conf.json обязан указывать на реальный репо:
https://github.com/Sergey-Chernyshev/jarvis/releases/latest/download/latest.json
(исторически был placeholder OWNER/REPO — из-за него апдейты не резолвились).
- Branch protection строгий: требуется чек
fmt · clippy · test И ветка
должна быть up-to-date с master. Если PR «BEHIND» — обнови серверным мержем,
не локальным ребейзом (репо параллельно ресетят, см. ниже):
gh api repos/Sergey-Chernyshev/jarvis/pulls/<N>/update-branch -X PUT
Затем дождись перепрогона CI и мержи. Чек review (Claude Code Review) часто
падает транзиентно и не блокирует мерж (не required).
- git-churn в рабочем каталоге. Каталог иногда параллельно ресетят на
origin/master (мерж чужих PR). Не держи важную работу только в локальной
ветке — пушь в origin сразу; при многошаговых правках якори тегом. См.
память jarvis-shared-workdir-git-churn.
Если сборка упала
- Посмотри причину:
gh run view <run-id> --log-failed | tail -40
- Почини на master через PR.
- Перенеси тег на исправленный коммит и перезапусти сборку:
git push origin :refs/tags/vX.Y.Z
git fetch origin
git tag -f vX.Y.Z origin/master
git push origin vX.Y.Z
(Пока релиз не опубликован, переиспользовать тот же тег безопасно.)
Что делает workflow
tauri-apps/tauri-action с releaseDraft: true, includeUpdaterJson: true,
createUpdaterArtifacts: true:
- собирает
jarvis (фичи wakeword-ort,whisper-native,stt-vad),
- ad-hoc подписывает
.app (без Apple/нотаризации), пакует .dmg,
- генерит
latest.json (для авто-апдейтера) с подписью,
- создаёт draft-релиз «Jarvis vX.Y.Z» с ассетами.
Авто-обновление в приложении
- Клиент проверяет
plugins.updater.endpoints (latest.json) на старте; при свежей
версии скачивает и ставит. Реализация — src-tauri/src/main.rs (updater).
- Чтобы апдейт долетел до пользователя, у него ДОЛЖНА стоять версия с верным
endpoint+pubkey. Пользователи старых версий с placeholder-endpoint обновляются
один раз вручную (скачать новый .dmg).
- После публикации релиза
latest/download/latest.json начинает отдавать новую
версию — клиенты подхватят на следующем запуске.
Политика версий и совместимости
См. docs/release/versioning-and-migration.md (полная политика). Кратко:
- Semver: patch — фиксы; minor — фичи; major — ломающие изменения.
- Данные пользователя в
~/.jarvis/ (вне бандла) — апдейт их НЕ трогает.
НИКОГДА не хранить пользовательские данные внутри .app.
settings.json: загрузка мержит дефолты → добавление полей безопасно
(всегда #[serde(default)]). Переименование/удаление/смена смысла поля —
только через миграцию (schemaVersion + migrate-шаг в settings.rs).- Не ломать: не менять смысл существующих полей; новое поведение — за
дефолтным флагом настройки; парс-ошибки state/history → тихий скип (уже так).
Чек-лист публикации
