Skip to content

VoiceStudio is the open-source, fully-local ElevenLabs alternative — voice cloning, voice design, video dubbing, dictation, transcription & audiobook creation in 646 languages.

fix(ios): prepare native runtimes before TestFlight archive

debpalash1021609d33af
diff --git a/.github/workflows/ios-testflight.yml b/.github/workflows/ios-testflight.yml
index 4eeee7839..018e1a31b 100644
--- a/.github/workflows/ios-testflight.yml
+++ b/.github/workflows/ios-testflight.yml
@@ -40,6 +40,22 @@ jobs:
test -n "${!name}" || { echo "Missing $name; see docs/mobile.md → TestFlight"; exit 1; }
done
+ # iOS xcframeworks for the pinned on-device runtimes (sherpa-onnx, onnxruntime,
+ # llama.cpp, omnivoice.cpp); needs Xcode, so it only runs here.
+ - name: Cache native runtimes
+ uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830 # v4.3.0
+ with:
+ path: mobile/native/ios/build
+ key: ios-native-${{ hashFiles('mobile/native/pins.json', 'mobile/native/ios/**', '!mobile/native/ios/build/**') }}
+
+ - name: Build native runtimes
+ env:
+ # Read-only token: avoids the anonymous GitHub API rate limit on shared runners.
+ GITHUB_TOKEN: ${{ github.token }}
+ run: |
+ brew install cmake ninja 2>/dev/null || true
+ bash mobile/native/ios/build.sh ios
+
- name: Generate Xcode project
run: |
brew install xcodegen
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 16ddcade4..62a7744fd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -29,6 +29,8 @@ metadata and the backend fallback mirror it.
### Fixed
+- TestFlight builds prepare the on-device inference runtimes before archiving the iPhone app (#2969)
+
- Phone models can be reaccepted offline without downloading again, and Android dubbing preserves short audio gaps and overlaps (#2969)
- Bug reports no longer risk freezing the app while looking for your tools: the Node-version folder scan now runs off the main thread (#3180)
diff --git a/docs/mobile.md b/docs/mobile.md
index 87deac70a..5e5aa8142 100644
--- a/docs/mobile.md
+++ b/docs/mobile.md
@@ -97,7 +97,9 @@ tests both apps.
## TestFlight (maintainers)
The `iOS TestFlight` workflow signs the iPhone app and uploads it to TestFlight
-for the team's internal testers. It is dispatched by hand from `main` and never
+for the team's internal testers. It prepares the pinned native inference runtimes
+before generating and archiving the Xcode project, including on a clean runner.
+It is dispatched by hand from `main` and never
submits the app for App Store review. One-time setup in the Apple Developer team:
1. Register the App ID `sh.voicestudio.mobile` (Certificates, Identifiers &
diff --git a/tests/test_ios_testflight.py b/tests/test_ios_testflight.py
index 3f919df94..b1d2e72c5 100644
--- a/tests/test_ios_testflight.py
+++ b/tests/test_ios_testflight.py
@@ -63,3 +63,13 @@ def test_workflow_signs_verifies_and_cleans_up_the_key():
assert "testFlightInternalTestingOnly bool true" in source
# Secrets reach only the steps that need them, never the whole job.
assert "secrets." not in yaml.dump(load_workflow()["jobs"]["testflight"].get("env", {}))
+
+
+def test_clean_testflight_runner_prepares_native_dependencies_before_project_generation():
+ steps = load_workflow()["jobs"]["testflight"]["steps"]
+ commands = [step.get("run", "") for step in steps]
+ native = next(i for i, command in enumerate(commands) if "bash mobile/native/ios/build.sh ios" in command)
+ generate = next(i for i, command in enumerate(commands) if "xcodegen generate" in command)
+ archive = next(i for i, command in enumerate(commands) if "-archivePath" in command)
+ assert native < generate < archive
+ assert "if" not in steps[native] # A cache hit still needs generated headers restored.