Android Studio ve Gradle'da "Android SDK not found" hatasını hızlıca giderme

"Android SDK not found" hatası, Android Studio veya Gradle'ın kurulu SDK'yı göremediği anlamına gelir; bu sorun SDK Manager aracılığıyla, ortam değişkenlerinin (ANDROID_HOME/Path) doğru yapılandırılması ve Gradle'ın yeniden derlenmesi/temizlenmesiyle çözülebilir — aşağıda adım adım açıklanmıştır.

Android Studio'da hızlı kontrol

1. Settings / Preferences → Appearance & Behavior → System Settings → Android SDK yolunu açın.
2. SDK Platforms sekmesinde gerekli API'leri işaretleyin (yeni projeler için en az API 34).
3. SDK Tools sekmesinde şunları güncelleyin: Android SDK Build-Tools, Platform-Tools, SDK Command-line Tools. Değişiklikleri uygulayın ve File → Sync Project with Gradle Files seçeneğine tıklayın.
4. SDK boş veya kullanılamaz durumdaysa — SDK Manager (IDE içinde) üzerinden indirin ve Studio'yu yeniden başlatın.

Sorun IDE'de çözüldüyse, projeyi yeniden derleyin (Build → Rebuild Project) ve emülatörün başlatılmasını kontrol edin.

Ortam değişkenlerinin yapılandırılması (Windows / macOS / Linux)

Gradle ve harici betikler genellikle SDK'yı sistem değişkenlerine göre arar. Şu şekilde kontrol edin:

• Windows:

  • Sistem Ayarları → Ortam Değişkenleri bölümünü açın.
  • ANDROID_HOME = C:\Users\<KullanıcıAdınız>\AppData\Local\Android\Sdk şeklinde bir sistem değişkeni ekleyin/doğrulayın.
  • Path değişkenine şunları ekleyin: %ANDROID_HOME%\platform-tools, %ANDROID_HOME%\emulator, %ANDROID_HOME%\tools\bin
  • Terminali/IDE'yi kapatıp yeniden açın.

• macOS / Linux (zsh/bash örneği): ~/.zshrc veya ~/.bash_profile dosyasına şunları ekleyin:

  export ANDROID_HOME=$HOME/Library/Android/sdk
  export PATH=$PATH:$ANDROID_HOME/emulator
  export PATH=$PATH:$ANDROID_HOME/platform-tools
  export PATH=$PATH:$ANDROID_HOME/tools/bin

Ardından source ~/.zshrc komutunu çalıştırın ve echo $ANDROID_HOME ile kontrol edin.

Araçların erişilebilirliğini kontrol edin: sdkmanager --list ve adb --version. Komutlar çalışıyorsa, Gradle SDK'yı bulabilmelidir.

Gradle, önbellek ve proje dosyalarıyla ilgili sorunlar

IDE SDK'yı görüyorsa ancak terminal/CI üzerinden derleme yine de başarısız oluyorsa:

1. gradle.properties dosyasını kontrol edin (proje düzeyinde veya ~/.gradle/ içinde):
   • Yanlış yolu işaretleyen geçersiz kılan özelliklerin olmadığından emin olun.
2. build.gradle (app modülü) içinde sürümleri açıkça belirtin:

   android {
     compileSdk 34
     defaultConfig {
       targetSdk 34
     }
   }

3. Temizleyin ve yeniden derleyin:
   • Proje terminalinde: ./gradlew clean assembleDebug (veya ./gradlew build)
   • Android Studio'da: File → Invalidate Caches / Restart, ardından Sync Project with Gradle Files.
4. Gerekirse projenin kök dizinindeki ve modüllerdeki .gradle/ ve build/ klasörlerini silin, ardından yeniden derleyin.

Hata CI ortamında oluşuyorsa — CI ortamında ANDROID_HOME değişkeninin tanımlandığından veya pipeline'da SDK kurulumu için SDK Manager kullanıldığından emin olun.

Yaklaşımların karşılaştırması (kısa)

Çözüm yöntemlerinin karşılaştırması

Sık karşılaşılan hatalar

• SDK kökü yerine tools yolunun belirtilmesi.
• Path'e yol eklenip terminal/IDE'nin yeniden başlatılmaması.
• Sürüm çakışması: Gradle eklentisi farklı bir compileSdk gerektiriyor.
• M1/M2 Mac'te — Rosetta olmadan emülatör çalıştırma (x86 imajları kullanılırken).
• CI, SDK içermeyen bir konteynerde çalışıyor — pipeline'da kurulması gerekiyor.

SSS

• sdkmanager bulunamazsa ne yapılmalı?
  $ANDROID_HOME/tools/bin yolunun PATH içinde olduğundan emin olun ve terminali yeniden başlatın; gerekirse SDK Manager üzerinden Command-line Tools'u kurun.

• ANDROID_HOME ve ANDROID_SDK_ROOT aynı anda ayarlanmalı mı?
  Tek bir doğru yol yeterlidir (ANDROID_SDK_ROOT — modern değişken), ancak birçok araç hâlâ ANDROID_HOME okur. Her ikisini de aynı SDK klasörüne ayarlamanız önerilir.

• Studio güncellemesinden sonra derleme aniden çalışmayı durdurdu — neden?
  Genellikle Gradle eklentisi daha yüksek bir compileSdk veya Build Tools güncellemesi gerektirir. Eklenti gereksinimlerini kontrol edin ve SDK/Build Tools'u güncelleyin veya build.gradle içinde uyumlu sürümleri sabitleyin.

Tüm adımlardan sonra hata devam ediyorsa — hatanın tam metnini ve ortamınızı (İS, Studio sürümü, derleme yöntemi: IDE/CLI/CI) belirtin, bu sayede nokta atışı çözüm sunulabilir.