2026-09-10 09:11:55 +03:00
|
|
|
# MusicBridge для iPhone
|
|
|
|
|
|
|
|
|
|
Нативный пульт на SwiftUI для MusicBridge.Agent на Windows. Звук играет на ПК.
|
|
|
|
|
Минимальная версия iOS — 17. Зависимостей Swift Package/CocoaPods нет.
|
|
|
|
|
|
|
|
|
|
## Первый вариант
|
|
|
|
|
|
|
|
|
|
- Сопряжение по HTTPS-адресу домашнего ПК, SHA-256 сертификата и коду.
|
|
|
|
|
- Импорт строки `musicbridge://pair?data=…` из QR агента; камера пока не реализована.
|
|
|
|
|
- Проверка закреплённого DER-сертификата до отправки кода и при следующих соединениях.
|
|
|
|
|
- Хранение адреса, отпечатка и токена в Keychain только на этом устройстве.
|
|
|
|
|
- Название, исполнитель, обложка, позиция, play/pause, следующий/предыдущий трек,
|
|
|
|
|
перемотка ползунком, системная громкость и mute.
|
|
|
|
|
- WSS-состояние, переподключение с задержкой, остановка сети в фоне и восстановление
|
|
|
|
|
при возврате. Команды автоматически не повторяются.
|
|
|
|
|
|
2026-09-10 09:22:14 +03:00
|
|
|
**Статус:** первый вариант собирается в GitHub Actions на macOS, Xcode 16.4,
|
|
|
|
|
Swift 6.1.2. Семь XCTest прошли на симуляторе iOS 18.5; проверка на физическом
|
|
|
|
|
iPhone и соединение с Windows-агентом ещё не выполнены.
|
|
|
|
|
[Успешный запуск](https://github.com/polskikh13/musicbridgeios/actions/runs/34444563869)
|
|
|
|
|
проверяет исходники коммита `a761431`.
|
2026-09-10 09:11:55 +03:00
|
|
|
|
|
|
|
|
## Сборка на Mac
|
|
|
|
|
|
|
|
|
|
1. Открыть `MusicBridge.xcodeproj` в Xcode 16 или новее.
|
|
|
|
|
2. Выбрать схему MusicBridge и симулятор iPhone. Run запускает приложение,
|
|
|
|
|
Test выполняет `MusicBridgeTests`.
|
|
|
|
|
3. Для физического iPhone выбрать свою Team в Signing & Capabilities. Сертификаты
|
|
|
|
|
и provisioning profiles не хранить в Git. Bundle ID при необходимости сменить
|
|
|
|
|
в `tools/generate_project.py`, затем повторно сгенерировать проект.
|
|
|
|
|
4. На ПК запустить агент с `--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.
|
2026-09-10 09:22:14 +03:00
|
|
|
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`.
|
2026-09-10 09:11:55 +03:00
|
|
|
|
|
|
|
|
Основной origin: `ssh://git@dev.yukinoki.ru:2222/musicbridge/ios.git`.
|
2026-09-10 09:22:14 +03:00
|
|
|
Отдельный remote `github` используется для Actions, основной origin сохранён.
|
|
|
|
|
Отправка: `git push origin main` и `git push github main`.
|
|
|
|
|
Код автоматически не зеркалируется между серверами. Локальная регрессионная
|
|
|
|
|
проверка выбора симулятора: `python tools/test_select_simulator.py`.
|
2026-09-10 09:11:55 +03:00
|
|
|
|
|
|
|
|
## Источники
|
|
|
|
|
|
|
|
|
|
- [Apple: проверка доверия сервера](https://developer.apple.com/documentation/Foundation/performing-manual-server-trust-authentication)
|
|
|
|
|
- [Apple: доступ к локальной сети](https://developer.apple.com/documentation/technotes/tn3179-understanding-local-network-privacy)
|
|
|
|
|
- [GitHub: macOS runners](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)
|
|
|
|
|
- [GitHub: лимиты и оплата Actions](https://docs.github.com/en/billing/concepts/product-billing/github-actions)
|
|
|
|
|
|
|
|
|
|
План и ограничения — в `PLAN.md`. Копия протокола агента — в `PROTOCOL.md`.
|
