1 # JCRGuru — Android Studio Project
2
3 This directory contains the ready-to-build Android Studio project for **JCRGuru**.
4
5 ## Quick Start in Android Studio
6
7 1. **Open Android Studio**:
8 - Click **Open** (or `File > Open...`).
9 - Navigate to the unzipped project folder and select the `android/` directory (or the project root).
10 - Click **OK**.
11
12 2. **Gradle Sync**:
13 - Android Studio will automatically recognize the Gradle build files and sync the dependencies (`androidx.webkit`, `material`, `appcompat`, `swiperefreshlayout`).
14 - If prompted to upgrade Gradle or Android Gradle Plugin (AGP), click **Accept / Upgrade**.
15
16 3. **Run on Device or Emulator**:
17 - Select an Android Virtual Device (AVD with API 24+ / Android 7.0+) or connect an Android physical device with USB Debugging enabled.
18 - Click the green **Run** button (▶) or press `Shift + F10`.
19
20 4. **Build Standalone APK**:
21 - In the top menu, go to `Build > Build Bundle(s) / APK(s) > Build APK(s)`.
22 - Once compilation finishes, click **locate** in the popup to retrieve `app-debug.apk`.
23 - Transfer and install `app-debug.apk` onto any Android phone or tablet for bench-side usage!
24
25 ## Features in Android Build:
26 - Full offline support with LocalStorage & IndexedDB caching for all 624 repair guides.
27 - Multimeter voltage rail pinouts and hardware diagnostic flowcharts.
28 - Direct hardware back-button navigation handling in WebView.
29 - Pull-to-refresh sync gestures.