Using the phone

The screen on the left of the page is the phone's touchscreen. Click it once to give it the keyboard: a coloured outline shows that it has the focus.

Touch

The mouse plays the part of your finger.

You doThe phone sees
ClickA tap
Press, hold, releaseA long press
Press and dragA swipe or a scroll
Drag from the top edge downwardsThe notification shade

For Back and Home, use the keys below (Esc and Alt+Esc), the navigation bar when the system shows one, or the adb line.

Notes:

Keyboard

When the screen has the focus, the keys go to the phone as if a USB keyboard were plugged in. The phone uses its own keyboard layout (US English by default), so it reads the position of each key, not the character your computer's layout prints on it.

Useful keys:

KeyEffect
EscBack
Alt+EscHome
Arrows, Tab, EnterMove between fields and buttons, confirm
Volume keys, if your keyboard has themVolume

Holding a key repeats it, as on a real keyboard. The page does not pass the clipboard to the phone yet: to put text into a field, type it, or use the adb line (input text hello).

When you click outside the screen, every key still held is released, so no key stays stuck.

The power button

Power under the screen is the phone's side button:

Vetro keeps the screen on while the tab is open, so you normally do not need it.

Installing an app (APK)

Drag an .apk file from your computer and drop it on the phone screen or on the dashed box in the Apps panel next to it. You can also click choose it and pick the file.

Vetro then:

  1. sends the APK to the phone and installs it (as adb install would);
  2. opens the app's main screen;
  3. saves the machine, so the app is still there at your next visit.

The line under the drop box shows each step, and how long it took. Installing needs the adb connection, which is ready shortly after the home screen: if you drop an APK earlier, it waits for it.

Things to know:

Vetro's small test app, installed by dropping its APK, after one tap

The adb line

Under Tools (the small toggle below the screen) there is a command line connected to the phone's adb shell. Type a command and press Run (or Enter): the output appears below it, with the exit code when it is not zero. The shell runs as the shell user; this is a development (userdebug) build, so su 0 <command> runs a command as root.

Some examples:

getprop ro.build.version.release          # the system version
pm list packages -3                       # the apps you installed
am start -n com.example/.MainActivity     # open an activity
input keyevent KEYCODE_HOME               # press Home
input text hello                          # type text into the focused field
dumpsys window | grep mCurrentFocus       # which window has the focus
settings put system screen_brightness 200 # change a setting

The line runs adb shell commands only: there is no adb push or adb pull here. To move files, use the file manager.

Tools: the boot phases, adb connected and the adb line

The serial console

The black box under Tools is the system's serial console. It shows the kernel and system log, and it is also a shell (as the shell user, like the adb line): click it, type a command, then Enter. The adb line is usually more convenient, because its output is not mixed with the log.