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,42 @@
+import { remote } from "webdriverio";
+import { expect } from "chai";
+
+// --- 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("App main page loads", async () => {
+    const body = await driver.$("body");
+    const bodyText = await body.getText();
+    expect(bodyText).to.include(
+      "Please connect your BitBox and tap the side to continue."
+    );
+  });
+});