tests: enable automatic tests on Android.

Author: bznein

.github/workflows/ci.yml

@@ -70,6 +70,55 @@ jobs:
           path: /github/home/go/src/github.com/BitBoxSwiss/bitbox-wallet-app/frontends/android/BitBoxApp/app/build/outputs/apk/debug/app-debug.apk
           name: BitBoxApp-android-${{github.sha}}.apk
           if-no-files-found: error
+
+  e2e-android:
+    name: Android E2E Tests
+    needs: android
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Download APK
+        uses: actions/download-artifact@v4
+        with:
+          name: BitBoxApp-android-${{ github.sha }}.apk
+          path: frontends/tests/apk
+
+      - name: Install dependencies
+        working-directory: frontends/tests
+        run: npm ci
+
+      - name: Enable KVM group perms
+        run: |
+          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
+          sudo udevadm control --reload-rules
+          sudo udevadm trigger --name-match=kvm
+
+      - name: Install Appium & drivers
+        run: |
+          npm install -g appium
+          appium driver install uiautomator2
+
+      - name: Start Android emulator and run tests
+        uses: reactivecircus/android-emulator-runner@v2
+        env:
+          PLATFORM: Android
+          ANDROID_EMULATOR_WAIT_TIME_BEFORE_KILL: 5
+        with:
+          api-level: 34
+          target: google_apis
+          arch: x86_64
+          force-avd-creation: true
+          emulator-boot-timeout: 600
+          working-directory: frontends/tests
+          emulator-options: "-no-window -no-audio -no-boot-anim -no-snapshot-load -no-snapshot-save"
+          script: ./run.sh
   qt-linux:
     runs-on: ubuntu-22.04
     needs: setup-env

Makefile

@@ -14,6 +14,7 @@
 
 SHELL    := /bin/bash
 WEBROOT  := frontends/web
+MOBILETESTROOT := frontends/tests
 
 catch:
 	@echo "Choose a make target."
@@ -57,6 +58,8 @@ webserve:
 	cd ${WEBROOT} && $(MAKE) serve
 webe2etest:
 	cd ${WEBROOT} && $(MAKE) test-e2e
+mobilee2etest:
+	cd ${MOBILETESTROOT} && ./run.sh
 qt-linux: # run inside dockerdev
 	$(MAKE) buildweb
 	cd frontends/qt && $(MAKE) linux

README.md

@@ -103,6 +103,9 @@ Playwright is used to perform automatic test on some use cases on the webdev ver
 Tests are located under [`frontends/web/tests`](/frontends/web/tests) and can be run with
 `make webe2etest`
 
+Appium is used to perform automatic test on Android emulators.
+The test runs automatically on PRs and push to master in the Github CI. 
+
 #### Run the HTTP API
 
 Run `make servewallet` to compile the code and run `servewallet`. `servewallet` is a devtool which

frontends/tests/.gitignore

@@ -0,0 +1 @@
+/node_modules/

frontends/tests/e2e/base.test.js

@@ -0,0 +1,76 @@
+import { remote } from "webdriverio";
+import { expect } from "chai";
+
+// --- Helpers ---
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+async function clickCss(driver, selector, delay = 1000) {
+  const el = await driver.$(selector);
+  expect(el).to.exist;
+  await el.click();
+  await sleep(delay);
+}
+
+async function clickXPath(driver, xpath, delay = 1000) {
+  const el = await driver.$(xpath);
+  expect(el).to.exist;
+  await el.click();
+  await sleep(delay);
+}
+
+async function typeInInput(driver, selector, text, delay = 1000) {
+  const el = await driver.$(selector);
+  expect(el).to.exist;
+  await el.clearValue();
+  await el.setValue(text);
+  await sleep(delay);
+}
+
+async function selectOptionByText(driver, text, delay = 1000) {
+  const el = await driver.$(`//*[contains(text(),'${text}')]`);
+  expect(el).to.exist;
+  await el.click();
+  await sleep(delay);
+}
+
+// --- Test ---
+describe("BitBoxApp Base Test", function () {
+  this.timeout(180000);
+
+  let driver;
+  before(async () => {
+
+    const opts =  {
+      path: '/',
+      port: 4723,
+      capabilities: {
+        platformName: 'Android',
+        'appium:deviceName': 'Android Emulator',
+        'appium:automationName': 'UiAutomator2',
+        'appium:app': `./apk/app-debug.apk`,
+        'appium:noReset': true,
+      }
+    };
+
+    driver = await remote(opts);
+
+    // Switch to WebView if present
+    const contexts = await driver.getContexts();
+    const webview = contexts.find((c) => c.startsWith("WEBVIEW_"));
+    if (webview) await driver.switchContext(webview);
+  });
+
+  after(async () => {
+    if (driver) await driver.deleteSession();
+  });
+
+  it("should navigate and select Italian language", async () => {
+    await clickCss(driver, "button._transparent_1s0sp_84._button_1s0sp_1._button_1fz28_1", 2000);
+    await clickXPath(driver, "//*[contains(text(),'General')]", 2000);
+    await clickXPath(driver, "//*[contains(text(),'Language')]", 2000);
+
+    // Search and select
+    await typeInInput(driver, "input", "Italian", 2000);
+    await selectOptionByText(driver, "Italiano", 2000);
+  });
+});