Attempt to run Android tests in GH action based on NPM

.env.example

@@ -0,0 +1,11 @@
+# Appium Configuration Environment Variables
+# Copy this file to .env and update with your values
+
+# Path to your APK file for app testing
+APP_PATH=./apps/sample-app.apk
+
+# Device UDID for real device testing (get with 'adb devices')
+DEVICE_UDID=your_device_udid_here
+
+# Appium server URL (default: http://localhost:4723/wd/hub)
+APPIUM_SERVER_URL=http://localhost:4723/wd/hub

.github/workflows/android-appium.yml

@@ -0,0 +1,97 @@
+name: "🤖 Android Appium Tests"
+
+on:
+  push:
+    branches-ignore:
+      - '**'
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches:
+      - main
+
+jobs:
+  run-android-appium-suite:
+    name: "📲 Run Android Appium Suite"
+    runs-on: macos-latest
+    timeout-minutes: 60
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+      cancel-in-progress: true
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Cache npm dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-npm-cache-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-cache-
+
+      # Cache Android ARM64 system image only (API 33, google_apis, arm64-v8a)
+      - name: Cache Android system image (arm64-v8a)
+        uses: actions/cache@v4
+        with:
+          path: ~/Library/Android/sdk/system-images/android-33/google_apis/arm64-v8a
+          key: ${{ runner.os }}-android-system-image-33-google_apis-arm64-v8a
+          restore-keys: |
+            ${{ runner.os }}-android-system-image-33-google_apis-arm64-v8a
+
+      # Cache the rest of the Android SDK (excluding system-images and emulator)
+      - name: Cache Android SDK (core)
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/Library/Android/sdk/platforms
+            ~/Library/Android/sdk/platform-tools
+            ~/Library/Android/sdk/build-tools
+          key: ${{ runner.os }}-android-sdk-core-v1
+          restore-keys: |
+            ${{ runner.os }}-android-sdk-core-v1
+
+      - name: Install Android SDK components (emulator + tools + arm64-v8a system image)
+        run: |
+          export ANDROID_SDK_ROOT=~/Library/Android/sdk
+          export ANDROID_HOME=~/Library/Android/sdk
+          yes | ~/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager --licenses
+          yes | ~/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager --install \
+            "platform-tools" \
+            "platforms;android-33" \
+            "build-tools;33.0.2" \
+            "emulator" \
+            "system-images;android-33;google_apis;arm64-v8a"
+
+      - name: Verify emulator installation
+        run: |
+          export ANDROID_SDK_ROOT=~/Library/Android/sdk
+          export ANDROID_HOME=~/Library/Android/sdk
+          ls -l ~/Library/Android/sdk/emulator || true
+          ls -l ~/Library/Android/sdk/emulator/lib64/qt || true
+          ~/Library/Android/sdk/emulator/emulator -version || true
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Appium and dependencies
+        run: |
+          npm install -g appium
+          npm install -g appium-doctor
+          npm ci
+
+      - name: Check package-lock.json is in sync with package.json
+        run: |
+          npm install --package-lock-only --ignore-scripts
+          git diff --exit-code package-lock.json || (echo "package-lock.json is not in sync with package.json. Please run 'npm install' and commit the updated lock file." && exit 1)
+
+      - name: Run full local CI-like workflow (AVD, emulator, Appium, tests)
+        run: |
+          ./scripts/run-local-ci.sh

.gitignore

@@ -12,13 +12,28 @@ build/
 out/
 
 # Test outputs
+mochawesome-report/
 test-results/
+test-results.xml
 allure-results/
 allure-report/
 screenshots/
 videos/
 logs/
 
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
 # IDE files
 .vscode/
 .idea/
@@ -59,5 +74,7 @@ local.properties
 *.dSYM
 
 # Appium specific
+.appium/
 appium.log
-*.log
+*.log
+test-results.xml