mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 11:07:10 +00:00
docs(folio): state that android recipes need ANDROID_DEVICE
This commit is contained in:
1 parent
8abe2c1ca0
commit
f8a025eb83
1 file changed
+18
-8
@@ -23,11 +23,20 @@ example sanderling runs its property-based specs against.
|
|||||||
## Android
|
## Android
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
just install # build + install on a booted emulator / device
|
ANDROID_DEVICE=emulator-5554 just install # build + install on that device
|
||||||
just uninstall
|
ANDROID_DEVICE=emulator-5554 just uninstall
|
||||||
just clean
|
just clean
|
||||||
```
|
```
|
||||||
|
|
||||||
|
`ANDROID_DEVICE` is the serial `adb devices` reports. Every recipe that
|
||||||
|
installs, uninstalls or fuzzes refuses to run without it, unless the only
|
||||||
|
device adb can see is a single emulator on the local adb server. The refusal
|
||||||
|
prints what adb currently sees.
|
||||||
|
|
||||||
|
A run installs the app, clears its state and drives it, which is not something
|
||||||
|
to do to a handset that happens to be the one thing plugged in. An emulator is
|
||||||
|
cheap to rebuild, so a lone local one is the single case worth guessing at.
|
||||||
|
|
||||||
## iOS
|
## iOS
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
@@ -61,11 +70,12 @@ password: ledger123
|
|||||||
## Run a sanderling test (Android)
|
## Run a sanderling test (Android)
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
just test
|
ANDROID_DEVICE=emulator-5554 just test
|
||||||
```
|
```
|
||||||
|
|
||||||
If no device is connected, sanderling boots the single AVD it finds. With multiple
|
The same naming rule as `just install` applies. If nothing is attached at all,
|
||||||
AVDs, pick one:
|
`just test` boots a bootable AVD and runs against that. With multiple AVDs,
|
||||||
|
pick one:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
AVD=Pixel_7 just test
|
AVD=Pixel_7 just test
|
||||||
@@ -74,14 +84,14 @@ AVD=Pixel_7 just test
|
|||||||
Persistent settings can live in `.env` alongside the justfile:
|
Persistent settings can live in `.env` alongside the justfile:
|
||||||
|
|
||||||
```
|
```
|
||||||
AVD=Pixel_7
|
ANDROID_DEVICE=emulator-5554
|
||||||
DURATION=5m
|
DURATION=5m
|
||||||
```
|
```
|
||||||
|
|
||||||
The device does not have to be attached to this machine. `ADB_SERVER_SOCKET`
|
The device does not have to be attached to this machine. `ADB_SERVER_SOCKET`
|
||||||
aims adb at another host's adb server, and `ANDROID_DEVICE` names the serial
|
aims adb at another host's adb server, and `ANDROID_DEVICE` names the serial
|
||||||
that server reports, which is also what routes the install when the server has
|
that server reports. A remote server is shared, so `ANDROID_DEVICE` is required
|
||||||
more than one device online:
|
there even when it holds only one device:
|
||||||
|
|
||||||
```
|
```
|
||||||
ADB_SERVER_SOCKET=tcp:10.0.0.5:5037
|
ADB_SERVER_SOCKET=tcp:10.0.0.5:5037
|
||||||
|
|||||||
Reference in new issue
Block a user