PC'de ADB ile Hızlı Çalışmaya Başlama
ADB, bilgisayardan Android'i yönetmek için kullanılan bir araçtır: komut gönderme, APK yükleme, log kayıtlarını alma, USB veya Wi-Fi üzerinden hata ayıklama. Aşağıda kısa ve pratik bir rehber bulacaksınız: hazırlık, Windows/macOS/Linux üzerine kurulum ve hemen işinize yarayacak komutlar.
ADB Nedir ve Neden Gereklidir
ADB (Android Debug Bridge), PC ile Android cihaz arasında bir komut satırı arayüzüdür. Şunları yapmanızı sağlar:
- APK yüklemek/kaldırmak (adb install/uninstall);
- log kayıtlarını görüntülemek ve kaydetmek (adb logcat);
- cihazda shell komutlarını çalıştırmak (adb shell);
- yedekleme yapmak, dosya kopyalamak (adb pull/push);
- Wi-Fi üzerinden çalışmak (adb tcpip / adb connect);
- fastboot ile birlikte — imajları flashlamak.
ADB, hem geliştiriciler hem de ileri düzey kullanıcılar için hızlı hata ayıklama, kurtarma ve işlem otomasyonu açısından faydalıdır.
USB sürücülerinizi güncelleyin ve orijinal veya kaliteli bir kablo kullanın — bağlantı sorunlarının çoğu bunlardan kaynaklanır.
Windows, macOS, Linux Üzerine Kurulum ve Yapılandırma
Genel gereksinimler: 100–200 MB boş alanı olan bir PC, USB kablosu (ilk bağlantı için), cihazda Geliştirici Seçenekleri ve USB Hata Ayıklama'nın etkinleştirilmiş olması.
-
Geliştirici modunu ve USB hata ayıklamayı etkinleştirin:
- Ayarlar > Telefon Hakkında > "Yapı Numarası"na 7 kez dokunun.
- "Geliştirici Seçenekleri"nde "USB Hata Ayıklama"yı ve gerekirse "USB Üzerinden Yükleme"yi etkinleştirin.
-
Platform-Tools paketini (resmi ADB/fastboot paketi) indirin ve uygun bir klasöre çıkarın.
Windows
- Örneğin C:\adb konumuna çıkarın.
- Sistem Ayarları → Ortam Değişkenleri → Path yoluyla yolu PATH'e ekleyin → C:\adb ekleyin.
- CMD'yi açın ve kontrol edin: adb version
macOS
- ~/adb konumuna çıkarın veya Homebrew ile kurun: brew install android-platform-tools.
- Manuel olarak çıkardıysanız, klasörü PATH'e ekleyin (~/.zshrc veya /etc/paths dosyasını düzenleyin).
Linux (Ubuntu/Debian)
- Paket yöneticisi ile: sudo apt update && sudo apt install android-tools-adb android-tools-fastboot
- Kontrol: adb version
Cihazı Nasıl Bağlarsınız ve Temel Komutlar
-
USB üzerinden bağlantı:
- Kabloyla bağlayın, ekran kilidini açın, "Hata ayıklamaya izin ver" isteğini onaylayın.
- Çalıştırın: adb devices — yanıt olarak ID ve device durumunu göreceksiniz.
-
Wi-Fi üzerinden (sıralama):
- adb tcpip 5555
- USB'yi çıkarın
- adb connect <cihaz_IP>:5555
-
Faydalı komutlar (en sık kullanılanlar)
- adb version — ADB sürümü
- adb devices — bağlı cihazların listesi
- adb install path/to/app.apk — APK yükle
- adb uninstall com.example.app — uygulamayı kaldır
- adb push local remote — dosyayı cihaza kopyala
- adb pull remote local — cihazdan dosya indir
- adb logcat > crash.txt — log kayıtlarını dosyaya kaydet
- adb shell pm clear com.example.app — uygulama verilerini temizle
- adb shell — cihazın shell'ine gir
- adb kill-server && adb start-server — daemon'u yeniden başlat
- fastboot flash boot boot.img — fastboot ile flashlama (bootloader fastboot modundayken)
USB Hata Ayıklama'yı sürekli açık bırakmayın — telefize fiziksel erişim durumunda bu bir güvenlik riskidir.
Sık Karşılaşılan Hatalar
- Device unauthorized — ekran kilidini açın ve hata ayıklamayı onaylayın, başka bir kablo/port deneyin.
- adb: command not found — platform-tools klasörünü PATH'e ekleyin veya paketi kurun.
- No devices/emulator — sürücüleri (Windows) ve bağlantı modunu (MTP/Şarj) kontrol edin.
- Wi-Fi: bağlantı kurulmuyor — her iki cihaz da aynı ağda olmalı, IP'nin doğru olduğundan ve 5555 portunun engellenmediğinden emin olun.
SSS
- ADB için root gerekli mi? Hayır — temel işlevler root olmadan çalışır; gelişmiş sistem işlemleri root gerektirir.
- Wi-Fi üzerinden APK yüklenebilir mi? Evet, adb connect sonrası adb install USB'deki gibi çalışacaktır.
- Her şeyi nasıl eski haline getirebilirim? USB hata ayıklamayı kapatın ve cihazdaki güvenilir anahtarları silin (Geliştirici Seçenekleri'nde).
Önce gereksiz verilerde veya emülatörde pratik yapın. Rutin görevler için kısa betikler oluşturun — bu zaman kazandırır ve manuel hataları en aza indirir.