Android Studio için hangi JDK gerekir ve nasıl hızlıca değiştirilir?

Kısaca: 2026 yılında Android Studio ve modern Gradle sürümleri için önerilen JDK, JDK 21 (LTS)'dir. AGP 8.5+ ve Gradle 8.7+ ile uyumludur, derleme hızında avantaj sağlar ve Kotlin ile daha iyi çalışır. Aşağıda nelerin kullanılacağı, nasıl kurulacağı ve Android Studio ile CI ortamında JDK'nın nasıl değiştirileceği açıklanmıştır.

Önerilen ve minimum sürümler (2026)

Notlar: AGP 8.5+, resmi olarak JDK 21 için optimize edilmiştir. Gradle için, 8.7'ye karşılık gelen distributionUrl içeren gradle-wrapper kullanın (örneğin gradle-8.7-bin.zip).

JDK 21'i nasıl kurar ve sistemi nasıl yapılandırırsınız (Windows/macOS/Linux)

1. JDK 21'i indirin ve kurun (Temurin/Eclipse veya lisans kısıtlamaları olmayan başka bir satıcı).
2. JAVA_HOME'u ayarlayın ve PATH'i güncelleyin:
   • macOS / Linux: ~/.bashrc veya ~/.zshrc dosyasına şunu ekleyin export JAVA_HOME=/usr/lib/jvm/temurin-21-jdk export PATH=$JAVA_HOME/bin:$PATH
   • Windows: System Properties → Environment Variables yoluyla JAVA_HOME=C:\Program Files\Temurin\jdk-21 ekleyin ve %JAVA_HOME%\bin değerini PATH'e dahil edin.
3. Kontrol edin:
   • java -version
   • javac -version
   • projede: ./gradlew --version (Gradle'ın hangi JDK'yı kullandığını gösterir)

Android Studio'da ve projede JDK'yı nasıl değiştirirsiniz?

1. Android Studio'da: File → Settings (veya macOS'ta Preferences) → Build, Execution, Deployment → Build Tools → Gradle.
   • Gradle JDK alanında listeden JDK 21'i seçin veya Add JDK'a tıklayarak kurulu JDK 21'in yolunu belirtin.
2. Derleyici için: File → Settings → Build, Execution, Deployment → Compiler → Java Compiler → gerekirse Project bytecode version = 21 olarak ayarlayın.
3. gradle.properties dosyasında (projenin kök dizininde) açıkça şu şekilde belirtebilirsiniz: org.gradle.java.home=/path/to/jdk-21 org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=512m
4. Projeyi senkronize edin: Sync Project with Gradle Files → ardından ./gradlew clean build.

CI ve JDK sürüm yönetimi araçları

• CI ortamında (GitHub Actions, GitLab CI vb.) Java kurulum adımında Java 21'i belirtin (actions/setup-java veya benzeri).
• Yerel JDK değiştirmek için SDKMAN (sdk install java 21.x; sdk use java 21.x) veya jenv kullanmak uygundur.
• Projenizdeki Gradle wrapper'ın güncel olduğundan emin olun: gradle/wrapper/gradle-wrapper.properties dosyasını açın ve gerekli distributionUrl sürümünü ayarlayın.

Sık karşılaşılan hatalar

• Unsupported class file version 65 — JDK sürümü ile bytecode arasında uyumsuzluk olduğunu gösterir; bytecode 21 ise JDK 21 kullanın.
• JAVA_HOME is set to an invalid directory — yolu ve erişim izinlerini kontrol edin.
• Karışık JDK'lar: IDE bir sürüm kullanırken, Gradle başka bir sürüm kullanıyor. Çözüm: org.gradle.java.home değerini belirtin ve IDE ayarlarında Gradle JDK'yı değiştirin.

SSS

• Eski projeler için JDK 21 gerekli mi? Hayır, eski projeler geçici olarak JDK 17 üzerinde derlenebilir, ancak yeni Gradle/AGP ile uyumluluk için 21'e geçmek daha iyidir.
• Amazon Corretto veya başka bir satıcının OpenJDK'sını kullanabilir miyim? Evet, ancak 2026 yılında Temurin/Adoptium, Gradle/AGP ile uyumluluk açısından en çok test edilmiş seçenektir.
• JDK değiştirdikten sonra CI başarısız olursa ne yapmalı? Runner'ın JDK 21 kullandığından ve gradle-wrapper'ın güncel olduğundan emin olun; derleme önbelleğini temizleyin.