2.6 KiB
2.6 KiB
📋 FLUTTER DEVELOPMENT SETUP CHECKLIST
Sebelum menjalankan flutter run, pastikan semua ini sudah dilakukan:
✅ BACKEND SETUP
-
Jalankan Backend dengan Network Access
# Pilih salah satu: # Option 1: Pakai script (RECOMMENDED) cd c:\laragon\www\TA\spk_kontrakan start start-backend-network.bat # Option 2: Manual command php artisan serve --host=0.0.0.0 --port=8000Expected output:
Starting Laravel development server: http://0.0.0.0:8000 -
Verifikasi Port 8000 Running
netstat -ano | findstr :8000 # Harusnya ada: TCP 0.0.0.0:8000 LISTENING
🛡️ FIREWALL SETUP
- Allow Port 8000 di Windows Firewall
- Buka "Windows Defender Firewall with Advanced Security"
- Klik "Inbound Rules" → "New Rule"
- Port → Specific port: 8000 → Allow
- Atau: Allow app "php.exe" melalui firewall
📱 DEVICE SETUP
-
Device Terhubung ke Network Yang Sama
- Device USB atau Emulator terhubung ke WiFi/network sama dengan komputer
-
Cek IP Komputer
ipconfig | findstr IPv4 # Catat IP yang dimulai dengan 192.168.x.x
🔧 FLUTTER CONFIG
- Update app_config.dart dengan IP yang Benar
// File: lib/config/app_config.dart static const String baseUrl = 'http://[YOUR-IP]:8000/api'; static const String storageUrl = 'http://[YOUR-IP]:8000/storage';
🚀 FLUTTER RUN
- Clean & Run
cd c:\laragon\www\TA\spk_mobile flutter clean flutter run
🆘 TROUBLESHOOTING
❌ "TimeoutException" - Tidak Bisa Terhubung ke Backend
Checklist:
- ✅ Apakah backend running?
netstat -ano | findstr :8000 - ✅ Apakah firewall allow port 8000?
- ✅ Apakah device satu network? Ping ke IP:
ping 192.168.18.16 - ✅ Apakah IP di app_config.dart sesuai?
- ✅ Coba akses via browser dulu:
http://192.168.18.16:8000
✅ Akses OK di Browser tapi Flutter Gagal
- Kemungkinan: CORS issu atau Android Network Security
- Solusi: Cek di backend apakah CORS sudah enabled
🚫 "Connection Refused"
- Backend tidak running
- Solusi: Jalankan
start-backend-network.batterlebih dahulu
💡 BEST PRACTICES
-
Selalu Jalankan Backend Terlebih Dahulu
- Backend harus ready sebelum Flutter app Connect
-
Simpan IP di Environment Variable (tidak hardcode)
- Sudah tersedia di
environment.dart
- Sudah tersedia di
-
Gunakan Script start-backend-network.bat
- Lebih mudah dari mengetik command panjang
-
Test dengan Browser Dulu
- Akses
http://192.168.18.16:8000/api/kontrakan - Harus return JSON jika API berjalan
- Akses