mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 19:17:10 +00:00
docs(getting-started): document physical iOS device setup
Lists the iproxy requirement and the App Store Connect signing env vars (SANDERLING_IOS_TEAM, ASC_API_*) a device run needs, plus the test-ios-device recipe and the doctor check.
This commit is contained in:
1 parent
ac76fcca86
commit
9776e9f5b7
1 file changed
+15
@@ -65,6 +65,21 @@ IOS_DEVICE="iPhone 15" just test-ios # pick a different simulator
|
|||||||
|
|
||||||
`just test-ios` boots the simulator if needed, builds and installs the app, then runs `sanderling test --platform ios`.
|
`just test-ios` boots the simulator if needed, builds and installs the app, then runs `sanderling test --platform ios`.
|
||||||
|
|
||||||
|
#### Physical device
|
||||||
|
|
||||||
|
A connected iPhone is driven over a usbmux tunnel by a runner the driver builds and signs at run time. It needs `iproxy` (libimobiledevice) on PATH and App Store Connect signing credentials in the environment (a gitignored `.env` is loaded by `just`):
|
||||||
|
|
||||||
|
```sh
|
||||||
|
SANDERLING_IOS_TEAM=<10-char team id>
|
||||||
|
ASC_API_KEY_ID=<key id>
|
||||||
|
ASC_API_ISSUER_ID=<issuer id>
|
||||||
|
ASC_API_KEY_PATH=<absolute path to AuthKey_*.p8>
|
||||||
|
|
||||||
|
IOS_DEVICE="iPhone" just test-ios-device # name, UDID, or CoreDevice id
|
||||||
|
```
|
||||||
|
|
||||||
|
Run `sanderling doctor --platform ios-device` to check `devicectl`, `iproxy`, a connected and paired device, and the signing credentials before a run.
|
||||||
|
|
||||||
### Web
|
### Web
|
||||||
|
|
||||||
From either example. For the KMP wasmJs build, use `examples/folio`:
|
From either example. For the KMP wasmJs build, use `examples/folio`:
|
||||||
|
|||||||
Reference in new issue
Block a user