ADB'ye Hızlı Bir Bakış: Kurulum, Bağlantı ve Komutlar
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
- Platform-Tools'u indirin ve uygun bir klasöre çıkarın:
- Windows: C:\platform-tools
- macOS/Linux: ~/platform-tools veya /usr/local/platform-tools
- 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
- Windows (PowerShell):
- 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:
- "Geliştirici seçenekleri"ni etkinleştirin (derleme numarasına 7 kez dokunun) ve "USB hata ayıklama"yı açın.
- 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.