Android SDK Manager ile platformları indirme ve bileşenleri güncelleme
Platformları indirmek ve Build Tools'u güncellemek için — Android Studio'da SDK Manager'ı açın veya terminalde sdkmanager'ı kullanın: gerekli API'leri ve Build Tools sürümlerini seçin, Apply'a tıklayın veya sdkmanager "platforms;android-XX" "build-tools;XX" komutunu çalıştırıp lisansları kabul edin.
SDK Manager'ı Açma
- Android Studio'da: File > Settings (veya Preferences) > Appearance & Behavior > System Settings > Android SDK. Alternatif olarak araç çubuğundaki SDK Manager simgesine tıklayabilirsiniz.
- Komut satırında: sdkmanager aracını kullanın, bu araç <SDK_ROOT>/cmdline-tools/latest/bin/sdkmanager konumunda bulunur.
SDK Platforms/Tools sekmesinde Show Package Details seçeneğini etkinleştirin — bu, Build Tools'un tam alt sürümlerini ve emülatör için sistem imajlarını seçmenizi sağlar.
Platformları ve Build Tools'u indirme adımları
- SDK Platforms sekmesinde gerekli API'yi işaretleyin (örneğin, Android 14 — android-34). Emülatör için uygun bir sistem imajı seçin (x86_64, Google Play / Google APIs).
- Show Package Details'e tıklayın ve gerekli alt paketleri seçin (Sources, Intel x86_64 imajı vb.).
- SDK Tools sekmesine geçin ve Android SDK Build-Tools'u işaretleyin — 1–2 güncel sürüm seçin.
- Apply → OK tıklayın. Kurulum, dosyaları <SDK_ROOT>/platforms ve <SDK_ROOT>/build-tools dizinlerine indirecektir.
Terminal üzerinden (CI için hızlı ve kullanışlı):
- Platform kurulumu: sdkmanager "platforms;android-34"
- Build Tools kurulumu: sdkmanager "build-tools;35.0.1"
- Her şeyi güncelleme: sdkmanager --update
- Lisansları kabul etme: sdkmanager --licenses
CI kullanıyorsanız, ANDROID_SDK_ROOT veya ANDROID_HOME ortam değişkenleri aracılığıyla SDK yolunu belirtmeyi unutmayın.
Popüler Build Tools sürümlerinin karşılaştırılması
| Sürüm | Özellik | Önerilen kullanım |
|---|---|---|
| 35.0.1 | AGP 8.5+ desteği, R8 iyileştirmeleri | Android 15+ projeleri |
| 34.0.0 | Android 14 için stabil | Güncel stabil projeler |
| 33.0.2 | Eski derlemelerle uyumluluk | Eski/legacy projeler |
Mevcut tüm Build Tools sürümlerini kurmayın — disk alanı kaplarlar. Projeleriniz için 2–3 güncel sürümü bırakın.
Güncelleme ve otomasyon
- Android Studio'da: SDK Manager'da Check Now'a tıklayın ve işaretli bileşenleri güncelleyin.
- CI'da: Derlemeden önce sdkmanager --update ve sdkmanager --licenses komutlarını çalıştırın. ANDROID_SDK_ROOT ve PATH değişkenlerinin yapılandırıldığından emin olun (platform-tools ve cmdline-tools'u dahil edin).
- Yavaş indirmeler için: SDK Update Sites'e yansılar ekleyin veya Studio ayarlarında HTTP Proxy'yi yapılandırın.
Sık Karşılaşılan Hatalar
- "SDK location not found" — File > Project Structure > SDK Location üzerinden veya ANDROID_SDK_ROOT ile yolu belirtin.
- Lisanslar kabul edilmedi — sdkmanager --licenses komutunu çalıştırın.
- Yavaş indirme — proxy/internet sağlayıcınızı kontrol edin, yansılar kullanın.
- Gradle'de sürüm çakışmaları — build.gradle dosyasında uyumlu AGP ve buildToolsVersion sürümlerini belirtin.
- Diskte yeterli alan yok — platformlar ve imajlar gigabaytlarca yer kaplar, alanı önceden planlayın.
SSS
- Hangi Build Tools sürümlerini tutmalıyım? AGP sürümünüzle uyumlu bir stabil sürüm ve eski projeler için bir-iki sürüm bırakın.
- Projede Build Tools nasıl belirtilir? build.gradle dosyasında: android { buildToolsVersion "35.0.1" } — genellikle modern AGP kullanıyorsanız belirtmeniz gerekmez.
- CI'da nasıl otomatize edilir? SDK'ya cmdline-tools'u kurun, PATH'e ekleyin, derlemeden önce sdkmanager --update ve sdkmanager "platforms;android-34" komutlarını çalıştırın, lisansları --licenses ile kabul edin.
Gerekirse — belirli bir SDK sürümü için komutlar, CI yapılandırma örnekleri veya kurulu SDK'nın boyutunu nasıl küçülteceğiniz konusunda yardımcı olabilirim.