Android Studio 3 Kurulumu: Hızlı ve Sorunsuz

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

Kısaca: Resmi arşivden ihtiyacınız olan Android Studio 3.x arşivini indirin, IDE'yi kurun, ardından SDK Manager aracılığıyla platform-tools, gerekli platformları, build-tools ve system image'leri yükleyin; ANDROID_SDK_ROOT ve PATH değişkenlerini yapılandırın ve donanım hızlandırmayı (HAXM veya WHPX) etkinleştirin. Aşağıda pratik adımlar ve kanıtlanmış hata çözümleri yer almaktadır.

Hazırlık ve Gereksinimler

  • Alan ve bellek: Emülatörle rahat çalışmak için en az 8 GB boş disk alanı ve 8 GB RAM ayırın.
  • JDK: AS 3.x üzerindeki çoğu proje için Java 8 idealdir — build.gradle dosyasını ve AGP gereksinimlerini kontrol edin.
  • Sanallaştırma: BIOS/UEFI içinde VT-x/AMD-V özelliğini önceden etkinleştirin (emülatör başlamıyorsa bunun güvenilir bir nedeni olabilir).

Eski bir proje için sadece AS 3.x'e ihtiyacınız varsa — Android Studio'nun resmi sürüm arşivini (Older releases) kullanın.

İndirme, Kurulum ve Temel Yapılandırma

  1. Android Studio 3.x sürüm arşivinden .exe/.dmg/tar.gz dosyasını indirin; işletim sisteminize uygun standart yöntemle çıkarıp kurun.
  2. Kurulum sırasında SDK yoksa: Android Studio'yu başlatın → Welcome → Configure → SDK Manager yolunu izleyerek şunları yükleyin:
    • Android SDK Platform (compileSdk ile eşleşen sürüm)
    • Android SDK Platform-tools
    • Android SDK Build-tools (ilgili sürüm)
    • SDK Tools / Command-line tools
    • Emülatör için x86/x86_64 System Image
  3. JDK'yı yükleyin (gerekirse) ve Android Studio'da belirtin: File → Project Structure → SDK Location → JDK location.

Ortam değişkenleri örnekleri (Linux / macOS ~/.bashrc veya ~/.zshrc):

export ANDROID_SDK_ROOT="$HOME/Android/Sdk"
export PATH="$PATH:$ANDROID_SDK_ROOT/platform-tools:$ANDROID_SDK_ROOT/tools/bin"

Windows: ANDROID_SDK_ROOT değişkenini System Properties üzerinden ayarlayın ve %ANDROID_SDK_ROOT%\platform-tools dizinini PATH'e ekleyin.

AVD Oluşturma, Donanım Hızlandırma ve Emülatörü Başlatma

  • Tools → AVD Manager → Create Virtual Device yolunu izleyin; x86/x86_64 imajını seçin (çok daha hızlıdır).
  • Donanım hızlandırma:
    • Intel: HAXM (SDK Manager → Extras → Intel HAXM paketini yükleyin, ardından intelhaxm-installer'ı manuel olarak çalıştırın).
    • Windows 10/11: Tercihen WHPX — Windows bileşenlerinde "Windows Hypervisor Platform" özelliğini etkinleştirin; geçiş yaparken HAXM'i kaldırın.
  • Yaygın hata: "x86 emulation currently requires hardware acceleration" — VT-x/AMD-V durumunu, Hyper-V/Hypervisor varlığını ve HAXM/WHPX kurulumunu kontrol edin.

Emülatör yavaşsa, x86_64 imajını kullanın ve AVD ayarlarında RAM/VM heap değerini artırın veya hata ayıklama için fiziksel bir cihaz bağlayın.

Hızlı Kontroller ve Faydalı Komutlar

  • adb:
adb version
adb devices
adb kill-server && adb start-server
  • sdkmanager ile bileşen yükleme:
sdkmanager "platform-tools" "platforms;android-29" "build-tools;29.0.3"
  • HAXM kontrolü (Windows PowerShell):
sc query intelhaxm

Yaygın Hatalar

  • SDK yüklenmiyor / düğmeler pasif: Yükleyiciyi veya Android Studio'yu yönetici olarak çalıştırın (Windows) ya da sudo yetkileriyle (Linux); SDK klasörü üzerindeki izinleri kontrol edin.
  • HAXM yüklenmiyor: BIOS'ta VT-x/AMD-V özelliğini etkinleştirin; Windows'ta Hyper-V/Device Guard ile çakışma kurulumu engelleyebilir.
  • adb cihazı görmüyor: Cihazda USB hata ayıklamayı etkinleştirin, kabloyu/portu değiştirin, OEM USB sürücüsünü yükleyin (Windows), adb kill-server/start-server komutlarını çalıştırın.
  • Gradle senkronizasyon hataları: AGP ↔ Gradle uyumluluğunu kontrol edin (gradle/wrapper/gradle-wrapper.properties), ~/.gradle/caches ve wrapper/dists önbelleklerini temizleyin, JDK sürümünün doğru olduğundan emin olun.
  • sdkmanager ClassNotFound veya tools not found hatası: command-line tools'un yüklü olduğundan ve PATH'in /tools/bin dizinini içerdiğinden emin olun.

"Bir Şey Çalışmıyorsa" Kontrol Listesi

  • IDE'deki Build / Event Log günlüklerine göz atın.
  • Konsolda ./gradlew assembleDebug komutunu çalıştırın — hata mesajları genellikle daha açıklayıcıdır.
  • File → Invalidate Caches / Restart seçeneğini kullanın.
  • Önbellek bozulmasından şüpheleniyorsanız ~/.gradle/caches ve wrapper/dists dizinlerini silin.
  • ANDROID_SDK_ROOT, PATH, JAVA_HOME değişkenlerini ve Project Structure içindeki JDK tanımını kontrol edin.

AS 3.x ve modern imajlarla çalışmak araç uyumsuzluklarına (emülatör/adb) yol açabilir. Mümkünse değişiklikleri izole bir ortamda test edin ve Gradle/AGP sürümlerini sabitleyin.

SSS

  • Kesinlikle AS 3.x'e mi ihtiyacım var?
    Sadece proje eski bir AGP/Gradle sürümü veya bağımlılık gerektiriyorsa; aksi takdirde IDE'nin güncel sürümünü kullanmak daha iyidir.
  • Emülatörün neden başlamadığını hızlıca nasıl kontrol edebilirim?
    Android Studio'daki emülatör çıktısına bakın (Run → Emulator), donanım hızlandırmayı ve adb günlüklerini kontrol edin.
  • WHPX üzerine HAXM yükleyebilir miyim?
    Önerilmez — çakışmalar oluşabilir; tek bir donanım hızlandırma mekanizması kullanın.

Gerekirse — işletim sisteminize göre SDK bileşenlerini yüklemek ve ortam değişkenlerini ayarlamak için betikler (PowerShell / bash) hazırlayabilirim veya belirli bir hata günlüğünü analiz edebilirim (metni yapıştırın).