mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 19:17:10 +00:00
docs(ios): device tunnel uses native usbmux, nothing to install
This commit is contained in:
1 parent
a03d74b3a8
commit
4bf591cad5
3 files changed
+5
-5
No files matched your search
+1
-1
@@ -53,7 +53,7 @@ sanderling doctor [--platform web|android|ios|ios-device|all]
|
||||
| `web` | headless Chromium can launch (the bundled CDP surface boots a real browser). |
|
||||
| `android` | `adb` on PATH; `emulator` on PATH or under `ANDROID_HOME`; Java 17+; embedded native sidecar JAR is real. |
|
||||
| `ios` | `xcrun` on PATH; `simctl` on PATH. The simulator path drives the native companion with no JVM. |
|
||||
| `ios-device` | the `ios` checks plus `devicectl`; `iproxy` on PATH; a connected, paired device; App Store Connect signing credentials present. |
|
||||
| `ios-device` | the `ios` checks plus `devicectl`; the macOS `usbmuxd` socket; a connected, paired device; App Store Connect signing credentials present. |
|
||||
|
||||
## `sanderling version`
|
||||
|
||||
|
||||
@@ -67,7 +67,7 @@ IOS_DEVICE="iPhone 15" just test-ios # pick a different simulator
|
||||
|
||||
#### 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`):
|
||||
A connected iPhone is driven over a usbmux tunnel by a runner the driver builds and signs at run time. The tunnel talks to macOS's own `usbmuxd`, so nothing extra is installed beyond Xcode. It needs App Store Connect signing credentials in the environment (a gitignored `.env` is loaded by `just`):
|
||||
|
||||
```sh
|
||||
SANDERLING_IOS_TEAM=<10-char team id>
|
||||
@@ -78,7 +78,7 @@ 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.
|
||||
Run `sanderling doctor --platform ios-device` to check `devicectl`, the `usbmuxd` socket, a connected and paired device, and the signing credentials before a run.
|
||||
|
||||
### Web
|
||||
|
||||
|
||||
@@ -10,8 +10,8 @@ import (
|
||||
)
|
||||
|
||||
// Device is a physical iOS device resolved from devicectl. A device carries two
|
||||
// identifiers: HardwareUDID feeds xcodebuild -destination and iproxy -u, while
|
||||
// CoreDeviceID feeds devicectl install/uninstall.
|
||||
// identifiers: HardwareUDID feeds xcodebuild -destination and the usbmux device
|
||||
// match, while CoreDeviceID feeds devicectl install/uninstall.
|
||||
type Device struct {
|
||||
Name string
|
||||
HardwareUDID string
|
||||
|
||||
Reference in new issue
Block a user