Android SDK için ADB ve PATH/ANDROID_HOME nasıl yapılandırılır

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

Kısaca: SDK'yı (Android Studio veya Command Line Tools) yükleyin, ANDROID_HOME/ANDROID_SDK_ROOT değişkenini SDK'nın kök dizinine ayarlayın ve PATH'e platform-tools ile cmdline-tools/.../bin/tools/bin klasörlerini ekleyin. Terminali yeniden başlattıktan sonra adb devices cihazı göstermelidir.

İşletim sistemine göre SDK ve ADB kurulumu — hızlı adımlar

  1. Seçim: Android Studio (önerilen) veya Command Line Tools (daha az yer kaplar).
  2. SDK'yı boşluk içermeyen bir yola yerleştirin:
    • Windows: örneğin C:\Android\Sdk
    • macOS/Linux: ~/Android/Sdk

sdkmanager aracılığıyla platform-tools ve gerekli platformları yükleyin (< > yerine sürümü yazın):

  • Örnek komut: sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

Windows (GUI ve değişkenler):

  • System → Advanced → Environment Variables yolunu izleyin.
  • Sistem değişkeni ekleyin: ANDROID_HOME = C:\Android\Sdk
  • PATH'e şunları ekleyin: %ANDROID_HOME%\platform-tools
    %ANDROID_HOME%\cmdline-tools\latest\bin (veya eski araçlar kullanılıyorsa %ANDROID_HOME%\tools\bin)

PowerShell (oturum için geçici):

  • $env:ANDROID_HOME = "C:\Android\Sdk"
  • Ancak kalıcılık için GUI üzerinden yapılandırmak daha iyidir.

macOS / Linux (zsh/bash):

  • ~/.zshrc veya ~/.bash_profile dosyasına şunları ekleyin: export ANDROID_HOME="$HOME/Android/Sdk" export ANDROID_SDK_ROOT="$ANDROID_HOME" # modern araçlar için eşdeğer export PATH="$PATH:$ANDROID_HOME/platform-tools" export PATH="$PATH:$ANDROID_HOME/cmdline-tools/latest/bin"
  • Uygulayın: source ~/.zshrc veya yeni bir terminal açın.

adb varlığını Unix'te ls $ANDROID_HOME/platform-tools/adb, Windows'ta dir %ANDROID_HOME%\platform-tools\adb komutuyla kontrol edin.

Yapılandırmayı doğrulama ve temel komutlar

  • Değişkeni kontrol etme:
    • Unix: echo $ANDROID_HOME
    • Windows: echo %ANDROID_HOME%
  • adb'yi kontrol etme: adb version — örnek çıktı: Android Debug Bridge version 1.0.41
  • Cihazı bağlama: Geliştirici seçeneklerinde "USB Hata Ayıklama"yı etkinleştirin ve şu komutu çalıştırın: adb devices — cihaz device durumunda görünmelidir. Eğer unauthorized görürseniz telefonu kilidini açın ve RSA isteğini onaylayın.

SDK'yı C:\Program Files altına koymayın — boşluklar betikleri bozabilir. Linux'ta erişim izinlerini unutmayın ve gerekirse kendinizi plugdev grubuna ekleyin: sudo usermod -aG plugdev $USER ve yeniden oturum açın.

Sık karşılaşılan hatalar ve çözümleri

  • "adb: command not found" — PATH güncellenmemiş: yeni bir terminal açın veya source ve hash -r komutlarını çalıştırın.
  • Sistemde birden fazla SDK varsa — ANDROID_HOME'un doğru SDK'yı işaret ettiğinden emin olun; sdkmanager --list yüklü paketleri gösterir.
  • Android Studio SDK'yı görmüyorsa — Settings → Appearance & Behavior → System Settings → Android SDK yolunda yolu belirtin.
  • M1/M2 Mac: Yerel ARM sürümü SDK/araçları kullanın veya eski ikililer için Rosetta'yı tercih edin.
  • "device offline"/"unauthorized" — adb'yi yeniden başlatın: adb kill-server && adb start-server, kabloyu ve cihazdaki izni kontrol edin.

Ek değişkenler (isteğe bağlı)

  • ANDROID_SDK_ROOT — ANDROID_HOME için modern eşdeğer; her ikisini de tanımlayabilirsiniz.
  • JAVA_HOME — Gradle için JDK yolu (örneğin /usr/lib/jvm/java-17-openjdk) gerekir: ~/.gradle/gradle.properties içinde: org.gradle.java.home=/path/to/jdk

SSS

  • Android Studio yüklemek gerekir mi? Yeni başlayanlar için evet. CI/sunucular için Command Line Tools yeterlidir.
  • Windows'ta değişkenleri tüm kullanıcılar için genel nasıl yaparım? Ortam değişkenleri penceresinde (Yönetici olarak) Sistem değişkenleri olarak oluşturun.
  • adb cihazı Linux'ta yalnızca root olarak görüyorsa ne yapılmalı? Normal kullanıcı olarak adb kill-server ve adb start-server çalıştırın, gerekirse udev kurallarını yapılandırın.

Belirtilen adımlar, Android Studio, CLI, Flutter ve React Native ile emülatörler ve gerçek cihazlarla çalışmanızı sağlar. Bir şey işe yaramazsa işletim sisteminizi ve echo $ANDROID_HOME / adb version komutlarının çıktısını paylaşın — nokta atışı yardımcı olurum.