koopa-admin-log/scripts/taler-monitoring/android-test/README.md
Hernâni Marques 0c3019822f
android-test: headless emulator default for GUI smokes
Default EMULATOR_HEADLESS=1 (-no-window, QT offscreen) while guest GLES
still runs via SwiftShader. Auto-start AVD when no adb device; WINDOWED=1
for a host window on laptops.
2026-07-17 21:29:52 +02:00

2.4 KiB

Android pay smoke

1) Published F-Droid wallet

# needs adb device/emulator
./run-android-pay-smoke.sh
STACK=goa ./run-android-pay-smoke.sh
STACK=stage ./run-android-pay-smoke.sh

APK: F-Droid 1.6.1 (net.taler.wallet.fdroid).

2) Latest source build + same tests

Pulls/builds taler-android master (:wallet:assembleFdroidDebug), then runs the same smoke (install + withdraw/pay deep-links).

# default source: $HOME/taler/taler-android
./run-android-build-and-smoke.sh
STACK=goa ./run-android-build-and-smoke.sh
SKIP_PULL=1 ./run-android-build-and-smoke.sh   # use tree as-is
TALER_ANDROID_SRC=/path/to/taler-android ./run-android-build-and-smoke.sh

Built package id: net.taler.wallet.fdroid.debug.
Needs ANDROID_HOME (e.g. $HOME/Android/Sdk), Java 17+, network for Maven.

3) Graphical UI (vanilla)

Deep-link entry (≡ QR) plus multi-round uiautomator taps:

STACK=goa ./run-android-gui-smoke.sh
STACK=stage ./run-android-gui-smoke.sh
# after source build:
GUI=1 ./run-android-build-and-smoke.sh

4) Full GOA/stage chain (from dev/hernani-inference/gui-workflows)

Bank API mint → withdraw deep-link → taps → template pay → taps:

# needs explorer password + device
EXP_PW_FILE=$HOME/src/koopa/koopa-admin-secrets/koopa/host-root/taler-bank/bank-explorer-password.txt \
  STACK=goa PKG=net.taler.wallet.fdroid.debug \
  ./run-goa-gui-chain.sh

STACK=stage ./run-goa-gui-chain.sh

Canonical notes (minimal variant, flags, Linux defaults): GUI-AUTOMATION-NOTES.md.

Flag Linux default Meaning
AUTO_ANDROID 1 Run Android adb/APK automation
AUTO_GUI 1 Graphical uiautomator drive (else deep-link only)
AUTO_PLATFORM autolinux Host family; macOS can later pair with iOS out of tree
EMULATOR_HEADLESS 1 No host window (-no-window). Server-safe.
EMULATOR_GPU swiftshader_indirect Guest GLES still active for UI/taps/screenshots
AUTO_START_EMULATOR 1 Auto-start headless AVD if no adb device
WINDOWED 0 WINDOWED=1 → show emulator window
# headless AVD only (default path for servers)
./start-android-emulator.sh --wait
# windowed (laptops)
WINDOWED=1 ./start-android-emulator.sh --wait

See also parent GIT-AUTOMATION-NOTES.md.