Testing on a phone

Plugin clients also run in the Paseo phone app, under Hermes, with touch and a small screen. ppd android connects a phone to your dev daemon over adb reverse and tells you what state the phone is in. It never touches the phone beyond that.

Before the phone

Two cheaper checks catch most phone problems:

• ppd check compiles the client bundle with hermesc and runs it in the Hermes VM, so syntax Hermes rejects fails before you reach a device. Both come from the plugin's react-native devDependency (the VM on macOS), or set HERMESC and HERMES. See Host-contract checks.
• ppd web --viewport 390x844 renders the app's compact layout in Chrome:

npx ppd web --viewport 390x844 --command "Open Hello panel" --shot out/hello-phone.png

What you need

Check the phone

npx ppd android status

Output from a real phone (serial, model and foreground app changed):

device: 3A091FDJH00ABC product:husky model:Pixel_8_Pro device:husky transport_id:2
warning: foreground app is com.android.chrome: the user may be using the phone; do not inject input until Paseo is in front
{
  "awake": true,
  "locked": false,
  "paseoInstalled": true,
  "foreground": "com.android.chrome"
}
no adb reverse rules

The state comes from dumpsys and pm list packages, read-only. Any warning (screen off, locked, Paseo missing, another app in front) makes status exit 1, which is the signal for an agent to stop and ask you.

Connect it

npx ppd android up

device: 3A091FDJH00ABC product:husky model:Pixel_8_Pro device:husky transport_id:2
warning: foreground app is com.android.chrome: the user may be using the phone; do not inject input until Paseo is in front
adb reverse tcp:7800 -> dev daemon on 127.0.0.1:7800
next:
  1. ask the user to open Paseo on the phone and add the host localhost:7800
  2. install or reload the plugin with ppd, then open its surface on the phone
  3. screenshots: ~/Library/Android/sdk/platform-tools/adb -s 3A091FDJH00ABC exec-out screencap -p > shot.png
  4. when done: ppd android down, then remove the host in the app
rules: pin -s 3A091FDJH00ABC on every adb call, never send BACK or HOME, check the foreground app before any input

The phone now reaches the dev daemon as localhost:7800. Adding that host in the Paseo app is up to you: ppd does not tap anything. The next and rules lines are written for coding agents, which tend to act on what a command prints.

Disconnect

npx ppd android down

device: 3A091FDJH00ABC product:husky model:Pixel_8_Pro device:husky transport_id:2
removed adb reverse tcp:7800
cleanup checklist:
  - in the Paseo app, remove the host localhost:7800 (Settings > Hosts)
  - leave the phone as you found it: no settings were changed by ppd

Options