Troubleshooting `flutter doctor`: Error Umum & Solusinya

Artikel ini berperan sebagai “tabel rujukan cepat” untuk membereskan rintangan setup paling umum yang terdeteksi oleh flutter doctor.

---

1) Flutter tidak ditemukan di PATH

Gejala:

• command not found: flutter atau versi tidak tampil.

Solusi:

• Tambahkan .../flutter/bin ke PATH shell profile (macOS/Linux: ~/.zshrc/~/.bashrc).
• Windows: tambah C:\path\to\flutter\bin ke Environment Variables → Path, lalu buka terminal baru.

---

2) Android SDK/Command-line Tools belum lengkap

Gejala:

• Android toolchain - develop for Android devices (✗)
• Pesan cmdline-tools missing atau platform-tools missing.

Solusi:

• Android Studio → SDK Manager → pasang:
  • Android SDK Platform-Tools
  • Android SDK Command-line Tools (latest)
  • Android SDK Build-Tools
• Pastikan PATH mengarah ke platform-tools dan cmdline-tools/latest/bin jika perlu.

---

3) Android licenses belum disetujui

Solusi:

flutter doctor --android-licenses

Jawab y untuk semua prompt.

---

4) Xcode/iOS toolchain belum siap

Gejala:

• Xcode - develop for iOS and macOS (✗)

Solusi:

xcode-select --install
sudo xcodebuild -license

Lalu buka Xcode sekali. Pastikan CocoaPods terpasang: sudo gem install cocoapods.

---

5) Emulator/Device tidak terdeteksi

Solusi Android:

• Buat AVD: Android Studio → Device Manager.
• Aktifkan akselerasi hardware (HAXM/Hypervisor/Apple Virtualization).
• flutter devices untuk verifikasi.

Solusi iOS (macOS):

• Tambah simulator di Xcode → Devices and Simulators.
• flutter run -d ios.

---

6) Proxy/Firewall menghambat unduhan

Gejala: unduhan SDK/Gradle gagal.

Solusi:

• Set environment proxy (HTTP_PROXY/HTTPS_PROXY) sesuai kebijakan kantor.
• Mirror internal untuk Gradle/CocoaPods jika diperlukan.

---

7) Masalah Permission/Write Access

Solusi:

• Hindari instalasi di direktori yang memerlukan admin (C:\Program Files, /usr/local tanpa izin tulis).
• Gunakan C:\src, D:\dev, ~/development.

---

Ringkasan

Gunakan output flutter doctor sebagai checklist. Bereskan PATH, Android SDK & lisensi, Xcode/CLT/CocoaPods, serta emulator/device. Setelah semua hijau/OK, development akan mengalir tanpa hambatan berarti.