Сопряжение по HTTPS-адресу домашнего ПК, SHA-256 сертификата и коду.
Сканирование QR агента камерой, открытие musicbridge://pair?data=… и ручной ввод.
Поиск компьютера через Bonjour и восстановление адреса доверенного ПК.
Проверка закреплённого DER-сертификата до отправки кода и при следующих соединениях.
Хранение адреса, отпечатка и токена в Keychain только на этом устройстве.
Название, исполнитель, обложка, позиция, play/pause, следующий/предыдущий трек, перемотка ползунком, системная громкость и mute.
WSS-состояние, переподключение с задержкой, остановка сети в фоне и восстановление при возврате. Команды автоматически не повторяются.

Статус: пользователь подтвердил установку через iloader, рабочий пилот с Windows-агентом и подключение по QR. В 0.4.0 добавлены иконка и обновлённый интерфейс, в 0.5.0 — локальная Live Activity и Dynamic Island. CI собирает приложение и расширение WidgetKit, выполняет XCTest и Release archive; полная проверка устойчивости на физических устройствах остаётся в PLAN.md.

Сборка на Mac

Открыть MusicBridge.xcodeproj в Xcode 16 или новее.
Выбрать схему MusicBridge и симулятор iPhone. Run запускает приложение, Test выполняет MusicBridgeTests.
Для физического iPhone выбрать свою Team в Signing & Capabilities. Сертификаты и provisioning profiles не хранить в Git. Bundle ID при необходимости сменить в tools/generate_project.py, затем повторно сгенерировать проект.
На ПК запустить агент с --tray --lan, открыть сопряжение. В приложении ввести адрес, отпечаток и код с экрана ПК. Разрешить доступ к локальной сети.

Проект уже сгенерирован и включён в Git; Python для обычной сборки не требуется. После добавления Swift-файлов выполнить python3 tools/generate_project.py. Структурная проверка на Windows/macOS: python tools/validate_project.py.

GitHub Actions

.github/workflows/ios.yml собирает приложение и выполняет XCTest на macos-15 при push в main, pull request или ручном запуске. Сохраняет лог, .xcresult и ZIP приложения для симулятора, который нельзя установить на физический iPhone. Apple ID и сертификаты для этой проверки не требуются. GitHub remote подключён: git@github.com:polskikh13/musicbridgeios.git. GitHub CLI установлен и авторизован; результаты доступны через gh run list --repo polskikh13/musicbridgeios и gh run view <run-id> --repo polskikh13/musicbridgeios --log-failed.

Основной origin: ssh://git@dev.yukinoki.ru:2222/musicbridge/ios.git. Отдельный remote github используется для Actions, основной origin сохранён. Отправка: git push origin main и git push github main. Код автоматически не зеркалируется между серверами. Локальная регрессионная проверка выбора симулятора: python tools/test_select_simulator.py.

Подключение через QR и поиск ПК

Откройте окно сопряжения в Windows-агенте (--tray --lan), на iPhone нажмите «Сканировать QR» и разрешите камеру. После сканирования нажмите «Подключить компьютер». Ссылки musicbridge:// также открываются из стандартной камеры. Приглашение должно быть свежим.

В разделе «Найти компьютер» можно выбрать найденный адрес. Сверьте весь предложенный отпечаток с экраном ПК и введите код. Если поиск не работает, проверьте доступ к локальной сети в настройках MusicBridge; ручной ввод остаётся. При смене адреса уже доверенного ПК приложение пробует объявления с тем же отпечатком и сохраняет новый адрес только после успешной TLS-проверки и авторизации.

Установка на iPhone через Sideloadly

Пользователь также подтвердил установку через iloader. Для повторной установки с Live Activity используйте версию 0.5.0 (build 6): build/iPhone-0.5.0/MusicBridge-iPhone.ipa. Выберите этот файл в iloader и подпишите тем же Apple Account, которым установлена первая версия.

В 0.4.0 добавлены иконка, карточка QR, раскрываемые ручные поля, крупная play/pause, процент громкости и меню компьютера. Размер обложки зависит от доступной высоты окна; при крупном системном шрифте экран прокручивается.

Начиная с 0.3.0 обложка повторно загружается после временного сбоя, а после четырёх неудачных попыток доступен ручной повтор. Отозванный доступ требует нового сопряжения; автоматические попытки прекращаются. Если свернуть приложение во время сопряжения, повторите его со свежим QR (удалив созданную запись на ПК, если она уже успела появиться). При неизвестном результате команды проверьте плеер перед повтором: приложение не повторяет команды автоматически.

Workflow также выполняет Release archive для generic/platform=iOS и создаёт MusicBridge-iPhone.ipa в артефакте MusicBridge-iPhone. Это ARM64-сборка для iOS 17+, без подписи. Подпись создаёт Sideloadly на вашем ПК с вашим Apple Account. В Actions не передаются пароль Apple, сертификаты или provisioning profile.

Скачать артефакт MusicBridge-iPhone из успешного запуска Actions и распаковать ZIP артефакта, чтобы получить файл .ipa.
Подключить разблокированный iPhone к Windows кабелем; подтвердить доверие ПК.
Открыть Sideloadly, выбрать свой iPhone и файл MusicBridge-iPhone.ipa.
Войти в Apple Account непосредственно в Sideloadly, нажать Start, дождаться Done.
Если iPhone сообщает о недоверенном разработчике, открыть «Настройки → Основные → VPN и управление устройством», выбрать свой аккаунт и подтвердить доверие.
Для запуска включить «Настройки → Конфиденциальность и безопасность → Режим разработчика», затем выполнить предложенные iPhone перезагрузку и подтверждение.
Открыть MusicBridge, разрешить локальную сеть и выполнить сопряжение с ПК.

На бесплатном Apple Account подпись действует 7 дней; её нужно обновлять через Sideloadly (в том числе его функцией автоматического обновления). Файл MusicBridge-simulator.zip для установки на телефон не подходит.

Sideloadly FAQ · Apple: режим разработчика

Live Activity и Dynamic Island

После подключения к ПК и появления трека нажмите под плеером «Показать на экране блокировки». Та же карточка появится в Dynamic Island на моделях, где он доступен. Долгое нажатие на Island раскрывает представление; нажатие на карточку или «Открыть плеер» возвращает в приложение. Кнопка «Убрать с экрана блокировки» завершает активность. Она также завершается, когда ПК сообщает об отсутствии медиасессии, доступ отозван или компьютер забыт. Удалённая пользователем карточка не создаётся снова автоматически.

Это последний снимок состояния ПК: название, исполнитель, состояние и прогресс. В обычном режиме позиция обновляется не чаще раза в пять секунд; смена трека и play/pause отправляются сразу. Прогресс не выдумывает движение без связи с ПК. При уходе приложения в фон или потере связи отображается отметка устаревших данных; резервный staleDate — 15 секунд, если приложение было внезапно остановлено. Для обновления нажмите карточку. Прямых кнопок управления внутри неё пока нет.

Live Activity не поддерживает постоянный сетевой поток сама по себе. Для обновления при приостановленном приложении нужен отдельный механизм ActivityKit push через APNs. В этой версии нет push-токенов, сервера APNs, фонового аудио и App Intents. Ограничения и жизненный цикл ActivityKit.

В IPA включено расширение MusicBridgeWidgets.appex; при установке iloader должен сохранить и подписать его вместе с приложением. Если Live Activity не появилась, проверьте её разрешение в настройках MusicBridge и наличие расширения в логе установки. Автоматические снимки live-card-*-screen.png показывают общую SwiftUI-разметку карточки в Debug-предпросмотре: это не доказательство её регистрации на реальном экране блокировки или системного отображения Dynamic Island.

Источники

План и ограничения — в PLAN.md. Копия протокола агента — в PROTOCOL.md.

README.md Unescape Escape

MusicBridge для iPhone

Возможности