Android SDK Kurulumu ve Cihazla Çalışmak İçin ADB/Fastboot Hazırlığı
Android Studio'yu (veya yalnızca Komut Satırı Araçlarını) indirin, SDK Yöneticisi aracılığıyla Android SDK ve Platform Araçlarını kurun ya da bağımsız platform-tools paketini çıkarın, klasörü PATH'e ekleyin ve telefonunuzda USB hata ayıklamayı etkinleştirin — bundan sonra adb ve fastboot terminalde çalışacaktır.
Android SDK ve Platform Araçları Nedir?
Android SDK; uygulama geliştirme ve hata ayıklama için kullanılan araç setidir (emülatörler, kütüphaneler, yardımcı programlar). Platform Araçları; cihaz yönetimi için adb (Android Debug Bridge) ve önyükleyici ile yazılımlarla çalışmak için fastboot içerir. Bunlar olmadan Android Studio, gerçek bir cihazla tam anlamda etkileşim kuramaz.
Android Studio Üzerinden Kurulum (Önerilen)
- İşletim sisteminiz için Android Studio'yu indirip kurun. İlk başlatışta Standard seçeneğini belirleyin — SDK otomatik olarak kurulacaktır.
- SDK Yöneticisini açın: File > Settings > Appearance & Behavior > System Settings > Android SDK (veya Tools > SDK Manager).
- SDK Tools sekmesine geçin ve Android SDK Platform-Tools öğesini işaretleyin → Apply. Kurulum yaklaşık 10–20 MB sürecektir.
- SDK yolunu (SDK Location) kontrol edin — genellikle:
- Windows: C:\Users<user>\AppData\Local\Android\Sdk\platform-tools
- macOS/Linux: ~/Library/Android/sdk/platform-tools veya ~/Android/Sdk/platform-tools
İnternetiniz yavaşsa, yalnızca Komut Satırı Araçlarını kurup platform-tools arşivini ayrı olarak indirebilir ve SDK klasörüne çıkarabilirsiniz.
Bağımsız Kurulum ve PATH'e Ekleme
- platform-tools arşivini uygun bir klasöre indirip çıkarın, örneğin:
- Windows: C:\platform-tools
- macOS/Linux: ~/platform-tools
- Yolu PATH ortam değişkenine ekleyin:
- Windows (Grafik Arayüz): Denetim Masası → Sistem → Gelişmiş sistem ayarları → Ortam Değişkenleri → Path → C:\platform-tools ekle
- macOS (zsh): echo 'export PATH=$PATH:~/platform-tools' >> ~/.zshrc && source ~/.zshrc
- Linux (bash): echo 'export PATH=$PATH:~/platform-tools' >> ~/.bashrc && source ~/.bashrc
- Terminalde kontrol edin:
- adb version
- fastboot --version
Cihaz Yapılandırması (Hızlı Kılavuz)
- Geliştirici modunu etkinleştirin: Ayarlar → Telefon hakkında → "Yapı numarası"na 7 kez dokunun.
- USB hata ayıklamayı etkinleştirin: Ayarlar → Geliştirici seçenekleri → USB hata ayıklama — etkinleştir.
- Kabloyla bağlayın (dosya aktarımı modu). Terminalde:
- adb devices — cihazın "device" olarak görünmesi gerekir. Durum "unauthorized" ise telefonun ekran kilidini açın ve erişimi onaylayın.
- adb reboot bootloader — önyükleyiciye geçiş yapın; ardından fastboot devices — bağlantıyı kontrol edin.
Veri aktarımını destekleyen kaliteli bir USB kablosu kullanın — ucuz kablolar bazen yalnızca şarj işlevi görür.
Faydalı Komutlar
- adb devices — bağlı cihazların listesi
- adb install app.apk — APK yükleme
- adb shell — cihazda shell açma
- adb logcat — günlükleri görüntüleme
- adb pull /sdcard/Download/file.zip — telefondan dosya indirme
- adb reboot bootloader; fastboot devices; fastboot reboot
Yaygın Hatalar ve Çözümleri
Tipik Sorunlar ve Çözümlerin Karşılaştırılması
| Sorun | Neden | Hızlı Çözüm |
|---|---|---|
| adb: command not found | platform-tools PATH'te değil | platform-tools yolunu PATH'e ekleyin, terminali yeniden başlatın |
| Cihaz görünmüyor | Sürücüler gerekli (Windows) veya yanlış USB modu | OEM sürücülerini kurun / MTP modunu seçin / hata ayıklamayı etkinleştirin |
| unauthorized | Telefon erişimi onaylamadı | Ekran kilidini açın ve cihazdaki istemi onaylayın |
| fastboot cihazı görmüyor | Önyükleyicide değil | adb reboot bootloader komutunu kullanın veya doğru kablo/port seçin |
Linux'ta genellikle şu paketlerin kurulumu yardımcı olur: sudo apt install android-tools-adb android-tools-fastboot.
Sık Yapılan Hatalar
- PATH değişikliğinden sonra terminali yeniden başlatmamak.
- Yalnızca şarj için kullanılan kablo kullanmak.
- USB hata ayıklamayı etkinleştirmeyi unutmak veya telefonda yetkilendirmeyi onaylamamak.
- Windows'ta üreticinin USB sürücülerinin yüklü olmaması.
SSS
- platform-tools nasıl güncellenir? Android Studio'daki SDK Yöneticisi üzerinden veya yeni arşivi indirip platform-tools klasörünü değiştirerek.
- adb'nin çalışması için Android Studio gerekli mi? Hayır — bağımsız platform-tools kullanılabilir, ancak Android Studio geliştirme için daha kullanışlıdır.
- adb sürümü nasıl kontrol edilir? adb version — derleme numarasını gösterir.
Artık hazırsınız: adb devices komutunu kontrol edin, APK yükleyin ve hata ayıklamaya başlayın. İyi geliştirmeler!