Android SDK Platformları: Android Studio'da Nedir ve Hangi Sürümler Yüklenmelidir

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

Android SDK Platformları, uygulamanın belirli bir API seviyesi için derlendiği dosya setidir (android.jar, sistem dosyaları, dokümantasyon). En son kararlı platformu (compileSdk/targetSdk için) ve 1-2 önceki sürümü yükleyin; eski API'leri yalnızca proje gerektiriyorsa yükleyin.

Android SDK Platformları Nedir ve Nerede Bulunur

Android SDK Platformu = Android'in her sürümü için bir dosya paketi (pazarlama adı ↔ API seviyesi). Derleyici, emülatörler ve testler için gereklidir. Paket genellikle şunları içerir: android.jar, meta veriler, isteğe bağlı dokümantasyon.

Nereden yönetilir:

  • Android Studio → File → Settings → Appearance & Behavior → System Settings → Android SDK.
  • Sekmeler: "SDK Platforms" — sürümler, "SDK Tools" — platform-tools, build-tools, NDK vb.

Projenizin belirtilen compileSdk/targetSdk ile derlenebilmesi için platform kurulumu gereklidir; minSdk yerel bir platform gerektirmez.

API seviyesi — teknik numaradır (33, 34). Android sürümü (13, 14) — pazarlama adıdır.

Hangi Sürümler Yüklenmeli: Kurallar ve Pratik Örnekler

Temel kurallar:

  • compileSdk — mümkün olan en güncel kararlı sürümü yükleyin (yeni API'lere erişim sağlamak için).
  • targetSdk — test sırasında güncel sürüme yükseltin; Google yayınlama için güncelliği şart koşar.
  • minSdk — iş ihtiyaçları için mümkün olduğunca düşük tutun, ancak kod desteğini göz önünde bulundurun (backportlar, kontroller).

Farklı senaryolar için öneriler:

  • Yeni proje: En son kararlı platformu + 1-2 önceki sürümü (örneğin, API 34, 33, 31/32) ve 1-2 emülatörü (en son + yaygın olan) yükleyin.
  • Mevcut proje: app/build.gradle dosyasını açın ve compileSdk içinde belirtilen platformu yükleyin. compile/target sürümünü yükseltmek istiyorsanız test edin, çünkü bu uygulamaların davranışını değiştirebilir.
  • Çok eski cihazların desteklenmesi: Eski platformları yalnızca gerçek bir ihtiyaç durumunda yükleyin (kurumsal yazılım, terminaller, özel hatalar).

Proje android-34 gerektiriyorsa — SDK Manager aracılığıyla SDK Platform API 34'ü yükleyin; yeni bir platform yüklemekten kaçınmak için compileSdk'i düşürmeyin.

Alan Tasarrufu ve SDK Yönetimi

Tasarruf uygulamaları:

  • Kullanılmayan platformları SDK Manager'da silin (projelerinizin compileSdk değerine göre).
  • 1-3 emülatör imajı tutun (en son + bir kararlı + varsa gerçek cihaz).
  • SDK'yı daha büyük kapasiteli bir diske taşıyın ve Android Studio ayarlarında yolu belirtin; CLI kullanırken ANDROID_SDK_ROOT'u güncelleyin.
  • Ağır derlemeler ve testler için CI kullanın, yerel olarak minimum seti tutun.

Yeni API'leri kasıtlı olarak test etmiyorsanız, üretim ortamında Preview/Canary platformlarını yüklemeyin.

Sık Yapılan Hatalar

  • Sorumluluktan kaçmak: Yeni bir platform yüklemekten kaçınmak için compileSdk'i düşürmek — güvenlik açıklarına ve uyumsuzluklara yol açar.
  • "Yedek olarak" onlarca emülatör yüklemek — disk alanı ve güncelleme zamanı israfı.
  • Gerekli platformu yüklemeden projeyi çalıştırmaya çalışmak — "Failed to find target with hash string 'android-XX'" gibi derleme hatası.

SSS

  • minSdk için platform yüklemek gerekir mi?
    Hayır: minSdk minimum desteği tanımlar; derleme için compileSdk/targetSdk önemlidir.

  • Proje yerelde bulunmayan bir API gerektiriyorsa ne yapılmalı?
    SDK Manager → SDK Platforms bölümünü açın → gerekli API'yi yükleyin ve derlemeyi yeniden başlatın.

  • Emülatörler için hangi imaj seti seçilmeli?
    2-3 adet yeterlidir: en yenisi, pazarda en yaygın olanı ve özel testler için bir tane (örneğin, düşük donanımlı).

Kısa kontrol listesi: Yeni proje için — en son platform + 1-2 önceki; eski proje için — Gradle'da belirtileni yükleyin; emülatörleri yöneterek ve SDK'yı ayrı bir diske taşıyarak alan tasarrufu yapın.