koopa-admin-log/scripts/taler-monitoring/android-test/README.md
Hernâni Marques b0e186f392
android-test: matrix published + stable-self + master builds
Add run-android-variant-matrix.sh so smoke covers F-Droid stable APK,
a self-build of the same release tag (wallet-1.6.1), and origin/master.
Build helper accepts tags; avoids relying on a single developer tree.
2026-07-17 21:31:30 +02:00

3.2 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) Source build + same tests

Builds taler-android at a git ref (:wallet:assembleFdroidDebug), then runs the same smoke (install + withdraw/pay deep-links).

# default: inference fix branch (GOA withdraw reliability)
./run-android-build-and-smoke.sh
# tip of master
BRANCH=master ./run-android-build-and-smoke.sh
# self-build of published stable **tag** (same release as F-Droid 1.6.1)
BRANCH=wallet-1.6.1 LABEL=stable-self ./run-android-build-and-smoke.sh
SKIP_PULL=1 BRANCH=master ./run-android-build-and-smoke.sh
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.

2b) Variant matrix (published + stable self-build + master)

Runs several smokes so a single odd developer build cannot be the only sample:

Variant What
published F-Droid stable APK (net.taler.wallet.fdroid 1.6.1 / 854)
stable-self Rebuild tag wallet-1.6.1 on this host (same source as stable)
master Rebuild origin/master
./run-android-variant-matrix.sh
STACK=goa ./run-android-variant-matrix.sh
VARIANTS=master,stable-self ./run-android-variant-matrix.sh
VARIANTS=published,stable-self,master,fix GUI=0 ./run-android-variant-matrix.sh

Artifacts + SUMMARY.txt under out-matrix-<timestamp>/.

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.