PC'de ADB ile Hızlı Çalışmaya Başlama

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

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ı.

  1. 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.
  2. 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

  1. 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.
  2. Wi-Fi üzerinden (sıralama):

    • adb tcpip 5555
    • USB'yi çıkarın
    • adb connect <cihaz_IP>:5555
  3. 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.