| name | playbridge-apple |
| description | Work on PlayBridge's native Apple phone and Apple TV applications. Use for Swift, SwiftUI, WebKit, AVFoundation, tvOS/iOS playback, Xcode project, CocoaPods, Bonjour, Keychain, TLS pinning, or Apple protocol-consumer changes under mobile/apple/ or tv/apple/. |
PlayBridge Apple
Establish ownership
- Treat
mobile/apple/ and tv/apple/ as separate Xcode projects with shared product behavior but no shared build root.
- The phone contains optional ABI-v2 Google Cast groundwork in
Network/GoogleCastSession.swift; discovery and product UI adoption are not complete, and ordinary source builds must keep working without the XCFramework linked.
- Keep one Apple specialist by default. Split phone and TV work only for substantial, non-overlapping implementations.
- Load
playbridge-protocol when JSON envelopes, pairing, authentication, or generated Swift bindings change.
- Load
playbridge-rust-core when the Cast Core adapter, C ABI, module map, or cast/build-apple.sh changes.
Work safely
- Follow the root
AGENTS.md and inspect the owning Xcode project before changing build settings.
- Preserve Bonjour/local-network declarations, Keychain storage, protected pairing, and SPKI pin validation.
- Check behavioral parity with the corresponding sender or receiver without assuming Android implementation details translate directly to Apple frameworks.
- Never commit signing credentials, provisioning data, pairing secrets, or authenticated stream URLs.
Verify
Build the changed target with Xcode. From mobile/apple/PlayBridge Phone/:
xcodebuild -project "PlayBridge Phone.xcodeproj" -scheme "PlayBridge Phone" -destination 'generic/platform=iOS Simulator' build
From tv/apple/PlayBridge TV/:
xcodebuild -workspace "PlayBridge TV.xcworkspace" -scheme "PlayBridge TV" -configuration Debug -destination 'generic/platform=tvOS' build
Report simulator, SDK, signing, or CocoaPods limitations explicitly; do not treat an unavailable Apple toolchain as successful verification.
For Google Cast adapter or native ABI work, build the optional XCFramework from
the repository root with sh cast/build-apple.sh, then build the phone target
with it linked as Do Not Embed. The script intentionally refuses to
overwrite an existing generated XCFramework.
