feat(ios): native receiver app (Swift, min iOS 17)

A native iOS receiver so an iPhone can act as the second receiver, speaking the existing signaling + RTP protocol (no C++ changes) and mirroring the Android receiver (Phase 8) source-to-source. - RTP core (header/packet, jitter buffer, H.264 depacketizer) ported from the Android receiver - BSD-socket signaling server (dual-stack, most-recent-peer, never-throwing sends) + NSBonjourServices - VideoToolbox H.264 decode (in-band SPS/PPS, real-time, rebuilds on size change) -> AVSampleBufferDisplayLayer - PLI keyframe recovery (500 ms) + pendingOffer for late surface attach - XcodeGen project + bootstrap.sh; XCTest port of the Android suite + new coverage - .gitignore for generated artifacts; CHANGELOG; PHASES + MEMORY updated Status: authored; on-device validation pending a Mac + Xcode 26 + iPhone 16.
2026-09-10 21:31:53 +02:00
parent 4f93c7cd20
commit c43dd3ca4a
31 changed files with 2282 additions and 1 deletions
@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+#
+# Bootstrap for the iOS receiver. Intended to be run on a Mac with Xcode 26.
+# It installs XcodeGen (if absent) from the GitHub release (no Homebrew needed),
+# generates the Xcode project, and builds/tests.
+#
+# Usage:
+#   ./bootstrap.sh                 # generate + build for device
+#   ./bootstrap.sh test            # generate + run the unit tests (simulator)
+#   ./bootstrap.sh build-sim       # generate + build for the simulator
+#   ./bootstrap.sh generate        # just generate the project
+#
+# Device install/signing is intentionally left to Xcode: open
+# Receiver.xcodeproj, set your Apple ID on the Receiver target, and hit Run.
+set -euo pipefail
+
+IOS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TOOLS_DIR="$IOS_DIR/tools"
+XCODEGEN_BIN="$TOOLS_DIR/xcodegen"
+PROJ="$IOS_DIR/Receiver.xcodeproj"
+
+# 1. Xcode
+if ! command -v xcodebuild >/dev/null 2>&1; then
+    echo "error: xcodebuild not found. Install Xcode (26.x) and select its CLI tools." >&2
+    echo "       xcode-select --install   (or: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer)" >&2
+    exit 1
+fi
+
+# 2. XcodeGen: prefer a system copy, then a local install, else download latest.
+if ! command -v xcodegen >/dev/null 2>&1 && [ ! -x "$XCODEGEN_BIN" ]; then
+    echo "Installing XcodeGen into $TOOLS_DIR ..."
+    mkdir -p "$TOOLS_DIR"
+    url="https://github.com/yonaskolb/XcodeGen/releases/latest/download/xcodegen.zip"
+    tmp="$(mktemp -d)"
+    curl -fL "$url" -o "$tmp/xcodegen.zip"
+    unzip -o -q "$tmp/xcodegen.zip" -d "$TOOLS_DIR"
+    # The release zip extracts to a flat binary named "xcodegen".
+    if [ ! -x "$XCODEGEN_BIN" ] && [ -f "$TOOLS_DIR/xcodegen" ]; then
+        chmod +x "$XCODEGEN_BIN"
+    fi
+    rm -rf "$tmp"
+fi
+XCODEGEN="$(command -v xcodegen || echo "$XCODEGEN_BIN")"
+if [ ! -x "$XCODEGEN" ] && [ ! -x "$XCODEGEN_BIN" ]; then
+    echo "error: XcodeGen not found and download failed." >&2
+    exit 1
+fi
+XCODEGEN="${XCODEGEN_BIN}"
+
+generate() {
+    "$XCODEGEN_BIN" generate --spec "$IOS_DIR/project.yml" --project "$IOS_DIR"
+    echo "Generated $PROJ"
+}
+
+dest_sim() { echo "${IOS_DEST:-platform=iOS Simulator,name=iPhone 16}"; }
+
+command="${1:-build}"
+generate
+
+case "$command" in
+    generate)
+        ;;
+    build)
+        xcodebuild -project "$PROJ" -scheme Receiver -destination "generic/platform=iOS" build
+        ;;
+    build-sim)
+        xcodebuild -project "$PROJ" -scheme Receiver -destination "$(dest_sim)" build
+        ;;
+    test)
+        xcodebuild test -project "$PROJ" -scheme Receiver -destination "$(dest_sim)" \
+            -only-testing:ReceiverTests
+        ;;
+    *)
+        echo "usage: bootstrap.sh [generate|build|build-sim|test]" >&2
+        exit 1
+        ;;
+esac
+
+echo "Done."