Hızlı Başlangıç: Android Studio ve Android SDK Kurulumu

Kısaca: Android Studio'yu indirin, kurun (JDK dahildir), SDK Manager aracılığıyla platform-tools'u, gerekli Android platformlarını ve emülatör imajını kurun, AVD'yi yapılandırın ve projeyi çalıştırın. Aşağıda Windows, macOS ve Linux için kontrollerle birlikte adım adım talimatlar yer almaktadır.

Hazırlık ve Gereksinimler

• Sistem kontrolü: Minimum 8 GB RAM (16 GB önerilir), 10+ GB boş disk alanı, etkinleştirilmiş sanallaştırma (Intel VT-x veya AMD-V).
• JDK: Android Studio yerleşik OpenJDK içerir — ek kurulum gerekmez.
• Kurulum sırasında ve sürücü yapılandırmasında (Windows'ta) yönetici hakları.
• Windows'ta Windows Hypervisor Platform'un etkinleştirilmesi veya destekleniyorsa Intel HAXM'nin kurulması önerilir. macOS'ta Hypervisor.framework kullanılır.

Adım Adım Kurulum

1. İndirme:
   • Android Studio indirme sayfasına gidin ve işletim sisteminiz için yükleyiciyi seçin.
2. Kurulum:
   • Windows: .exe dosyasını çalıştırın, sihirbazı takip edin, Android SDK ve AVD kurulumu için onay kutusunu işaretli bırakın.
   • macOS: .dmg dosyasını açın ve Android Studio'yu Applications klasörüne sürükleyin.
   • Linux: Arşivi çıkarın, bin klasöründen studio.sh dosyasını çalıştırın.
3. İlk başlatma ve SDK yapılandırması:
   • İlk başlatmada standart (Recommended) yapılandırmayı seçin.
   • SDK Manager'ı açın (Configure → SDK Manager) ve şunları kurun:
     • Android SDK Platform-tools
     • En son SDK Platform (örneğin, Android 14)
     • Android SDK Build-Tools (en son sürüm)
     • Android Emulator ve sistem imajları (emülatör için ARM/x86_64)
4. Ortam değişkenlerinin yapılandırılması (CLI için gerekiyorsa):
   • ANDROID_SDK_ROOT = SDK yolu (genellikle Windows'ta %LOCALAPPDATA%\Android\Sdk, macOS'ta ~/Library/Android/sdk, Linux'ta ~/Android/Sdk).
   • PATH'e ekleyin: platform-tools (adb komutlarının çalışması için).
   • Örnekler:
     • Windows (PowerShell): [Environment]::SetEnvironmentVariable("ANDROID_SDK_ROOT","C:\Users\İsim\AppData\Local\Android\Sdk","User")
     • macOS/Linux (bash): export ANDROID_SDK_ROOT="$HOME/Library/Android/sdk" && export PATH="$ANDROID_SDK_ROOT/platform-tools:$PATH"
5. AVD oluşturma ve çalıştırma:
   • AVD Manager → Create Virtual Device → cihaz ve imaj seçimi → Finish.
   • AVD'yi başlatın ve yüklenmesini bekleyin.

İlk Proje ve Çalışabilirlik Kontrolü

1. Yeni proje oluşturun: File → New → New Project → Empty Activity.
2. Fiziksel bir cihaz bağlayın (USB hata ayıklamayı etkinleştirin) veya oluşturduğunuz AVD'yi kullanın.
3. Run'a tıklayın (Shift+F10). Cihaz görünmüyorsa:
   • Terminalde adb devices komutunu kontrol edin.
   • USB sürücüsünü kurun (Windows).
4. Terminalden derleme kontrolü:
   • gradlew assembleDebug (Windows: gradlew.bat, macOS/Linux: ./gradlew)
   • Başarılı derlemeden sonra apk dosyasını app/build/outputs/apk/debug/ klasöründe bulun.

Sık Karşılaşılan Hatalar

• "adb not found" — platform-tools PATH'e eklenmemiş veya ANDROID_SDK_ROOT yanlış belirtilmiş.
• Emülatör başlamıyor — sanallaştırmanın etkin olup olmadığını ve x86/x86_64 imajının kurulduğunu kontrol edin.
• Cihaz sürücüsü kurulmamış (Windows) — OEM sürücüsünü kurun veya cihazda geliştirici modunu etkinleştirin.
• Build Tools/Gradle sürüm çakışması — build.gradle dosyasındaki sürümleri güncelleyin veya SDK Manager aracılığıyla gerekli sürümü kurun.

SSS

• Ayrı bir JDK kurmak gerekir mi?
  Hayır: Android Studio OpenJDK içerir, genellikle ek kurulum gerekmez.

• Kurulumdan sonra SDK'yı nerede bulabilirim?
  Varsayılan olarak: Windows — %LOCALAPPDATA%\Android\Sdk, macOS — ~/Library/Android/sdk, Linux — ~/Android/Sdk.

• Derlemeleri nasıl hızlandırabilirim?
  Gradle Daemon'u etkinleştirin, önbelleğe almayı yapılandırın (Gradle build cache) ve SSD ile minimum 8–16 GB RAM kullanın.

• AVD donarsa ne yapmalıyım?
  Emülatörü yeniden başlatın, sistem imajını güncelleyin veya AVD Manager'da Cold Boot'u deneyin.