Muhamad_Syaroful_Anam/agrilinkvocpro

📱 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

1. Unduh Android Studio dari https://developer.android.com/studio
2. Install sesuai instruksi pada OS Anda.
3. 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

1. Jalankan Android Studio
2. Pilih Open Project
3. 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

1. Buka AVD Manager di Android Studio
2. Buat Virtual Device dengan API minimal 29 (Android 10)
3. Klik Run untuk menjalankan aplikasi di emulator

6.2 Menggunakan Perangkat Fisik

1. Aktifkan Developer Options & USB Debugging di ponsel
2. Sambungkan ponsel ke laptop
3. Pilih perangkat pada Run Configuration
4. 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

1. Build > Generate Signed Bundle / APK
2. Pilih APK atau Android App Bundle (AAB)
3. Masukkan keystore (.jks) dan password
4. 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

---