199 lines
5.2 KiB
Markdown
199 lines
5.2 KiB
Markdown
# 🐛 Debug & Troubleshooting Sistem Lokasi Absensi
|
|
|
|
## ❓ Masalah Umum & Solusi
|
|
|
|
### 1. **Lokasi Selalu "Tidak Valid" / "Tidak Diterima"**
|
|
|
|
**Kemungkinan Penyebab:**
|
|
- ❌ Lokasi GPS belum akurat
|
|
- ❌ Berada terlalu jauh dari radius 250m
|
|
- ❌ Izin akses lokasi belum diberikan
|
|
|
|
**Solusi:**
|
|
```
|
|
1. Buka Settings → Apps → Aplikasi → Permissions
|
|
2. Pastikan "Location" atau "GPS" → "Always allow" / "Allow only while using the app"
|
|
3. Tunggu 5-10 detik hingga GPS lock (akurat)
|
|
4. Lihat UI card menunjukkan "✓ Valid" sebelum ambil foto
|
|
5. Pastikan jarak < 250 meter dari kampus
|
|
```
|
|
|
|
### 2. **Koordinat GPS Tidak Muncul / "Lokasi tidak tersedia"**
|
|
|
|
**Penyebab:**
|
|
- ❌ GPS belum aktif di perangkat
|
|
- ❌ Aplikasi tidak punya izin
|
|
- ❌ Signal GPS lemah (indoor/basement)
|
|
|
|
**Solusi:**
|
|
```
|
|
1. Aktifkan Location di Settings → Location
|
|
2. Ubah ke "High accuracy" mode (bukan "Battery saver")
|
|
3. Buka aplikasi di area terbuka (outdoor)
|
|
4. Tunggu 10-15 detik untuk cold start GPS
|
|
5. Coba di lokasi berbeda dengan signal lebih baik
|
|
```
|
|
|
|
### 3. **Jarak Kampus Terlalu Besar (> 250m)**
|
|
|
|
**Pengecekan:**
|
|
- 📍 Lokasi Anda sekarang: `[Lat, Lon dari GPS]`
|
|
- 📍 Lokasi Kampus: `-6.2447, 106.9956`
|
|
- 📏 Jarak Maksimal: 250 meter
|
|
|
|
**Solusi:**
|
|
```
|
|
1. Pindah lebih dekat ke zona kampus (dalam 250m dari koordinat yang ditentukan)
|
|
2. Jika sudah di dalam kampus tapi masih merah, tunggu 30 detik untuk GPS refine
|
|
3. Coba di lokasi yang berbeda di area kampus
|
|
```
|
|
|
|
### 4. **Tombol "Kirim Absensi" Tidak Bisa Ditekan**
|
|
|
|
**Sebab kemungkinan:**
|
|
- ❌ Lokasi belum valid (card masih merah)
|
|
- ❌ Foto belum diambil
|
|
- ❌ GPS koordinat masih blank
|
|
|
|
**Solusi:**
|
|
```
|
|
Pastikan SEMUA kondisi terpenuhi:
|
|
☑️ Status Lokasi = "✓ Valid" (card hijau)
|
|
☑️ Jarak < 250 meter (ditampilkan di card)
|
|
☑️ Foto sudah diambil (ada preview atau indikasi)
|
|
☑️ Ada koneksi internet untuk kirim ke server
|
|
```
|
|
|
|
### 5. **Foto Tidak Bisa Diambil**
|
|
|
|
**Penyebab:**
|
|
- ❌ Izin kamera belum diberikan
|
|
- ❌ Kamera sedang digunakan aplikasi lain
|
|
|
|
**Solusi:**
|
|
```
|
|
1. Buka Settings → Apps → Aplikasi → Permissions
|
|
2. Pastikan "Camera" sudah "Allow"
|
|
3. Tutup aplikasi lain yang pakai kamera
|
|
4. Restart aplikasi
|
|
5. Tap "📷 Ambil Foto" lagi
|
|
```
|
|
|
|
## 🔍 Cara Cek Koordinat GPS Akurat
|
|
|
|
### Via Google Maps:
|
|
```
|
|
1. Buka Google Maps
|
|
2. Zoom ke lokasi Anda
|
|
3. Long press untuk lihat koordinat
|
|
4. Bandingkan dengan yang ditampilkan di aplikasi
|
|
|
|
Target Lokasi: -6.2447, 106.9956
|
|
Tolerance: ±0.0050° (≈ 500 meter)
|
|
```
|
|
|
|
### Via Aplikasi Lain:
|
|
- Gunakan app "GPS Status" dari Play Store
|
|
- Pastikan satellite count > 8 untuk akurasi baik
|
|
|
|
## 📊 Testing Checklist
|
|
|
|
Sebelum submit absensi, pastikan:
|
|
|
|
```
|
|
LOCAL CHECKING:
|
|
☑️ Aplikasi terbuka tanpa error
|
|
☑️ Login berhasil (masuk halaman Absensi)
|
|
☑️ GPS mulai scanning (lihat "Koordinat: ..." berubah)
|
|
|
|
LOCATION VALIDATION:
|
|
☑️ Koordinat tampil di layar (Lat/Lon ada angkanya)
|
|
☑️ Jarak ditampilkan (contoh: "12.5 meter")
|
|
☑️ Card berwarna HIJAU (✓ Valid)
|
|
☑️ Status menunjukkan "Status Lokasi: ✓ Valid"
|
|
|
|
PHOTO TAKING:
|
|
☑️ Tombol "📷 Ambil Foto" bisa diklik
|
|
☑️ Kamera terbuka (preview camera terlihat)
|
|
☑️ Bisa ambil foto
|
|
☑️ Preview foto muncul di aplikasi
|
|
|
|
FINAL SUBMISSION:
|
|
☑️ Tombol "📤 Kirim Absensi" AKTIF (tidak abu-abu)
|
|
☑️ Tap tombol
|
|
☑️ Tunggu Toast notification (sukses/gagal)
|
|
☑️ Cek Riwayat → lihat record terbaru
|
|
```
|
|
|
|
## 🛠️ DEBUG LOGS
|
|
|
|
Untuk melihat log aplikasi (development):
|
|
|
|
### Via Android Studio:
|
|
```
|
|
1. Buka Android Studio
|
|
2. Tools → Logcat (atau Alt+6)
|
|
3. Filter: "DatabaseHelper" atau "MainActivity"
|
|
4. Lihat error/warning messages
|
|
```
|
|
|
|
### Error Messages Umum:
|
|
```
|
|
"Lokasi tidak tersedia"
|
|
→ GPS belum mendapat fix, tunggu lagi
|
|
|
|
"Gagal mengambil lokasi"
|
|
→ Permission ditolak atau GPS error
|
|
|
|
"Absensi ditolak: Lokasi tidak sesuai"
|
|
→ Jarak > 250m, pindah lebih dekat
|
|
|
|
"Gagal kirim ke server"
|
|
→ Tidak ada internet atau server down
|
|
```
|
|
|
|
## 🌍 Koordinat Reference Points
|
|
|
|
### Area UBH Bekasi:
|
|
| Lokasi | Lat | Lon | Jarak ke Campus |
|
|
|--------|-----|-----|-----------------|
|
|
| Gerbang Depan | -6.2445 | 106.9954 | ~20m |
|
|
| Tengah Kampus | -6.2447 | 106.9956 | ~0m (Reference) |
|
|
| Lapangan Olah Raga | -6.2450 | 106.9960 | ~40m |
|
|
| Kantin | -6.2440 | 106.9950 | ~80m |
|
|
| Maksimal Zona | -6.2397 | 106.9906 | ~250m (Limit) |
|
|
|
|
### Tips Akurasi:
|
|
- Buka area di **outdoor** (bukan dalam gedung)
|
|
- Tunggu **10-15 detik** minimal setelah buka aplikasi
|
|
- Lihat **Satellite Count > 8** untuk akurasi bagus
|
|
- Hindari area dengan banyak bangunan tinggi
|
|
|
|
## 📞 Jika Masalah Masih Ada
|
|
|
|
1. **Cek Permission di Settings:**
|
|
- Settings → Apps → [Nama App] → Permissions
|
|
- Location: ON
|
|
- Camera: ON
|
|
- Internet/Phone: ON
|
|
|
|
2. **Clear Cache Aplikasi:**
|
|
- Settings → Apps → [Nama App] → Storage → Clear Cache
|
|
- Jangan Clear Data (akan hapus user list)
|
|
|
|
3. **Uninstall & Reinstall:**
|
|
- Long press aplikasi → Uninstall
|
|
- Install ulang dari Android Studio
|
|
- Login dengan akun yang sama
|
|
|
|
4. **Hubungi Developer:**
|
|
- Lampirkan screenshot error message
|
|
- Lampirkan koordinat GPS yang tampil
|
|
- Lampirkan lokasi fisik saat testing
|
|
|
|
---
|
|
**Last Updated**: 2026-01-14
|
|
**Android Version**: Min API 24 (Android 7.0)
|
|
**Target API**: 35 (Android 15)
|
|
|