Versi Java dalam build Android

Baik kode sumber Anda ditulis di Java, Kotlin, atau keduanya, ada beberapa tempat yang mengharuskan Anda memilih versi bahasa JDK atau Java untuk build.

Glosarium

Java Development Kit (JDK)

Java Development Kit (JDK) berisi:

• Alat, seperti compiler, profiler, dan pembuat arsip. Class ini digunakan di belakang layar selama build Anda untuk membuat aplikasi.
• Library berisi API yang dapat Anda panggil dari kode sumber Kotlin atau Java. Perhatikan bahwa tidak semua fungsi tersedia di Android.
• Java Virtual Machine (JVM), penafsir yang menjalankan aplikasi Java. Anda dapat menggunakan JVM untuk menjalankan Android Studio IDE dan alat build Gradle. JVM tidak digunakan di emulator atau perangkat Android.

JetBrains Runtime (JBR)

JetBrains Runtime (JBR) adalah JDK yang ditingkatkan, yang didistribusikan dengan Android Studio. Rilis ini mencakup beberapa pengoptimalan untuk digunakan di Studio dan produk JetBrains terkait, tetapi juga dapat digunakan untuk menjalankan aplikasi Java lainnya.

Bagaimana cara memilih JDK untuk menjalankan Android Studio?

Sebaiknya gunakan JBR untuk menjalankan Android Studio. Android Studio ini di-deploy dan digunakan untuk menguji Android Studio, serta menyertakan peningkatan kualitas untuk penggunaan Android Studio yang optimal. Untuk memastikan hal ini, jangan tetapkan variabel lingkungan STUDIO_JDK.

Skrip startup untuk Android Studio mencari JVM dalam urutan berikut:

1. Variabel lingkungan STUDIO_JDK
2. Direktori studio.jdk (di distribusi Android Studio)
3. Direktori jbr (JetBrains Runtime), dalam distribusi Android Studio. Disarankan.
4. Variabel lingkungan JDK_HOME
5. Variabel lingkungan JAVA_HOME
6. java dapat dieksekusi dalam variabel lingkungan PATH

Bagaimana cara memilih JDK yang menjalankan build Gradle saya?

Jika Anda menjalankan Gradle menggunakan tombol di Android Studio, JDK yang ditetapkan dalam setelan Android Studio akan digunakan untuk menjalankan Gradle. Jika Anda menjalankan Gradle di terminal, baik di dalam maupun di luar Android Studio, variabel lingkungan JAVA_HOME (jika ditetapkan) akan menentukan JDK yang menjalankan skrip Gradle. Jika JAVA_HOME tidak ditetapkan, perintah java akan digunakan pada variabel lingkungan PATH Anda.

Untuk mendapatkan hasil yang paling konsisten, pastikan Anda menetapkan variabel lingkungan JAVA_HOME, dan konfigurasi JDK Gradle di Android Studio ke JDK yang sama.

Catatan: Jika Anda menjalankan perintah Gradle di Terminal Android Studio dengan mengklik kanan dan memilih Jalankan perintah yang ditandai menggunakan IDE, maka perintah tersebut akan menggunakan JDK di setelan Android Studio, bukan JAVA_HOME.

Saat menjalankan build, Gradle akan membuat proses yang disebut daemon untuk menjalankan build yang sebenarnya. Proses ini dapat digunakan kembali, selama build menggunakan versi JDK dan Gradle yang sama. Menggunakan kembali daemon akan mengurangi waktu untuk memulai JVM baru dan menginisialisasi sistem build.

Jika Anda memulai build dengan versi JDK atau Gradle yang berbeda, daemon tambahan akan dibuat, sehingga menggunakan lebih banyak CPU dan memori.

Tips: Saat menangani beberapa project secara bersamaan, jika memungkinkan, tentukan versi Gradle yang sama dalam file gradle-wrapper.properties untuk mengurangi jumlah daemon Gradle yang dibuat.

Konfigurasi JDK Gradle di Android Studio

Untuk mengubah konfigurasi JDK Gradle project yang ada, buka setelan Gradle dari File (atau Android Studio di macOS) > Settings > Build, Execution, Deployment > Build Tools > Gradle. Drop-down Gradle JDK berisi opsi berikut untuk dipilih:

• Makro seperti JAVA_HOME dan GRADLE_LOCAL_JAVA_HOME
• Entri tabel JDK dalam format vendor-version seperti jbr-17 yang disimpan dalam file konfigurasi Android
• Mendownload JDK
• Menambahkan JDK tertentu
• JDK yang terdeteksi secara lokal dari direktori penginstalan JDK default sistem operasi

Opsi yang dipilih disimpan dalam opsi gradleJvm di file .idea/gradle.xml project, dan resolusi jalur JDK-nya digunakan untuk menjalankan Gradle saat dimulai melalui Android Studio.

Gambar 1. Setelan JDK Gradle di Android Studio.

Makro mengaktifkan pemilihan jalur JDK project dinamis:

• JAVA_HOME: menggunakan variabel lingkungan dengan nama yang sama
• GRADLE_LOCAL_JAVA_HOME: menggunakan properti java.home di file .gradle/config.properties yang secara default disetel ke JetBrains Runtime.

JDK yang dipilih digunakan untuk menjalankan build Gradle dan menyelesaikan referensi JDK API saat mengedit skrip build dan kode sumber. Perhatikan bahwa compileSdk yang ditentukan akan lebih membatasi simbol Java mana yang akan tersedia saat mengedit dan mem-build kode sumber.

Catatan: Dalam sebagian besar kasus, sebaiknya gunakan GRADLE_LOCAL_JAVA_HOME, yang merupakan setelan default untuk project yang baru dibuat. Dengan begitu, Anda dapat menentukan JDK khusus project tanpa membuka project terlebih dahulu.

Pastikan untuk memilih versi JDK yang lebih tinggi dari atau sama dengan versi JDK yang digunakan oleh plugin yang Anda gunakan dalam build Gradle. Untuk menentukan versi JDK minimum yang diperlukan untuk Plugin Android Gradle (AGP), lihat tabel kompatibilitas dalam catatan rilis.

Misalnya, Plugin Android Gradle versi 8.x memerlukan JDK 17. Jika Anda mencoba menjalankan build Gradle yang menggunakannya dengan versi JDK yang lebih lama, build akan melaporkan pesan seperti:

An exception occurred applying plugin request [id: 'com.android.application']
> Failed to apply plugin 'com.android.internal.application'.
   > Android Gradle plugin requires Java 17 to run. You are currently using Java 11.
      Your current JDK is located in /usr/local/buildtools/java/jdk11
      You can try some of the following options:
       - changing the IDE settings.
       - changing the JAVA_HOME environment variable.
       - changing `org.gradle.java.home` in `gradle.properties`.

API Java mana yang dapat saya gunakan di kode sumber Java atau Kotlin?

Aplikasi Android dapat menggunakan beberapa API yang ditentukan di JDK, tetapi tidak semuanya. Android SDK menentukan implementasi berbagai fungsi library Java sebagai bagian dari API yang tersedia. Properti compileSdk menentukan versi Android SDK yang akan digunakan saat mengompilasi kode sumber Kotlin atau Java.

Kotlin

android {
    ...
    compileSdk = 33
}

Groovy

android {
    ...
    compileSdk 33
}

Setiap versi Android mendukung versi JDK tertentu dan sebagian API Java yang tersedia. Jika menggunakan API Java yang tersedia dalam compileSdk yang tidak tersedia di minSdk yang ditentukan, Anda mungkin dapat menggunakan API di versi Android sebelumnya melalui proses yang dikenal sebagai desugaring. Lihat API Java 11+ yang tersedia melalui desugaring untuk API yang didukung.

Gunakan tabel ini untuk menentukan versi Java yang didukung oleh setiap API Android, dan tempat menemukan detail tentang API Java yang tersedia.

Android	Java	Fitur API dan bahasa yang didukung
14 (API 34)	17	Library inti
13 (API 33)	11	Library inti
12 (API 32)	11	API Java
11 dan yang lebih lama		Versi Android

JDK mana yang mengompilasi kode sumber Java saya?

JDK Toolchain Java berisi compiler Java yang digunakan untuk mengompilasi kode sumber Java apa pun. JDK ini juga menjalankan pengujian unit dan javadoc selama build.

Toolchain default ke JDK yang digunakan untuk menjalankan Gradle. Jika Anda menggunakan default dan menjalankan build di komputer yang berbeda (misalnya, komputer lokal dan server Continuous Integration yang terpisah), hasil build dapat berbeda jika versi JDK yang digunakan berbeda.

Untuk membuat build yang lebih konsisten, Anda dapat secara eksplisit menentukan versi toolchain Java. Menentukan hal ini:

• Menemukan JDK yang kompatibel pada sistem yang menjalankan build.
  • Jika tidak ada JDK yang kompatibel (dan resolver toolchain ditentukan), download salah satunya.
• Mengekspos API Java toolchain untuk panggilan dari kode sumber.
• Mengompilasi sumber Java menggunakan versi bahasa Java-nya.
• Menyediakan default untuk sourceCompatibility dan targetCompatibility.

Sebaiknya Anda selalu menentukan toolchain Java, dan pastikan bahwa JDK yang ditentukan telah diinstal, atau tambahkan resolver toolchain ke build Anda.

Anda dapat menentukan toolchain apakah kode sumber Anda ditulis di Java, Kotlin, atau keduanya. Tentukan toolchain di tingkat teratas file build.gradle(.kts) modul Anda.

Tentukan versi toolchain Java seperti ini:

Kotlin

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

Groovy

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

Metode ini berfungsi jika sumber Anda adalah Kotlin, Java, atau campuran keduanya.

Versi JDK toolchain dapat sama dengan JDK yang digunakan untuk menjalankan Gradle, tetapi perlu diingat bahwa versi tersebut memiliki fungsi yang berbeda.

Fitur sumber bahasa Java manakah yang bisa saya gunakan dalam kode sumber Java?

Properti sourceCompatibility menentukan fitur bahasa Java mana yang tersedia selama kompilasi sumber Java. Kebijakan ini tidak memengaruhi sumber Kotlin.

Jika tidak ditentukan, setelan default akan disetel ke toolbar Java atau JDK yang digunakan untuk menjalankan Gradle. Sebaiknya Anda selalu menentukan toolchain (lebih disukai) atau sourceCompatibility secara eksplisit.

Tentukan sourceCompatibility dalam file build.gradle(.kts) modul Anda.

Kotlin

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

Groovy

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

Catatan: Mulai Android Studio Giraffe, saat project diimpor, opsi sourceCompatibility juga digunakan sebagai default untuk bantuan kode IDE dan analisis lint saat menulis sumber Java. Beberapa fitur bahasa Java memerlukan dukungan library dan tidak tersedia di Android. Opsi compileSdk menentukan library mana yang tersedia. Fitur lain, seperti ekspresi switch, hanya memerlukan compiler Java dan berfungsi di Android.

Fitur biner Java mana yang dapat digunakan saat saya mengompilasi sumber Kotlin atau Java saya?

Menentukan targetCompatibility dan jvmTarget akan menentukan versi format class Java yang digunakan saat membuat bytecode untuk sumber Java dan Kotlin yang dikompilasi.

Beberapa fitur Kotlin tersedia sebelum fitur Java yang setara ditambahkan. Compiler Kotlin awal harus membuat caranya sendiri untuk mewakili fitur Kotlin tersebut. Beberapa fitur ini kemudian ditambahkan ke Java. Dengan level jvmTarget yang lebih baru, compiler Kotlin dapat langsung menggunakan fitur Java, yang dapat menghasilkan performa yang lebih baik.

targetCompatibility ditetapkan secara default ke nilai yang sama dengan sourceCompatibility, tetapi jika ditentukan, harus lebih besar dari atau sama dengan sourceCompatibility.

jvmTarget ditetapkan secara default ke versi toolchain.

Versi Android yang berbeda mendukung versi Java yang berbeda pula. Anda dapat memanfaatkan fitur Java tambahan dengan meningkatkan targetCompatibility dan jvmTarget, tetapi hal ini mungkin memaksa Anda juga untuk meningkatkan versi Android SDK minimum guna memastikan fitur tersebut tersedia.

Kotlin

android {
    compileOptions {
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
}

Groovy

android {
    compileOptions {
        targetCompatibility JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget '17'
    }
}