ADB İçin Eksiksiz Kılavuz: İndirmeden Pratik Komutlara

Kerem Aydın·6 Temmuz 2026·⏱3 dk

Kısaca: ADB (Android Debug Bridge), bir Android cihazını yönetmek için kullanılan konsol tabanlı bir araçtır: APK yükleme, uzaktan kabuk erişimi, dosya kopyalama, günlük görüntüleme ve USB veya Wi‑Fi üzerinden bağlantı. Aşağıda Platform‑Tools'un nereden indirileceği, ADB'nin Windows/macOS/Linux üzerine nasıl kurulup yapılandırılacağı ve örneklerle birlikte çalışan komut seti yer almaktadır.

Platform‑Tools İndirme ve Kurulum

  1. Resmi Platform‑Tools arşivini indirin (derlemede yalnızca adb ve fastboot bulunur) ve kalıcı bir klasöre çıkarın:

    • Windows: C:\android\platform-tools\
    • macOS / Linux: ~/android/platform-tools/ veya /opt/android/platform-tools/

  2. PATH'e ekleyin:

    • Windows (PowerShell, mevcut kullanıcı için): [Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\android\platform-tools", "User")
    • macOS / Linux (bash/zsh): ~/.bashrc / ~/.zshrc dosyasına ekleyin: export PATH="$HOME/android/platform-tools:$PATH"

  3. Kontrol edin:

    • adb version — sürüm
    • adb devices — cihaz listesi

Resmi Platform‑Tools'u kullanın: üçüncü taraf derlemeler eski veya güvensiz olabilir.

Cihaz Yapılandırması ve Bağlantı Kontrolü

  1. Cihazda "Geliştirici Seçenekleri" → "USB Hata Ayıklama"yı etkinleştirin. USB üzerinden ilk bağlanmada RSA anahtarı istemini onaylayın.
  2. Windows: Gerekirse OEM sürücüsünü veya Google USB Driver'ı yükleyin ve Aygıt Yöneticisi'nde sürücüyü güncelleyin.
  3. Linux: Root yetkisi olmadan çalışmak için cihazın VID'siyle birlikte udev kurallarını (/etc/udev/rules.d/51-android.rules) ekleyin ve udev'i yeniden başlatın.
  4. Hızlı tanılama:
    • adb devices — boş liste (algılanmadı), unauthorized (cihazda onaylayın), device (hazır).
    • Sorunlarda: adb kill-server && adb start-server, USB portunu/kablosunu değiştirin.

Windows'ta doğrulanmamış sürücüleri kullanmayın — bu, sistemin kararlılığı ve güvenliği açısından risk oluşturur.

Temel Komutlar ve Pratik Senaryolar

Aşağıda, günlük çalışmalarda gerçekten işinize yarayacak bir komut seti bulunmaktadır.

Temel ADB Komutları Tablosu

KomutNe yaparÖrnek
adb devicesBağlı cihazları gösteriradb devices
adb versionadb sürümüadb version
adb install <apk>APK yükleradb install myapp.apk
adb install -r <apk>Verileri koruyarak yeniden yükleradb install -r myapp.apk
adb uninstall <pkg>Paketi kaldırıradb uninstall com.example.app
adb push <local> <remote>Cihaza kopyalaradb push file.txt /sdcard/Download/
adb pull <remote> [local]Cihazdan kopyalaradb pull /sdcard/log.txt ./
adb shellCihazda kabuk açaradb shell
adb shell <cmd>Komut yürütüradb shell pm list packages -3
adb logcatGünlükleri görüntüleradb logcat *:E
adb rebootCihazı yeniden başlatıradb reboot
adb reboot bootloaderbootloader/fastboot moduna gireradb reboot bootloader
adb sideload <file.zip>Sideload modunda OTA yükleradb sideload update.zip
adb tcpip <port> / adb connect <ip>:<port>Ağ üzerinden bağlanıradb tcpip 5555 → adb connect 192.168.0.10:5555

Pratik senaryolar:

  • Yükleme ve üzerine yazma: adb install -r app.apk
  • Günlükleri kaydetme: adb logcat -d > log.txt
  • Günlük filtreleme: adb logcat MyAppTag:D *:S
  • Wi‑Fi üzerinden bağlanma: USB ile bağlanın, adb tcpip 5555, ardından adb connect <ip>:5555. Yeni Android sürümlerinde PIN/QR eşlemesiyle "Kablosuz hata ayıklama" özelliği bulunmaktadır.

Uzaktan ekran yönetimi için scrcpy kullanın — ADB üzerinden çalışır ve anlık ekran görüntüleme/yönetim sağlar.

Sık Karşılaşılan Hatalar

  • adb not found — PATH eklenmemiş veya yanlış dizin seçilmiş.
  • unauthorized — Cihazdaki RSA isteği onaylanmamış veya ekran kilitli.
  • no permissions (Linux) — udev kuralları eksik veya uygulanmamış.
  • Windows cihazı MTP olarak görüyor — Aygıt Yöneticisi üzerinden sürücüyü manuel olarak güncelleyin.

SSS

  • Android Studio gerekli mi? Hayır — Platform‑Tools yeterlidir; Android Studio geliştirme sırasında kullanışlıdır ancak zorunlu değildir.
  • USB hata ayıklamayı etkinleştirmek güvenli mi? Geliştirme için evet, ancak yabancı/halka açık cihazlarda açık bırakmayın.
  • Başka bir adb ile çakışma olursa ne yapılmalı? Tüm işlemleri kapatın, adb kill-server kullanın ve PATH'te yalnızca bir adb olduğundan emin olun.

Gerekirse — işletim sisteminiz için kısa bir kontrol listesi veya yaygın görevler için .sh/.bat betikleri hazırlayabilirim.