Legacy projeler için Android Studio 2'yi nasıl kurup yapılandırırsınız?

Proje Android Gradle Plugin 1.x–2.x, eski build-tools veya Jack kullanıyorsa, Android Studio 2'yi paralel olarak kurmak daha kolaydır: IDE'yi ayrı bir klasöre yükleyin, ayrı bir SDK (ve JDK 8) oluşturun, gerekli AVD'yi yaratın veya gerçek cihaz kullanın — adım adım aşağıda.

Android Studio 2 gerçekten ne zaman gerekir?

• Proje AGP 1.x–2.x ve uyumlu Gradle sürümlerini (genellikle Gradle 2.14.1–3.5) gerektiriyorsa ve eski araçlar (Jack, eski NDK eklentileri, belirli build-tools 23.x–24.x) kullanılıyorsa gerekir.
• Yeni IDE'ye geçiş çok sayıda manuel düzenleme gerektirecek ve derlemeyi bozma riski taşıyacaksa, destek ve testler için eski Android Studio'yu bırakın; yeni özelliklerin aktif geliştirmesi için yeni sürümü kullanın.

Paralel kurulum ve ayrı SDK

1. İndirme ve sürüm seçimi

• Android Studio 2.x'i resmi Google arşivinden indirin ve project/build.gradle içinde com.android.tools.build:gradle:2.3.x belirtilmişse 2.3.x dalını hedefleyin.

2. Ayrı dizine kurulum

• Windows: C:\Android\AndroidStudio2.3\
• macOS: Uygulamayı Android Studio 2.app olarak yeniden adlandırın
• Linux: ~/apps/android-studio-2/ Yeni Android Studio'yu silmeyin — her iki kurulumu da saklayın.

3. Ayrı SDK

• Legacy SDK için bir dizin oluşturun:
  • Windows: C:\Android\sdk-legacy\
  • macOS/Linux: ~/Android/sdk-legacy/
• Android Studio 2'yi ilk çalıştırdığınızda «Do not import settings» seçeneğini seçin ve sdk-legacy yolunu belirtin.
• SDK Manager aracılığıyla gerekli API'leri (compileSdkVersion/targetSdk) ve build.gradle'da belirtilen tam build-tools sürümlerini indirin.

4. JDK

• JDK 8'i yükleyin ve File → Project Structure → SDK Location altında JDK 8 yolunu belirtin. Yeni JDK'lar (11/17) genellikle Android Studio 2 ile çakışır.
• Gerekirse, yalnızca eski projeyi derlediğiniz oturumda/komut dosyasında JAVA_HOME'u JDK 8'e ayarlayın.

Projeyi içe aktarma ve emülatör yapılandırması

1. Projeyi açma

• Android Studio 2'yi başlatın → Import project (Gradle, Eclipse ADT, vb.) veya Open → projenin kök dizinini belirtin (settings.gradle veya üst düzey build.gradle).
• Dizin oluşturulmasını ve ilk Gradle senkronizasyonunu bekleyin.

2. Hemen kontrol edilmesi gerekenler

• app/build.gradle dosyasını açın ve şunları not edin: compileSdkVersion, buildToolsVersion, targetSdkVersion, AGP sürümü (classpath com.android.tools.build:gradle:X).
• gradle/wrapper/gradle-wrapper.properties içinde gerekli Gradle sürümünü kontrol edin ve gerekirse gradle-wrapper.zip dosyasını buna göre ayarlayın.

3. AVD ve emülatör

• Tools → Android → AVD Manager. Yoksa SDK Manager üzerinden yükleyin.
• Gerekli API'ler için AVD'ler oluşturun (eski projeler için genellikle API 19–23). x86 imajlarını seçin ve makul performans için donanım sanallaştırmayı (Intel HAXM/Hyper-V/AMD SVM) etkinleştirin.
• Düşük donanımlı makinelerde emülatörün RAM ve dahili depolama alanını azaltın; hata ayıklama için USB hata ayıklaması etkinleştirilmiş gerçek cihaz kullanmak daha kolaydır.

4. Hata ayıklama ve derleme

• Eksik build-tools ile ilgili hatalar çıkarsa, SDK Manager üzerinden tam olarak o sürümü yükleyin.
• Sonuçlarını tam olarak anlamadan Android Studio 2 içinde AGP ve Gradle'ı en son sürümlere yükseltmeyin.

Sık karşılaşılan hatalar

• Failed to find Build Tools revision X.X.X — tam olarak aynı build-tools sürümünü yükleyin.
• Gradle version X is required — gradle-wrapper.properties dosyasını kontrol edin ve AGP'niz için önerilen Gradle sürümünü kullanın.
• Eklenti çakışmaları (Jack, eski NDK) — bunları hemen silmeyin; önce «yerel» ortamda derlemeyi başarıyla tamamlayın.
• IDE yeni Android Studio'nun ayarlarını içe aktarmaya çalışıyor — ilk çalıştırmada «Do not import settings» seçeneğini belirleyin.

SSS

• Yeni Android Studio'yu silmem gerekir mi?
  Hayır. Her iki IDE'yi de paralel tutun ve görevlere göre geçiş yapın.

• Projeyi yeni Android Studio'ya güvenli şekilde nasıl taşırım?
  İki dal ile çalışın: Android Studio 2 için legacy dalı ve migrasyon için main dalı; her ortamda başarılı derlemeden sonra değişiklikleri yamalar halinde taşıyın.

• Her iki Android Studio için tek bir SDK kullanabilir miyim?
  Teorik olarak evet, ancak çakışma riski yüksektir. Yeni IDE için ayrı sdk-legacy ve sdk kullanmanızı öneririm.

• Emülatör yavaş çalışıyorsa ne yapmalıyım?
  Donanım sanallaştırma ile x86 imajlarını kullanın veya gerçek cihaz üzerinde test edin.

İsterseniz, işletim sisteminize (Windows/macOS/Linux) özel kısa bir kontrol listesi hazırlayabilirim veya build.gradle dosyanıza göre tam build-tools ve Gradle sürümlerini seçmenize yardımcı olabilirim.