Kurulum Sonrası Hızlı Android Studio Yapılandırması

Kısaca: Kurulumdan hemen sonra Android SDK'yı belirtin, zorunlu eklentileri yükleyin, gradle.properties ve wrapper dosyalarını düzenleyin ve IDE'nin temel parametrelerini (bellek, VCS, emülatör) ayarlayın — bu, çoğu derleme hatasını ortadan kaldıracak ve çalışmayı hızlandıracaktır.

SDK Yapılandırması (Android SDK Manager)

1. Şu yolu izleyin: File > Settings (Ctrl+Alt+S) > Appearance & Behavior > System Settings > Android SDK.
2. SDK Platforms sekmesinde şunları işaretleyin:
   • yeni projeler için en son stabil API (örneğin, API 35);
   • uyumluluk için 1–2 eski sürüm (ihtiyaca göre).
3. SDK Tools sekmesinde şunları yükleyin:
   • Android SDK Build-Tools (en son sürüm);
   • Android Emulator;
   • Android SDK Platform-Tools;
   • Intel x86 Emulator Accelerator (HAXM) veya Hypervisor Framework (macOS).
4. SDK yolunu kontrol edin (genellikle ~/Android/Sdk). Manuel olarak değiştirmeyin, gerekirse local.properties dosyasını güncelleyin.

Eklentiler: İlk Yüklenmesi Gerekenler

File > Settings > Plugins > Marketplace yolunu izleyin. Minimum set:

• Kotlin (yüklü değilse) — modern Android projeleri için zorunludur.
• ADB Idea — IDE'den hızlı ADB komutları.
• Key Promoter X — kısayol tuşlarını öğrenmeye yardımcı olur.
• Rainbow Brackets — iç içe geçmiş yapıları daha kolay okumayı sağlar.
• Material Theme UI — rahat bir arayüz için isteğe bağlı.

Yüklemeyi tamamladıktan sonra IDE'yi yeniden başlatın.

Gradle Konfigürasyonu: Kararlılık ve Performans

1. Her zaman Gradle Wrapper (./gradlew) kullanın — derleyici sürümü projeye bağlıdır.
2. Projenin kök dizinindeki gradle.properties dosyasına optimizasyonları ekleyin:

org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
org.gradle.parallel=true
org.gradle.caching=true
android.useAndroidX=true
android.enableJetifier=true

3. settings.gradle (veya settings.gradle.kts) dosyasında depoları tanımlayın:

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    gradlePluginPortal()
  }
}

4. Yavaş ağ bağlantısında Offline work modunu etkinleştirin: File > Settings > Build, Execution, Deployment > Gradle > Offline work.
5. Sync hataları oluşursa — File > Invalidate Caches / Restart işlemini uygulayın ve ardından Sync Project with Gradle Files yapın.

Verimlilik İçin Temel IDE Parametreleri

• Keymap: Settings > Keymap — alışkın olduğunuz şemayı seçin (Android, VS Code).
• Bellek: Help > Edit Custom VM Options veya Gradle için gradle.properties. Büyük projeler için öneri: Xmx4096m.
• Inspections: Settings > Editor > Inspections — gereksiz kontrolleri devre dışı bırakarak yanlış uyarıları azaltın.
• VCS: VCS > Enable Version Control Integration > Git ve SSH/kimlik bilgilerini yapılandırın.
• Emülatör: Device Manager > Create Device — Play Store ile Pixel (API 34+) önerilir; donanım hızlandırmayı etkinleştirin.
• Derleyici: Settings > Build, Execution, Deployment > Compiler — Gradle Daemon ve paralel derlemeyi etkinleştirin.

Ayarların Test Edilmesi

1. Test projesi oluşturun: New Project > Empty Activity.
2. Run > Run 'app' komutuyla emülatörde veya bağlı cihazda çalıştırın.
3. Kontrol edin: Gradle sync hatasız tamamlanır, derleme ve çalıştırma başarılı olur, ADB cihazı görür.

Sık Karşılaşılan Hatalar

• "Gradle sync failed" — genellikle yanlış SDK yolu veya eksik depolardan kaynaklanır.
• Derleme sırasında OutOfMemoryError — org.gradle.jvmargs değerini artırın ve parallel/caching'i etkinleştirin.
• Emülatör başlamıyor — BIOS/UEFI'de sanallaştırmayı etkinleştirin ve HAXM/Hypervisor yükleyin.
• Bağımlılık çakışmaları — build.gradle dosyasındaki bağımlılıkları kontrol edin ve dependencyResolutionManagement kullanın.

SSS

• Projeler için birden fazla SDK gerekir mi? Hayır, tek merkezi SDK (~/Android/Sdk) yeterlidir.
• IDE'nin hızlı yanıt vermesini nasıl sağlarım? Belleği artırın, ağır eklentileri kapatın ve gereksiz inspections'ları devre dışı bırakın.
• Gradle ve AGP'yi güvenli şekilde nasıl güncellerim? Önce Gradle Wrapper'ı güncelleyin, ardından build.gradle dosyasında Android Gradle Plugin'i güncelleyin ve CI üzerinde derlemeyi test edin.