Windows 10'da Android 10 (API 29) Hızlı Kurulumu
Kısaca: Android 10 (API 29) geliştirme yapmak için platforms;android-29 platform paketlerine, platform-tools'a, 29.x sürümündeki build-tools'a ve emülatör için emulator ile system-image'e (x86_64 google_apis önerilir) ihtiyacınız vardır. Aşağıda tam paket listesi, hızlı komutlar ve Windows 10 için PATH/hızlandırma ayarları yer almaktadır.
İndirilecekler ve Minimum Paket Seti
API 29 için APK derleme ve test etme amacıyla şunlar yeterlidir:
- platform-tools — adb ve diğer araçlar.
- platforms;android-29 — Android 10 platformunun kendisi.
- build-tools;29.0.3 (veya en son 29.x) — derleme için.
- emulator — emülatör binary dosyası.
- system-images;android-29;google_apis;x86_64 — x86_64 imajı (emülatörde daha hızlı). İsteğe bağlı: cmdline-tools (sdkmanager/avdmanager), extras;google;usb_driver (ADB sürücüleri).
Windows için x86_64 sistem imajını seçin — ARM imajları çok yavaş çalışacaktır.
Kurulum: GUI (Android Studio) ve sdkmanager ile
Android Studio üzerinden (daha kolay):
- Android Studio'yu açın → Tools → SDK Manager.
- SDK Platforms sekmesinde Android 10.0 (API 29) seçeneğini etkinleştirin → Show Package Details → Android SDK Platform 29 ve gerekli sistem imajlarını işaretleyin.
- SDK Tools sekmesinde Android SDK Build-Tools 29.x, Platform-tools, Emulator ve Command-line Tools seçeneklerini işaretleyin → Apply.
Komut satırı üzerinden (cmdline-tools):
- cmdline-tools'u SDK kök dizinine çıkarın: %ANDROID_HOME%\cmdline-tools\latest\
- Örnek kurulum (PowerShell/cmd'de çalıştırın):
C:\Android\Sdk\cmdline-tools\latest\bin\sdkmanager "platform-tools" "platforms;android-29" "build-tools;29.0.3" "emulator" "system-images;android-29;google_apis;x86_64"
C:\Android\Sdk\cmdline-tools\latest\bin\sdkmanager --licenses
- Kontrol:
C:\Android\Sdk\cmdline-tools\latest\bin\sdkmanager --list
adb --version
Ortam Değişkenleri, AVD ve Emülatör Hızlandırma
Değişkenleri (yönetici haklarıyla) System → Environment Variables üzerinden veya aşağıdaki gibi ayarlayın:
- ANDROID_HOME = C:\Users<USER>\AppData\Local\Android\Sdk PATH'e ekleyin:
- %ANDROID_HOME%\platform-tools
- %ANDROID_HOME%\cmdline-tools\latest\bin
- %ANDROID_HOME%\emulator
setx örneği:
setx /M ANDROID_HOME "C:\Users\%USERNAME%\AppData\Local\Android\Sdk"
setx /M PATH "%PATH%;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\cmdline-tools\latest\bin;%ANDROID_HOME%\emulator"
Hızlandırma:
- Windows 10'da Windows Hypervisor Platform (WHPX) tercih edilir. Windows Features → Windows Hypervisor Platform'u etkinleştirin → yeniden başlatın.
- Alternatifler: Android Emulator Hypervisor Driver (AEHD) veya Intel HAXM (Hyper-V/WPHX'in devre dışı bırakılmasını ve BIOS'ta VT-x'in etkin olmasını gerektirir). Kontrol edin:
emulator -accel-check
AVD Oluşturma:
- GUI: AVD Manager → Create Virtual Device → API 29 imajını seçin (x86_64) → Finish.
- CLI:
avdmanager create avd -n Pixel_API_29 -k "system-images;android-29;google_apis;x86_64" -d "pixel"
emulator -avd Pixel_API_29
CI/otomasyon komut dosyaları planlıyorsanız — yalnızca cmdline-tools + gerekli paketleri kurun ve lisansları --licenses ile kabul edin.
Sık Karşılaşılan Hatalar
- build-tools kurulmuyor — hakları ve SDK yolunun doğruluğunu kontrol edin, sdkmanager'ı tam yol ile tekrar çalıştırın.
- adb bulunamadı — %ANDROID_HOME%\platform-tools'un PATH'te olduğundan emin olun ve yeni bir terminal penceresi açın.
- emülatör yavaş çalışıyor veya başlamıyor — emulator -accel-check komutunu çalıştırın, BIOS'ta sanallaştırmayı etkinleştirin ve konfigürasyona göre x86_64 imaj + WHPX/AEHD/HAXM kullanın.
Windows üzerinde günlük geliştirme için ARM imajı kurmayın — son derece yavaş olacaktır.
SSS
- sdkmanager kullanıyorsam Android Studio kurmam gerekir mi?
Hayır, cmdline-tools yeterlidir ancak Android Studio AVD ve sürücü yönetimini kolaylaştırır. - Hangi build-tools sürümünü seçmeliyim?
API 29 uyumluluğu için 29.0.3 önerilir. - Emülatörün hızlandırmayı kullandığını nasıl kontrol ederim?
emulator -accel-check komutu hangi hızlandırmanın mevcut olduğunu gösterir (WHPX/AEHD/HAXM).
İsterseniz belirtilen SDK klasörüne otomatik kurulum için hazır komutları hazırlayabilir veya belirli parametrelerle (RAM, Play Store vb.) AVD oluşturmanıza yardımcı olabilirim.