Android SDK Kurulumu ve Konumu — Kısa Kılavuz

Android SDK genellikle Android Studio ile birlikte kurulur; varsayılan olarak klasör şu konumlarda bulunur: Windows — C:\Users<kullanıcı>\AppData\Local\Android\Sdk, macOS — ~/Library/Android/sdk, Linux — ~/Android/Sdk. SDK'yı Android Studio sihirbazı aracılığıyla veya komut satırı araçlarıyla (sdkmanager) manuel olarak kurabilirsiniz; ardından yolu Android Studio'ya ve ortam değişkenlerine (ANDROID_SDK_ROOT/ANDROID_HOME) eklemeniz yeterlidir.

Android SDK Nedir ve Neden Gereklidir?

Android SDK, Android uygulamalarını derlemek, hata ayıklamak ve çalıştırmak için gerekli olan araç setidir (platform-tools, build-tools, platforms vb.). Doğru bir SDK olmadan:

• Gradle projeyi derleyemez;
• Flutter/React Native/Unity araçları Android platformunu bulamaz;
• adb/fastboot komut satırında kullanılamaz hale gelir.

SDK Nasıl Kurulur (Hızlı ve Güvenilir Yöntemler)

1. Android Studio üzerinden (önerilen):

   • Android Studio'yu standart kurulum sihirbazıyla kurun.
   • İlk açılışta Setup Wizard'da Android SDK'yı etkinleştirin ve gerekli platformları seçin.
   • Android Studio SDK'yı indirir ve yolu ayarlara otomatik olarak ekler.

2. Manuel olarak (sunucular, CI, minimal kurulum):

   • Komut satırı araçları paketini (Command line tools) indirin ve uygun bir yere çıkarın.
   • Terminalde şunu çalıştırın:

sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

• Bundan sonra platform-tools, platforms ve build-tools klasörleri oluşur; bu dizinin kökü SDK'dır.

SDK Klasörü Fiziksel Olarak Nerede Bulunur ve Nasıl Bulunur?

Tipik yollar:

• Windows: C:\Users<kullanıcı>\AppData\Local\Android\Sdk
• macOS: /Users/<kullanıcı>/Library/Android/sdk (bazen ~/Android/Sdk)
• Linux: ~/Android/Sdk veya ~/Android/sdk

Tam yolu hızlıca öğrenmek için:

• Android Studio'yu açın → File → Settings (veya macOS'ta Android Studio → Preferences) → Appearance & Behavior → System Settings → Android SDK. Üst kısımdaki Android SDK Location alanındaki yolu kopyalayın.

SDK Nasıl Taşınır ve SDK Konumu Nasıl Değiştirilir?

1. Android Studio'yu kapatın.
2. Tüm SDK dizinini yeni bir konuma tamamen kopyalayın (örneğin, D:\Android\Sdk).
3. Android Studio'yu açın ve Android SDK ayarlarında yeni yolu belirtin.
4. Gerekirse IDE eksik bileşenleri indirecektir.

Ortam Değişkenlerinin Yapılandırılması ve Kontrolü

Windows:

• ANDROID_SDK_ROOT (ve uyumluluk için ANDROID_HOME) değişkenini SDK kök yoluna ayarlayarak oluşturun.
• PATH'e şunu ekleyin: %ANDROID_SDK_ROOT%\platform-tools

macOS / Linux (bash/zsh örneği):

export ANDROID_SDK_ROOT="$HOME/Android/Sdk"
export ANDROID_HOME="$ANDROID_SDK_ROOT"
export PATH="$PATH:$ANDROID_SDK_ROOT/platform-tools"

Değişiklikleri uygulayın (source ~/.bashrc veya terminali yeniden başlatın) ve kontrol edin:

• adb --version
• flutter doctor (Flutter kullanıyorsanız)

Sık Karşılaşılan Hatalar

• "SDK location not found" — IDE ayarlarındaki veya ortam değişkenlerindeki yol mevcut olmayan bir klasörü gösteriyor. Çözüm: doğru yolu belirtin veya SDK'yı yeniden kurun.
• "Could not find adb" — platform-tools PATH'te değil; platform-tools'u PATH'e ekleyin ve terminali yeniden başlatın.
• Eksik SDK taşıma işlemi — tüm alt klasörler kopyalanmamış; dizini tamamen kopyalayın.

SSS

• SDK klasörünü dosya gezgininde hızlıca nasıl açabilirim?
  Windows: Dosya Gezgini adres çubuğuna %LOCALAPPDATA%\Android\Sdk yazın.
  macOS: Finder → Git → Klasöre Git… → ~/Library/Android/sdk.
  Linux: cd ~/Android/Sdk

• ANDROID_HOME ve ANDROID_SDK_ROOT'u aynı anda ayarlamak gerekir mi?
  ANDROID_SDK_ROOT'u ayarlamanız önerilir; eski araçlarla uyumluluk için ANDROID_HOME da ayarlanabilir.

• Proje farklı bir build-tools sürümü gerektiriyorsa ne yapmalıyım?
  Gerekli sürümü sdkmanager aracılığıyla veya Android Studio'daki SDK Manager üzerinden (SDK Tools → Show Package Details) kurun.

Tüm adımlardan sonra hala hatalar alıyorsanız, Android Studio ve terminalin aynı SDK yolunu gördüğünden ve platform-tools'un SDK kökünde bulunduğundan emin olun.