96 lines
3.3 KiB
Markdown
96 lines
3.3 KiB
Markdown
# Deploying the managed iOS app
|
||
|
||
VoiceCat's supported iOS client is the .NET 10 UIKit application in
|
||
`clients/apple/VoiceCat.iOS`. The checked-in scripts build its native Opus/RNNoise
|
||
dependency, compile and sign the managed app and Swift ReplayKit extension, stage the bundle,
|
||
install it, and launch it on a paired physical device.
|
||
|
||
## Prerequisites
|
||
|
||
- macOS 27, Xcode 27, .NET SDK 10.0.401, and the matching iOS workload.
|
||
- An unlocked, trusted iPhone connected by USB or visible to Xcode over the network.
|
||
- Apple Development profiles for `me.iamtalon.voicecat` and
|
||
`me.iamtalon.voicecat.broadcast`, both with App Group `group.me.iamtalon.voicecat`.
|
||
|
||
List available devices:
|
||
|
||
```bash
|
||
clients/apple/deploy-ios-device.sh --list
|
||
```
|
||
|
||
## Build, install, and launch
|
||
|
||
Set the Apple developer team explicitly. The .NET host and Xcode-built extension use separate
|
||
build systems, and Xcode needs the team to select the extension profile.
|
||
|
||
```bash
|
||
export VOICECAT_DEVELOPMENT_TEAM=FJV8L966W4
|
||
clients/apple/build-ios-device.sh --configuration Debug
|
||
clients/apple/deploy-ios-device.sh \
|
||
--device "Talon’s iPhone" \
|
||
--configuration Debug \
|
||
--no-build
|
||
```
|
||
|
||
The verified bundle is staged at `dist/ios-managed-device/VoiceCat.iOS.app`. Omit `--no-build`
|
||
to build and deploy in one command. Add `--console` to attach the launch to device logs.
|
||
|
||
Confirm that the process stayed alive:
|
||
|
||
```bash
|
||
xcrun devicectl device info processes --device "Talon’s iPhone" | rg VoiceCat
|
||
```
|
||
|
||
## Signing findings
|
||
|
||
The development team ID is `FJV8L966W4`. Do not infer it from the parenthesized suffix in an
|
||
Apple Development certificate name; that value can identify the certificate holder and need
|
||
not equal a profile's `TeamIdentifier`.
|
||
|
||
The extension wrapper uses automatic signing with installed profiles. If a profile is absent
|
||
and Xcode has a valid signed-in developer account, permit Xcode to create or download it:
|
||
|
||
```bash
|
||
export VOICECAT_ALLOW_PROVISIONING_UPDATES=1
|
||
```
|
||
|
||
Leave that variable unset when valid profiles are already installed. A stale command-line Xcode
|
||
account can otherwise make provisioning updates fail even though offline signing can succeed.
|
||
|
||
## Troubleshooting
|
||
|
||
### Stale CMake source path
|
||
|
||
An old CMake cache can report a source-directory mismatch. Move the generated directories
|
||
aside and rebuild:
|
||
|
||
```bash
|
||
mv artifacts/native-build-ios-arm64-cmake /tmp/
|
||
mv artifacts/native-build-iossimulator-arm64-cmake /tmp/
|
||
```
|
||
|
||
### Locked restore reports changed runtime identifiers
|
||
|
||
The managed libraries' lock files must include `ios-arm64` and `iossimulator-arm64`. Regenerate
|
||
them after runtime changes, then verify that dependency versions did not change:
|
||
|
||
```bash
|
||
/usr/local/share/dotnet/dotnet restore \
|
||
clients/apple/VoiceCat.iOS/VoiceCat.iOS.csproj \
|
||
-p:VoiceCatIosStatic=true \
|
||
--force-evaluate
|
||
```
|
||
|
||
### Developer disk image cannot be mounted
|
||
|
||
CoreDevice errors 10003 or 12040 mean the phone locked. Unlock it, keep the display awake, and
|
||
rerun deployment with `--no-build`.
|
||
|
||
## Verified hardware result
|
||
|
||
On 2026-09-19, the Debug build completed with .NET 10.0.401 and Xcode 27.0. The host and
|
||
ReplayKit extension were signed under team `FJV8L966W4`, installed wirelessly on Talon's iPhone,
|
||
launched as `me.iamtalon.voicecat`, and remained in the device process list. Audio,
|
||
background/lock behavior, Bluetooth, ReplayKit, ScreenCaptureKit, and VoiceOver remain separate
|
||
manual hardware gates.
|