Сначала зафиксируйте последний успешный этап: приложение не видит новую запись, не скачивает архив, отклоняет подпись, не заменяет bundle или уже обновлённая версия не проходит системную проверку. Фраза «macOS блокирует» объединяет разные механизмы. Один тест на чистой поддерживаемой версии macOS с тем же опубликованным архивом сокращает поиск до конкретной границы.
Не советуйте пользователю отключать Gatekeeper, снимать quarantine или запускать неподписанный helper. Такие обходы скрывают дефект цепочки поставки. Исправление выпускают новой корректно подписанной и notarized сборкой, проверяя путь обновления именно со старой публичной версии.
Последний успешный этап определяет владельца ошибки
| Этап | Признак | Следующий артефакт |
|---|---|---|
| appcast/feed | новая версия не находится | URL, XML, version/build и минимальная macOS |
| download | обрыв или HTTP/TLS ошибка | status, Content-Length, hash архива |
| update signature | updater отвергает пакет | EdDSA signature и public key текущей версии |
| extraction/install | архив принят, bundle не заменён | права, helper log, свободное место |
| launch/Gatekeeper | новая app не запускается | codesign/notary assessment и crash report |
Сохраняйте идентификатор попытки обновления и public build number. Не включайте приватный signing key, пароль Keychain или полный домашний путь пользователя в телеметрию.
Подпись архива и подпись приложения решают разные задачи
Framework обновления проверяет, что скачанный архив выпущен владельцем update key. macOS затем проверяет подпись кода внутри приложения и системную политику. Успешная EdDSA-проверка архива не компенсирует повреждённую Developer ID signature, а notarization ticket не подтверждает, что appcast указывает на ожидаемый файл.
release.version=3.8.1
release.build=3810
archive.sha256=...
appcast.length=48219304
appcast.edSignature=...
current_app.public_update_key=...
new_bundle.team_identifier=ABCDE12345
notary_submission_id=...
notary_status=Accepted- Генерировать appcast из финального неизменяемого архива, а не до повторной упаковки.
- Хранить update private key вне репозитория и release-артефактов.
- Проверять сценарий ротации ключа до потери старого signing key.
- Не изменять подписанный bundle после codesign и notarization.
Notarization проверяется до публикации канала
Apple требует подходящую Developer ID signature, Hardened Runtime, secure timestamp и корректные entitlements для современного notarization workflow. Notary service возвращает статус и журнал, а ticket можно прикрепить к дистрибутиву. Принятый запрос не заменяет тест запуска: Apple отдельно рекомендует изучать предупреждения и проверять готовый артефакт.
CI должен останавливать релиз, если notarization не завершилась успешно, ticket не прикрепился там, где это предусмотрено, или проверка финального архива отличается от того, что опубликован в feed. Не переиспользуйте статус предыдущей сборки с тем же маркетинговым номером версии.
Helper и формат пакета влияют на необходимость авторизации
Обычный app bundle и installer package обновляются по-разному. Документация Sparkle отмечает, что package updates требуют пользовательской авторизации и не подходят для полностью тихой установки. Если приложению не нужен специальный installer, архив с app bundle обычно проще. Для sandboxed app и XPC helpers соблюдаются отдельные настройки и подписи.
- Запустить проверку обновлений из старой публичной сборки.
- Подтвердить выбранный item appcast по version/build и OS constraints.
- Сверить длину, hash и подпись скачанного финального файла.
- Проверить установку и relaunch без ручного вмешательства в bundle.
- Оценить уже установленную app системными средствами и выполнить smoke test.
Чистая машина ловит зависимости от среды разработчика
Тестовый Mac не должен иметь development certificates, локальную копию framework или разрешения, выданные во время отладки. Проверьте обновление с двух последних поддерживаемых версий, на Intel и Apple silicon, если обе архитектуры заявлены. Прокси и офлайн-проверку ticket тестируют отдельно, не смешивая с основным happy path.
Релиз готов, когда старая сборка находит ровно нужный update, проверяет архив, устанавливает его разрешённым способом, новая app проходит системную оценку и запускается с сохранёнными пользовательскими данными. В пакет для диагностики входят версии macOS/app/updater, публичный appcast item, hash и обезличенный текст ошибки; приватные ключи и полный архив с пользовательскими данными туда не включаются.