Android SDK Yapılandırması: Hızlı Pratik Rehber

Kısa cevap: Android Studio'yu yükleyin, SDK Manager aracılığıyla gerekli SDK Platformları ve SDK Araçlarını (Build-Tools, Platform-Tools, Emulator) seçin, File → Project Structure → SDK Location bölümünde SDK yolunu belirtin ve ANDROID_HOME/ANDROID_SDK_ROOT ile platform-tools ve emulator için PATH değişkenlerini ekleyin. Kontrol: adb version ve test projesinin derlenmesi.

Android Studio Kurulumu ve İlk Adımlar

1. Android Studio'yu yükleyin (yükleyici ~1 GB) ve başlatın.
2. Welcome ekranında More Actions → SDK Manager seçeneğini seçin.
3. SDK Platforms sekmesinde gerekli API'leri işaretleyin (örneğin, modern uygulamalar için API 35; testler için 1–2 ek sürüm bırakın).
4. SDK Tools sekmesinde şunları işaretleyin:
   • Android SDK Build-Tools (en son stabil sürüm),
   • Android SDK Platform-Tools (adb, fastboot),
   • Android Emulator,
   • Intel x86 Emulator Accelerator (HAXM) — Intel üzerinde hızlandırma gerekiyorsa,
   • (isteğe bağlı) sdkmanager için Android SDK Tools / tools/bin.
5. Apply düğmesine tıklayın — indirme boyutu seçilen bileşenlere bağlıdır (2–10 GB).

Yolların ve Ortam Değişkenlerinin Yapılandırılması

Android Studio genellikle SDK'yı otomatik olarak algılar, ancak komut satırı ve üçüncü taraf araçlar (React Native, Flutter) için değişkenlerin ayarlanması gerekir.

Windows:

• Denetim Masası → Sistem → Gelişmiş sistem ayarları → Ortam Değişkenleri'ni açın.
• Sistem değişkenlerinde şunları ekleyin/kontrol edin:
  • ANDROID_HOME = C:\Users<KullanıcıAdınız>\AppData\Local\Android\Sdk
  • ANDROID_SDK_ROOT = %ANDROID_HOME%
• PATH'e şunları ekleyin (; ile ayırarak):
  • %ANDROID_HOME%\platform-tools
  • %ANDROID_HOME%\emulator
  • %ANDROID_HOME%\tools\bin

macOS / Linux (.bash_profile / .zshrc): export ANDROID_HOME=$HOME/Library/Android/sdk export ANDROID_SDK_ROOT=$ANDROID_HOME export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools/bin source ~/.zshrc

Android Studio'da: File → Project Structure → SDK Location — Sdk yolunu belirtin; JDK Location genellikle dahili olarak gelir: /jbr.

Kontrol, Komutlar ve Bileşenlerin Otomatik Yüklenmesi

• adb'yi kontrol edin: adb version
• sdkmanager ile mevcut listeyi görüntüleme ve yükleme:
  • sdkmanager --list
  • sdkmanager "platforms;android-35" "build-tools;35.0.0"
• Projede local.properties dosyasını belirtebilirsiniz:
  • sdk.dir=C:\Users\<İsim>\AppData\Local\Android\Sdk

Sık Karşılaşılan Hatalar

• "SDK location not found" — File → Project Structure veya local.properties içindeki yolu kontrol edin.
• "Failed to find Build Tools" — SDK Manager'da gerekli Build-Tools sürümünü yükleyin.
• adb cihazı görmüyor — cihazda USB Debugging'i etkinleştirin, adb kill-server && adb start-server komutunu çalıştırın.
• Emulator başlamıyor — BIOS'ta sanallaştırmayı etkinleştirin (VT-x/AMD-V); Windows'ta HAXM kullanıyorsanız Hyper-V'yi devre dışı bırakın.
• HAXM çakışmaları — AMD/Modern Intel için Android Emulator Hypervisor Driver'ı kullanın veya Hypervisor uyumlu sürücüye geçiş yapın.

SSS

• Tüm platformları yüklemek gerekiyor mu? Hayır — hedef platform ve test için bir tane yeterlidir; sadece gerekli sürümleri tutun.
• Mac'te SDK nerede bulunur? Varsayılan olarak ~/Library/Android/sdk.
• CLI üzerinden hızlıca nasıl yüklenir? tools/bin içindeki sdkmanager'ı kullanın.

Yeni bir Empty Project oluşturun ve derleyin — derleme ve emülatörde/cihazda çalıştırma başarılı olursa, yapılandırma tamamlanmıştır. Hala hatalar varsa, kesin tavsiye için işletim sistemi, Android Studio sürümü ve hata metnini belirtin.