Document local Live Activity release and device validation [skip ci]

This commit is contained in:
2026-09-13 11:33:42 +03:00
parent ddd44e8edb
commit fcc66aa328
2 changed files with 80 additions and 9 deletions
+33 -3
View File
@@ -17,7 +17,8 @@
**Статус:** пользователь подтвердил установку через iloader, рабочий пилот с
Windows-агентом и подключение по QR. В 0.4.0 добавлены иконка и обновлённый
интерфейс. Автоматические проверки включают 23 XCTest и Release archive;
интерфейс, в 0.5.0 — локальная Live Activity и Dynamic Island. CI собирает
приложение и расширение WidgetKit, выполняет XCTest и Release archive;
полная проверка устойчивости на физических устройствах остаётся в `PLAN.md`.
## Сборка на Mac
@@ -67,8 +68,8 @@ Apple ID и сертификаты для этой проверки не тре
## Установка на iPhone через Sideloadly
Пользователь также подтвердил установку через iloader. Для повторной установки
с новым интерфейсом используйте версию **0.4.0 (build 5)**:
`build/iPhone-0.4.0/MusicBridge-iPhone.ipa`. Выберите этот файл в iloader и
с Live Activity используйте версию **0.5.0 (build 6)**:
`build/iPhone-0.5.0/MusicBridge-iPhone.ipa`. Выберите этот файл в iloader и
подпишите тем же Apple Account, которым установлена первая версия.
В 0.4.0 добавлены иконка, карточка QR, раскрываемые ручные поля, крупная
@@ -105,6 +106,35 @@ Sideloadly (в том числе его функцией автоматичес
[Sideloadly FAQ](https://sideloadly.io/faq) ·
[Apple: режим разработчика](https://developer.apple.com/documentation/Xcode/enabling-developer-mode-on-a-device)
## Live Activity и Dynamic Island
После подключения к ПК и появления трека нажмите под плеером
«Показать на экране блокировки». Та же карточка появится в Dynamic Island
на моделях, где он доступен. Долгое нажатие на Island раскрывает представление;
нажатие на карточку или «Открыть плеер» возвращает в приложение.
Кнопка «Убрать с экрана блокировки» завершает активность. Она также завершается,
когда ПК сообщает об отсутствии медиасессии, доступ отозван или компьютер забыт.
Удалённая пользователем карточка не создаётся снова автоматически.
Это **последний снимок состояния ПК**: название, исполнитель, состояние и прогресс.
В обычном режиме позиция обновляется не чаще раза в пять секунд; смена трека
и play/pause отправляются сразу. Прогресс не выдумывает движение без связи с ПК.
При уходе приложения в фон или потере связи отображается отметка устаревших данных;
резервный `staleDate` — 15 секунд, если приложение было внезапно остановлено.
Для обновления нажмите карточку. Прямых кнопок управления внутри неё пока нет.
Live Activity не поддерживает постоянный сетевой поток сама по себе. Для обновления
при приостановленном приложении нужен отдельный механизм ActivityKit push через
APNs. В этой версии нет push-токенов, сервера APNs, фонового аудио и App Intents.
[Ограничения и жизненный цикл ActivityKit](https://developer.apple.com/documentation/activitykit/displaying-live-data-with-live-activities).
В IPA включено расширение `MusicBridgeWidgets.appex`; при установке iloader должен
сохранить и подписать его вместе с приложением. Если Live Activity не появилась,
проверьте её разрешение в настройках MusicBridge и наличие расширения в логе установки.
Автоматические снимки `live-card-*-screen.png` показывают общую SwiftUI-разметку
карточки в Debug-предпросмотре: это не доказательство её регистрации на реальном
экране блокировки или системного отображения Dynamic Island.
## Источники
- [Apple: проверка доверия сервера](https://developer.apple.com/documentation/Foundation/performing-manual-server-trust-authentication)