docs: record that the apk can name the package itself

Claude-Session: https://claude.ai/code/session_012PVErdr3ZzyUASeVQDWsUc
This commit is contained in:
pj committed 2026-08-31 10:21:51 +05:30
1 parent f4b614d3ba
commit 7b44b0c9a9
2 files changed
+6 -2

No files matched your search

+2 -2
View File
@@ -15,9 +15,9 @@ Run a spec against an app for a fixed duration.
| Flag | Default | Description | | Flag | Default | Description |
|---|---|---| |---|---|---|
| `--spec` | required | Path to the TypeScript spec. | | `--spec` | required | Path to the TypeScript spec. |
| `--bundle-id` | required | Target app bundle ID (Android: applicationId). | | `--bundle-id` | required | Target app bundle ID (Android: applicationId). Optional on Android when `--android-app-path` is given: the applicationId is read from the APK's compiled manifest. |
| `--device` | optional (android) | Android device serial, as `adb devices` reports it. Required when more than one device is attached. | | `--device` | optional (android) | Android device serial, as `adb devices` reports it. Required when more than one device is attached. |
| `--android-app-path` | optional (android) | Path to the APK. Clear-state reinstalls from it instead of running `pm clear`. | | `--android-app-path` | optional (android) | Path to the APK. Clear-state reinstalls from it instead of running `pm clear`, and it also supplies `--bundle-id` when that flag is absent. |
| `--platform` | `android` | Target platform: `android`, `ios`, or `web`. | | `--platform` | `android` | Target platform: `android`, `ios`, or `web`. |
| `--avd` | optional (android) | Android AVD name to boot if no device is connected. Required only when no device is connected and multiple AVDs exist. | | `--avd` | optional (android) | Android AVD name to boot if no device is connected. Required only when no device is connected and multiple AVDs exist. |
| `--ios-device` | optional (ios) | iOS target: a simulator name/UDID to boot, or a connected device's name, UDID, or CoreDevice id. | | `--ios-device` | optional (ios) | iOS target: a simulator name/UDID to boot, or a connected device's name, UDID, or CoreDevice id. |
+4
View File
@@ -73,6 +73,10 @@ attached devices with `--device <serial>` as `adb devices` prints it:
sanderling test --spec spec.ts --bundle-id com.example.app --avd Pixel_7_API_34 sanderling test --spec spec.ts --bundle-id com.example.app --avd Pixel_7_API_34
``` ```
`--android-app-path <apk>` stands in for `--bundle-id`: the applicationId is
read out of the APK's compiled manifest, so the id and the file it came from
cannot disagree.
iOS takes `--platform ios` and `--ios-device`, which accepts a simulator name or iOS takes `--platform ios` and `--ios-device`, which accepts a simulator name or
UDID, or a connected device's name, UDID, or CoreDevice id. `--ios-app-path` UDID, or a connected device's name, UDID, or CoreDevice id. `--ios-app-path`
points at the `.app` bundle and is what makes clear-state real; see section 4. points at the `.app` bundle and is what makes clear-state real; see section 4.