Merge branch 'main' into feature/rn-76-upgrade

Author: axeluhl

.github/workflows/android-build.yml

@@ -0,0 +1,59 @@
+name: Android Build and Release
+
+on:
+  push:
+    paths-ignore:
+      - 'ios/**'
+  workflow_dispatch: # Allows manual triggering from the Actions tab
+
+jobs:
+  build:
+    name: Build Android APKs
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.0.0'
+          cache: 'npm'
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17' # Recommended for modern React Native/Gradle versions
+          distribution: 'zulu'
+
+      - name: Install Dependencies
+        run: |
+          npm install
+          npm install -g react-native-cli
+
+      - name: Run Jetifier
+        run: npx jetify -r
+
+      - name: Change wrapper permissions
+        run: chmod +x android/gradlew
+
+      - name: Build DevDebug APK
+        run: |
+          cd android
+          ./gradlew assembleDevDebug
+
+      - name: Build Debug APK
+        run: |
+          cd android
+          ./gradlew assembleDebug
+
+      - name: Upload APKs to Release
+        uses: softprops/action-gh-release@v2
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: |
+            android/app/build/outputs/apk/dev/debug/*.apk
+            android/app/build/outputs/apk/debug/*.apk
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Readme.md

@@ -2,6 +2,12 @@
 
 **Prerequisites**
 
+Node setup, at least version 18.14.0:
+```
+nvm install 18.14.0
+nvm use 18.14.0
+```
+
 React Native setup (from https://facebook.github.io/react-native/docs/getting-started.html)
 
 1. install nodejs (https://nodejs.org/en/download/package-manager/)
@@ -22,10 +28,17 @@ npm install -g react-native-cli
 npx jetify -r
 ```
 
+Ensure you have a Java Development Kit (JDK) in a version >= 17, with ``JAVA_HOME`` pointing to that JDK.
 Change to the android/ folder and run
 ```
+./gradlew assembleDevDebug
+```
+for the `app-dev-debug.apk` output, or
+```
 ./gradlew assembleDebug
 ```
+for the `app-live-debug.apk` output.
+
 The APKs will be signed using a debug key and can be found under `android/app/build/outputs/apk/live/debug`.
 
 **iOS**