ADB'ye Hızlı Bir Bakış: Kurulum, Bağlantı ve Komutlar

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

ADB, Android'i yönetmek için kullanılan bir komut satırı aracıdır (Platform-Tools); APK yüklemenize, shell komutları çalıştırmanıza, dosya kopyalamanıza, günlükleri (log) incelemenize ve USB veya Wi-Fi üzerinden bağlantı kurmanıza olanak tanır. Aşağıda, hemen uygulayabileceğiniz adım adım talimatlar ve pratik komutlar yer almaktadır.

ADB'nin (Platform-Tools) Kurulumu

  1. Platform-Tools'u indirin ve uygun bir klasöre çıkarın:
    • Windows: C:\platform-tools
    • macOS/Linux: ~/platform-tools veya /usr/local/platform-tools
  2. PATH ortam değişkenine ekleyin:
    • Windows (PowerShell):
      [System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\platform-tools", "User")
    • macOS/Linux (bash/zsh):
      echo 'export PATH="$HOME/platform-tools:$PATH"' >> ~/.bashrc && source ~/.bashrc
  3. Kontrol edin: adb version adb --help

macOS'ta Homebrew ile kurmak daha pratiktir: brew install --cask android-platform-tools. Bu yöntem güncellemeleri kolaylaştırır.

Cihaz Bağlantısı (USB ve Wi-Fi)

Telefonu hazırlayın:

  1. "Geliştirici seçenekleri"ni etkinleştirin (derleme numarasına 7 kez dokunun) ve "USB hata ayıklama"yı açın.
  2. Kabloyla bağlayın, ekran kilidini açın ve göründüğünde RSA anahtarı istemini onaylayın.

Bağlantı kontrolü: adb devices Beklenen çıktı: seri numara ve device durumu. Eğer unauthorized (yetkisiz) yazıyorsa, telefondan onay verin.

Wi-Fi üzerinden bağlantı (hızlı yöntem; geçici USB bağlantısı veya Android 11+ üzerindeki Kablosuz hata ayıklama özelliğini gerektirir): adb tcpip 5555 adb connect <CIHAZ_IP_ADRESI>:5555

Yabancı veya herkese açık cihazlarda USB hata ayıklamayı ve kalıcı ağ bağlantılarını açık bırakmayın; bu bir güvenlik riskidir.

Temel Komutlar ve Hazır Senaryolar

Sık kullanılan komutlar:

  • Cihaz listesi: adb devices
  • Shell erişimi ve özellik sorgulama: adb shell adb shell getprop ro.build.version.release
  • APK yükleme/kaldırma: adb install app.apk adb install -r app.apk adb uninstall com.example.app
  • Dosya kopyalama: adb push local.file /sdcard/remote.file adb pull /sdcard/remote.file ./local.file
  • Günlükler (Logcat): adb logcat adb logcat -v time > mylog.txt
  • Yeniden başlatma: adb reboot adb reboot bootloader adb reboot recovery
  • Belirli bir cihazla çalışma: adb -s SERI_NUMARASI
  • Hata raporu: adb bugreport bugreport.zip

Kullanışlı senaryolar:

  • Cihazdan ekran görüntüsü alma ve indirme: adb shell screencap -p /sdcard/screen.png adb pull /sdcard/screen.png ./screen.png
  • Kurulu bir uygulamanın APK'sını çıkarma: APK_PATH=$(adb shell pm path com.example.app | sed 's/^package://') adb pull $APK_PATH ./com.example.app.apk
  • Sorunlarda adb sunucusunu yeniden başlatma: adb kill-server adb start-server adb devices

Sık Karşılaşılan Hatalar

  • Cihaz görünmüyor:
    • USB kablosunu kontrol edin (birçoğu sadece şarj içindir), USB modunu (MTP) ve RSA onayını gözden geçirin;
    • Windows'ta üreticinin OEM sürücüsünü yükleyin;
    • Linux'ta udev kurallarını yapılandırın ve yetkileri (plugdev grubu) kontrol edin.
  • unauthorized durumu — ekran kilidini açın ve RSA isteğini onaylayın.
  • insufficient permissions (yetersiz izinler) — Linux'ta sudo kullanın veya udev/yetki ayarlarını yapılandırın.

SSS

  • platform-tools nasıl güncellenir? Periyodik olarak yeni sürümü indirin veya paket yöneticisini (Homebrew, dağıtıma özgü paketler) kullanın.
  • ADB'yi USB olmadan kullanabilir miyim? Evet — Kablosuz hata ayıklama (Android 11+) veya geçici olarak adb tcpip 5555 ile mümkündür, ancak eşleştirme (pairing) daha güvenlidir.
  • Çoğu komut için root gerekir mi? Hayır. İşlemlerin çoğu root olmadan çalışır; sistem bölümlerini etkileyen komutlar root/bootloader erişimi gerektirir.
  • Birden fazla cihazla nasıl çalışılır? adb -s <SERI_NO> kullanın veya Wi-Fi için farklı portlardan bağlantı kurun.

İsterseniz, Windows/macOS/Linux için komutları içeren kısa bir kopya kağıdı (cheat-sheet) hazırlayabilirim.