5.4 KiB
5.4 KiB
📱 Aplikasi Mobile Smart Farming – Agrilink Vocpro
Teknologi: Android, Jetpack Compose
1. Pendahuluan
Dokumen ini berisi panduan untuk menginstal, menjalankan, dan mengembangkan aplikasi Agrilink Vocpro berbasis Android Jetpack Compose.
Panduan ini ditujukan bagi programmer yang akan melanjutkan pengembangan setelah versi awal selesai.
2. Persyaratan Sistem
2.1 Perangkat Keras
- Prosesor: Intel Core i5 Generasi ke-8 / AMD Zen Ryzen
- RAM: 8 GB (disarankan 32 GB)
- Penyimpanan: 10 GB ruang kosong
- Kartu Grafis: Tidak diperlukan
2.2 Perangkat Lunak
- Sistem Operasi: Minimal Microsoft Windows 10 64-bit
- Java Development Kit (JDK): Versi 11 (versi yang digunakan pada proyek)
- Android Studio: Versi 2024.3.2 atau terbaru
- Gradle: Versi 8.11
- Git: Repository GitLab
- Android SDK & Emulator: Minimum API 35
3. Persiapan Lingkungan Pengembangan
3.1 Instal Android Studio
- Unduh Android Studio dari https://developer.android.com/studio
- Install sesuai instruksi pada OS Anda.
- Saat instalasi, pastikan mencentang:
- Android SDK
- Android Virtual Device (AVD)
- Android SDK Command-line Tools
3.2 Konfigurasi JDK
- Pastikan JDK versi 23.0.2 terinstal.
- Atur path JDK di Android Studio:
File > Settings > Build, Execution, Deployment > Build Tools > Gradle > Gradle JDK
3.3 Clone Repository Proyek
git clone https://gitlab.com/Syaroful/smart-farming-agrilink-vocpro
4. Struktur Proyek
| Folder / Package | Fungsi |
|---|---|
| app/ | Folder utama yang berisi keseluruhan modul dan komponen aplikasi |
| core/ | Komponen inti dan utilitas yang digunakan di seluruh aplikasi |
| core/component/ | Komponen reusable seperti custom UI components dan base classes |
| core/utils/ | Fungsi utilitas dan helper untuk operasi aplikasi |
| data/ | Mengelola sumber data lokal maupun jaringan |
| data/local/ | Implementasi database lokal |
| data/local/dao/ | Query dan operasi CRUD melalui DAO |
| data/local/database/ | Konfigurasi database lokal |
| data/local/entity/ | Definisi entitas/skema tabel |
| data/model/ | Model data bisnis |
| data/network/ | Komunikasi dengan server & API |
| data/repository/ | Mediator antara data source & ViewModel |
| di/ | Dependency Injection (Koin) |
| navigation/ | Rute navigasi aplikasi |
| presentation/ | Menangani UI dan interaksi pengguna |
| presentation/screen/ | UI untuk setiap layar (Composable Functions) |
| presentation/viewmodel/ | ViewModel yang menghubungkan repository dan UI |
5. Konfigurasi Proyek
5.1 Buka Proyek di Android Studio
- Jalankan Android Studio
- Pilih Open Project
- Arahkan ke folder hasil clone
agrilinkvocpro
5.2 Sinkronisasi Gradle
- Setelah proyek terbuka, klik Sync Now jika muncul notifikasi
- Pastikan semua dependensi terunduh tanpa error
6. Menjalankan Aplikasi
6.1 Menggunakan Emulator
- Buka AVD Manager di Android Studio
- Buat Virtual Device dengan API minimal 29 (Android 10)
- Klik Run untuk menjalankan aplikasi di emulator
6.2 Menggunakan Perangkat Fisik
- Aktifkan Developer Options & USB Debugging di ponsel
- Sambungkan ponsel ke laptop
- Pilih perangkat pada Run Configuration
- Klik Run ▶
7. Build dan Release APK
7.1 Debug APK
Build > Build Bundle(s) / APK(s) > Build APK(s)
7.2 Signed APK / AAB
Build > Generate Signed Bundle / APK- Pilih APK atau Android App Bundle (AAB)
- Masukkan keystore (.jks) dan password
- Klik Finish
8. Catatan Pengembangan Lanjutan
- Bahasa Pemrograman: Kotlin
- Framework UI: Jetpack Compose
- Arsitektur: MVVM (Model-View-ViewModel)
- Dependency Injection: Koin
Library Utama:
- Retrofit / Ktor (Networking)
- Room / DataStore (Database & Storage)
- Koin (Dependency Injection)
- Google Play Core (Dynamic Feature Module)
9. Troubleshooting
| Masalah | Penyebab | Solusi |
|---|---|---|
| Gradle sync error | Versi Gradle/JDK tidak cocok | Sesuaikan versi di gradle-wrapper.properties |
| Emulator lambat | Resource PC rendah | Gunakan perangkat fisik atau optimalkan AVD |
| API tidak merespons | API key atau base URL salah | Cek local.properties |