← Kembali

📱 Flutter USB Debugging

Panduan Lengkap Development Flutter dengan HP Android Real Device

🚫 Tanpa Emulator

⚙️ Persiapan Awal

💡 Keuntungan Menggunakan Real Device:

Performance lebih cepat dan akurat
Testing sensor (GPS, accelerometer, gyroscope) real
Tidak memakan resource PC/Laptop yang besar
User experience yang lebih nyata
Testing kamera dan fitur hardware lainnya

1Install Flutter SDK

Pastikan Flutter SDK sudah terinstall di komputer. Jika belum, ikuti panduan di tab sebelumnya atau download di:

https://docs.flutter.dev/get-started/install

Verifikasi instalasi:

flutter --version

2Install Android SDK (Tanpa Emulator)

Ada 2 cara untuk install Android SDK tanpa emulator:

Opsi 1: Install Android Studio (Direkomendasikan)

Download Android Studio dari developer.android.com/studio
Install Android Studio (pilih Standard installation)
Buka Android Studio → File → Settings → Appearance & Behavior → System Settings → Android SDK
Di tab "SDK Platforms", centang Android versi yang diperlukan (minimal API 21/Android 5.0)
Di tab "SDK Tools", centang:
- ✓ Android SDK Build-Tools
- ✓ Android SDK Command-line Tools
- ✓ Android SDK Platform-Tools
- ❌ Android Emulator (TIDAK PERLU dicentang)
Klik Apply → OK

Opsi 2: Install Android SDK Command Line Tools Only

Download Command Line Tools dari developer.android.com/studio#command-tools
Extract ke folder (misal: C:\Android\cmdline-tools)
Jalankan command berikut untuk install SDK:

# Windows
cd C:\Android\cmdline-tools\bin
sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.0"

# macOS/Linux
cd ~/Android/cmdline-tools/bin
./sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.0"

3Setup Environment Variables

Untuk Windows:

Klik kanan "This PC" → Properties → Advanced system settings
Klik "Environment Variables"
Di "User variables", klik "New" dan tambahkan:

Variable name: ANDROID_HOME
Variable value: C:\Users\[USERNAME]\AppData\Local\Android\Sdk

Tambahkan ke PATH:
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
%ANDROID_HOME%\tools\bin

Untuk macOS/Linux:

Edit file ~/.zshrc atau ~/.bashrc:

export ANDROID_HOME=$HOME/Library/Android/sdk  # macOS
# export ANDROID_HOME=$HOME/Android/Sdk  # Linux
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin

Lalu reload:

source ~/.zshrc # atau source ~/.bashrc

4Install USB Drivers (Windows Only)

Untuk Windows, Anda perlu install USB driver khusus untuk brand HP Anda:

📱

Samsung

📱

Xiaomi

📱

OPPO

📱

Vivo

📱

Realme

📱

Google Pixel

⚠️ Untuk macOS/Linux: USB driver biasanya sudah built-in, tidak perlu install driver tambahan.

5Accept Android Licenses

Jalankan perintah ini untuk menerima lisensi Android SDK:

flutter doctor --android-licenses

Tekan y untuk semua lisensi yang muncul.

🔧 Mengaktifkan USB Debugging

ℹ️ Apa itu USB Debugging? USB Debugging adalah mode developer yang memungkinkan komputer berkomunikasi dengan HP Android untuk development, debugging, dan testing aplikasi.

1Aktifkan Developer Options

Developer Options tersembunyi secara default. Untuk mengaktifkannya:

Buka Settings (Pengaturan) di HP
Scroll ke bawah dan pilih About Phone (Tentang Telepon)
Cari Build Number atau MIUI Version (Xiaomi)
Tap Build Number sebanyak 7 kali berturut-turut
Akan muncul notifikasi "You are now a developer!" atau "Mode Developer telah aktif"

📱 Settings → About Phone → Tap Build Number 7x

⚠️ Catatan untuk Brand Tertentu:

Xiaomi: Settings → About Phone → Tap MIUI Version 7x
Samsung: Settings → About Phone → Software Information → Tap Build Number 7x
OPPO/Realme: Settings → About Phone → Version → Tap Build Number 7x
Vivo: Settings → About Phone → Software Version → Tap Software Version 7x

2Aktifkan USB Debugging

Setelah Developer Options aktif:

Kembali ke Settings
Cari dan buka Developer Options atau Opsi Pengembang
Scroll dan aktifkan toggle USB Debugging
Akan muncul dialog konfirmasi, klik OK

⚙️ Developer Options → USB Debugging → Toggle ON

3Setting Tambahan (Opsional tapi Direkomendasikan)

Di halaman Developer Options yang sama, aktifkan juga:

✓ Stay Awake - HP tidak sleep saat charging
✓ USB Debugging (Security Settings) - izin install app via USB
✓ Install via USB - izin install APK via USB (beberapa HP)

⚠️ Untuk Xiaomi (MIUI):

Aktifkan USB Debugging
Aktifkan Install via USB
Aktifkan USB Debugging (Security Settings)
Di beberapa MIUI perlu login Mi Account untuk USB debugging

4Hubungkan HP ke Komputer

Ambil kabel USB yang bagus (original atau kualitas baik)
Hubungkan HP ke komputer via USB
Di HP, pilih mode USB: File Transfer (MTP) atau Transfer Files
Akan muncul popup "Allow USB Debugging?" di HP
Centang "Always allow from this computer"
Klik OK atau Allow

🔌 USB Connected → Allow USB Debugging → Always Allow ✓ → OK

5Verifikasi Koneksi

Buka Command Prompt / Terminal dan jalankan:

adb devices

Output yang benar akan menampilkan:

                    List of devices attached
ABC123XYZ    device
                

✓ Sukses! Jika muncul serial number dan status "device", HP sudah terhubung dengan benar.

❌ Gagal? Jika muncul "unauthorized" atau list kosong, lihat tab Troubleshooting.

▶️ Menjalankan Aplikasi Flutter

1Cek Device yang Terhubung

Sebelum run app, pastikan Flutter mendeteksi HP:

flutter devices

Output akan menampilkan HP Anda:

                    Found 1 connected device:

SM G960F (mobile) • 123ABC456 • android-arm64 • Android 11 (API 30)

2Buat Project Flutter Baru (Untuk Testing)

Jika belum punya project, buat project baru:

flutter create my_app
cd my_app

3Jalankan Aplikasi

Ada beberapa cara untuk run aplikasi:

Metode 1: Otomatis (Jika hanya 1 device terhubung)

flutter run

Metode 2: Pilih Device Spesifik

Jika ada beberapa device terhubung:

flutter run -d [device-id]

# Contoh:
flutter run -d 123ABC456

Metode 3: Release Mode (Lebih Cepat)

Untuk testing performance yang lebih akurat:

flutter run --release

4Hot Reload & Hot Restart

Saat aplikasi berjalan, Anda bisa menggunakan fitur hot reload:

Keyboard Shortcuts:

r - Hot reload (reload kode tanpa restart app)
R - Hot restart (restart app sepenuhnya)
h - Tampilkan help menu
q - Quit (stop app)
d - Detach (app tetap jalan, terminal lepas)
v - Open DevTools

💡 Pro Tip:

Gunakan Hot Reload (r) untuk perubahan UI yang cepat
Gunakan Hot Restart (R) jika ada perubahan pada state atau dependency
Mode debug lebih lambat tapi bagus untuk development dengan DevTools
Mode release lebih cepat, cocok untuk testing performance

5Build APK untuk Install Manual

Jika ingin build APK untuk dibagikan atau install manual:

Debug APK (Untuk Testing)

flutter build apk --debug

APK akan tersimpan di: build/app/outputs/flutter-apk/app-debug.apk

Release APK (Untuk Produksi)

flutter build apk --release

APK akan tersimpan di: build/app/outputs/flutter-apk/app-release.apk

Split APK per ABI (Size Lebih Kecil)

flutter build apk --split-per-abi

Akan generate 3 APK terpisah untuk arm64, armeabi-v7a, dan x86_64

6Install APK via ADB

Untuk install APK yang sudah di-build:

adb install build/app/outputs/flutter-apk/app-release.apk

# Atau untuk force install (replace existing):
adb install -r build/app/outputs/flutter-apk/app-release.apk

7Perintah-perintah Berguna

# Lihat log aplikasi
flutter logs

# Clear build files
flutter clean

# Get dependencies
flutter pub get

# Upgrade Flutter
flutter upgrade

# Check Flutter health
flutter doctor -v

# Screenshot device
adb exec-out screencap -p > screenshot.png

# Record screen (Android 10+)
adb shell screenrecord /sdcard/demo.mp4

# Pull file dari HP
adb pull /sdcard/demo.mp4

# Push file ke HP
adb push myfile.txt /sdcard/

🔍 Troubleshooting

❌ "adb devices" menampilkan list kosong

Penyebab: Driver tidak terinstall atau USB debugging belum aktif

Solusi:

Pastikan USB Debugging sudah aktif di HP
Install USB driver untuk brand HP Anda (Windows)
Coba cabut dan colok ulang kabel USB
Ganti kabel USB dengan yang berkualitas baik
Coba port USB lain di komputer
Restart adb server:

adb kill-server
adb start-server
adb devices

❌ Device status "unauthorized"

Penyebab: Belum allow USB debugging di HP

Solusi:

Lihat notifikasi di HP, klik "Allow USB Debugging"
Centang "Always allow from this computer"
Jika tidak muncul popup, revoke authorization:

# Di HP: Settings → Developer Options → Revoke USB debugging authorizations
# Lalu cabut dan colok ulang USB

❌ "flutter devices" tidak mendeteksi HP

Penyebab: Flutter tidak terhubung dengan ADB

Solusi:

# Cek apakah adb terdeteksi
which adb  # macOS/Linux
where adb  # Windows

# Pastikan ANDROID_HOME sudah di-set
echo $ANDROID_HOME  # macOS/Linux
echo %ANDROID_HOME%  # Windows

# Restart Flutter
flutter doctor -v

❌ "Error: ADB exited with exit code 1"

Penyebab: ADB process bermasalah atau device disconnect

Solusi:

adb kill-server
adb start-server

# Atau paksa stop semua ADB
taskkill /F /IM adb.exe  # Windows
killall adb  # macOS/Linux

# Lalu start lagi
adb start-server

❌ "Gradle build failed" atau "Error building Android"

Penyebab: Cache kotor atau dependency issue

Solusi:

# Clean project
flutter clean

# Delete build folder
rm -rf build/  # macOS/Linux
rmdir /s build  # Windows

# Get dependencies lagi
flutter pub get

# Clear Gradle cache
cd android
./gradlew clean  # macOS/Linux
gradlew.bat clean  # Windows
cd ..

❌ App install tapi langsung crash di HP

Penyebab: Biasanya karena permission atau minSdkVersion

Solusi:

Cek file android/app/build.gradle
Pastikan minSdkVersion sesuai dengan Android HP:

defaultConfig {
    minSdkVersion 21  // Minimal Android 5.0
    targetSdkVersion 33
    // ...
}

Lihat crash log dengan:

flutter logs
# atau
adb logcat

❌ "Waiting for another flutter command to release the startup lock"

Penyebab: Ada proses Flutter lain yang masih jalan

Solusi:

# Hapus lock file
rm [flutter-sdk-path]/.flutter_tool_state  # macOS/Linux
del [flutter-sdk-path]\.flutter_tool_state  # Windows

# Atau restart semua Flutter process
taskkill /F /IM dart.exe  # Windows
killall dart  # macOS/Linux

❌ Xiaomi: "Install via USB" grayed out / tidak bisa diaktifkan

Penyebab: Perlu login Mi Account atau SIM card

Solusi:

Masukkan SIM card ke HP Xiaomi
Login dengan Mi Account di Settings
Sambungkan ke internet (WiFi/Data)
Tunggu beberapa jam (kadang butuh waktu untuk unlock)
Atau gunakan flutter run langsung tanpa perlu aktifkan "Install via USB"

❌ HP tidak terdeteksi di Windows

Penyebab: Driver belum terinstall

Solusi:

Download dan install driver sesuai brand HP
Atau install Universal ADB Driver:
- Download dari adb.clockworkmod.com
- Install driver tersebut
- Restart komputer
Atau manual install via Device Manager:
- Colok HP ke PC
- Buka Device Manager (Win+X → Device Manager)
- Cari device dengan tanda "!" kuning
- Klik kanan → Update Driver → Browse my computer
- Pilih folder %ANDROID_HOME%\extras\google\usb_driver

💡 Tips Umum untuk Menghindari Masalah:

Selalu gunakan kabel USB original atau berkualitas baik
Hindari menggunakan USB hub, colok langsung ke PC
Pilih port USB 3.0 (warna biru) untuk koneksi lebih stabil
Jangan cabut HP saat proses build/install berlangsung
Keep HP tetap unlock (screen on) saat development
Aktifkan "Stay Awake" di Developer Options
Pastikan HP memiliki storage yang cukup (minimal 500MB free)
Update Android SDK dan Flutter secara berkala

🆘 Masih Bermasalah?

Cek log detail dengan perintah berikut:

# Flutter doctor verbose
flutter doctor -v

# ADB devices verbose
adb devices -l

# Check ADB version
adb version

# Flutter logs
flutter logs

# Android logcat
adb logcat | grep flutter

Share output di atas ke forum/community untuk bantuan lebih lanjut: