# Rak Qur'an — proyek Android

Aplikasi Android ini adalah pembungkus WebView untuk web app yang ada di folder `app/src/main/assets/web`. Seluruh aset (HTML, CSS, JS, font Arab, dan data Al-Qur'an) dibundel di dalam APK, sehingga aplikasi tetap berfungsi tanpa internet.

## APK siap pakai

Tautan unduh langsung (dari situs yang sudah di-deploy):

- Release (disarankan): `https://tafsiralquran.pages.dev/android/app/build/outputs/apk/release/app-release.apk`
- Debug: `https://tafsiralquran.pages.dev/android/app/build/outputs/apk/debug/app-debug.apk`

Berkas di dalam proyek ini:

```
app/build/outputs/apk/release/app-release.apk
app/build/outputs/apk/debug/app-debug.apk
```

APK release adalah versi rilis yang disarankan untuk pemakaian sehari-hari.
APK debug bertanda tangan debug, bisa langsung diinstal di Android 5.0 (API 21) ke atas. Untuk distribusi Play Store, build ulang sebagai **signed release APK/Bundle** dari Android Studio.

## Build dengan Android Studio

1. Buka Android Studio → **Open** → pilih folder `android/`.
2. Tunggu Gradle sync selesai (butuh koneksi internet saat pertama kali mengunduh dependensi).
3. Pilih **Build → Generate Signed Bundle / APK** untuk membuat APK rilis, atau langsung **Run** ke emulator/perangkat untuk mencoba.
4. Untuk menghasilkan APK debug cepat:

```bash
./gradlew assembleDebug
```

APK ada di `app/build/outputs/apk/debug/app-debug.apk`.

> File `gradlew` tidak disertakan biner jar-nya. Android Studio akan otomatis membuat wrapper saat proyek pertama kali dibuka. Jika memakai terminal, jalankan `gradle wrapper --gradle-version 8.7` sekali setelah Gradle terpasang.

## Fitur di Android

- Tombol back sistem kembali ke rak buku sebelum keluar aplikasi.
- Zoom teks diatur dari dalam web app (tombol ± dan slider) dan tersimpan di `localStorage`.
- Mode fokus, pencarian ayat, tiga tab tafsir dengan penjelasan sesuai bahasa pilihan, tombol “Arab asli”, dan animasi buku terbuka identik dengan web app.
- Status bar gelap mengikuti tema rak kayu.

## Kontak developer

**0811448944** — WhatsApp: https://wa.me/62811448944
