Versioni Java nelle build Android

Indipendentemente dal fatto che il codice sorgente sia scritto in Java, Kotlin o entrambi, ci sono diversi punti in cui devi scegliere una versione JDK o del linguaggio Java per la build.

Glossario

Java Development Kit (JDK)

El Java Development Kit (JDK) contiene:

• Strumenti, come un compilatore, un profiler e un creatore di archivi. Questi vengono utilizzati in background durante la build per creare l'applicazione.
• Librerie contenenti API che puoi chiamare dal codice sorgente Kotlin o Java. Tieni presente che non tutte le funzioni sono disponibili su Android.
• Java Virtual Machine (JVM), un interprete che esegue applicazioni Java. Utilizzi la JVM per eseguire l'IDE di Android Studio e lo strumento di build Gradle. La JVM non viene utilizzata su dispositivi o emulatori Android.

JetBrains Runtime (JBR)

Il JetBrains Runtime (JBR) è un JDK migliorato, distribuito con Android Studio. Include diverse ottimizzazioni per l'utilizzo in Studio e nei prodotti JetBrains correlati, ma può essere utilizzato anche per eseguire altre applicazioni Java.

Come faccio a scegliere un JDK per eseguire Android Studio?

Ti consigliamo di utilizzare JBR per eseguire Android Studio. Viene eseguito il deployment e utilizzato per testare Android Studio e include miglioramenti per un utilizzo ottimale di Android Studio. Per assicurarti che sia così, non impostare la variabile di ambiente STUDIO_JDK.

Gli script di avvio di Android Studio cercano una JVM nel seguente ordine:

1. Variabile di ambiente STUDIO_JDK
2. Directory studio.jdk (nella distribuzione di Android Studio)
3. Directory jbr (JetBrains Runtime), nella distribuzione di Android Studio. Consigliata.
4. Variabile di ambiente JDK_HOME
5. Variabile di ambiente JAVA_HOME
6. Eseguibile java nella variabile di ambiente PATH

Come faccio a scegliere quale JDK esegue le build Gradle?

Se esegui Gradle utilizzando i pulsanti in Android Studio, per eseguire Gradle viene utilizzato il JDK impostato nelle impostazioni di Android Studio. Se esegui Gradle in un terminale, all'interno o all'esterno di Android Studio, la variabile di ambiente JAVA_HOME (se impostata) determina quale JDK esegue gli script Gradle. Se JAVA_HOME non è impostata, viene utilizzato il comando java nella variabile di ambiente PATH.

Per risultati più coerenti, assicurati di impostare la variabile di ambiente JAVA_HOME e la configurazione JDK di Gradle in Android Studio sullo stesso JDK.

Quando esegui la build, Gradle crea un processo chiamato daemon per eseguire la build effettiva. Questo processo può essere riutilizzato, a condizione che le build utilizzino la stessa versione di JDK e Gradle. Il riutilizzo di un daemon riduce il tempo necessario per avviare una nuova JVM e inizializzare il sistema di compilazione.

Se avvii le build con versioni JDK o Gradle diverse, vengono creati daemon aggiuntivi, che consumano più CPU e memoria.

Configurazione JDK di Gradle in Android Studio

Per modificare la configurazione JDK di Gradle del progetto esistente, apri le impostazioni di Gradle da File (o Android Studio su macOS) > Impostazioni > Build, esecuzione, deployment > Strumenti di build > Gradle. Il menu a discesa JDK di Gradle contiene le seguenti opzioni tra cui scegliere:

• Macro come JAVA_HOME e GRADLE_LOCAL_JAVA_HOME
• Voci della tabella JDK nel formato vendor-version come jbr-17, archiviate nei file di configurazione di Android
• Download di un JDK
• Aggiunta di un JDK specifico
• JDK rilevati localmente dalla directory di installazione JDK predefinita del sistema operativo

L'opzione selezionata viene memorizzata nell'opzione gradleJvm nel file .idea/gradle.xml del progetto e la relativa risoluzione del percorso JDK viene utilizzata per eseguire Gradle quando viene avviato tramite Android Studio.

Le macro consentono la selezione dinamica del percorso JDK del progetto:

• JAVA_HOME: utilizza la variabile di ambiente con lo stesso nome
• GRADLE_LOCAL_JAVA_HOME: utilizza la proprietà java.home nel file .gradle/config.properties, che per impostazione predefinita è JetBrains Runtime.

Il JDK selezionato viene utilizzato per eseguire la build Gradle e risolvere i riferimenti API JDK durante la modifica degli script di build e del codice sorgente. Tieni presente che compileSdk specificato limiterà ulteriormente i simboli Java disponibili durante la modifica e la creazione del codice sorgente.

Assicurati di scegliere una versione JDK maggiore o uguale alle versioni JDK utilizzate dai plug-in che utilizzi nella build Gradle. Per determinare la versione JDK minima richiesta per il plug-in Android per Gradle (AGP), consulta la tabella di compatibilità nelle note di rilascio.

Ad esempio, il plug-in Android per Gradle versione 8.x richiede JDK 17. Se provi a eseguire una build Gradle che lo utilizza con una versione precedente del JDK, viene visualizzato un messaggio simile al seguente:

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/jdk
      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`.

Quali API Java posso utilizzare nel codice sorgente Java o Kotlin?

Un'app per Android può utilizzare alcune delle API definite in un JDK, ma non tutte. L'SDK Android definisce le implementazioni di molte funzioni della libreria Java come parte delle API disponibili. La proprietà compileSdk specifica la versione dell'SDK Android da utilizzare durante la compilazione del codice sorgente Kotlin o Java.

android {
    ...
    compileSdk = 36
}

android {
    ...
    compileSdk 36
}

Ogni versione di Android supporta una versione specifica del JDK e un sottoinsieme delle API Java disponibili. Se utilizzi un'API Java disponibile in un compileSdk non disponibile in minSdk specificato, potresti essere in grado di utilizzare l'API nella versione precedente di Android tramite un processo noto come desugaring. Per le API supportate, consulta API Java 11+ disponibili tramite desugaring APIs.

Utilizza questa tabella per determinare quale versione di Java è supportata da ogni API Android e dove trovare i dettagli sulle API Java disponibili.

Quale JDK compila il mio codice sorgente Java?

Il JDK della toolchain Java contiene il compilatore Java utilizzato per compilare qualsiasi codice sorgente Java. Questo JDK esegue anche javadoc e test delle unità durante la build.

Per impostazione predefinita, la toolchain utilizza il JDK utilizzato per eseguire Gradle. Se utilizzi l'impostazione predefinita ed esegui una build su macchine diverse (ad esempio, la macchina locale e un server di integrazione continua separato), i risultati della build possono variare se vengono utilizzate versioni JDK diverse.

Per creare una build più coerente, puoi specificare esplicitamente una versione della toolchain Java. Se specifichi questa versione:

• Individua un JDK compatibile sul sistema che esegue la build.
  • Se non esiste un JDK compatibile (e viene definito un resolver della toolchain), ne scarica uno.
• Espone le API Java della toolchain per le chiamate dal codice sorgente.
• Compila la sorgente Java utilizzando la versione del linguaggio Java.
• Fornisce valori predefiniti per sourceCompatibility e targetCompatibility.

Ti consigliamo di specificare sempre la toolchain Java e di assicurarti che il JDK specificato sia installato o di aggiungere un resolver della toolchain alla build.

Puoi specificare la toolchain indipendentemente dal fatto che il codice sorgente sia scritto in Java, Kotlin o entrambi. Specifica la toolchain al livello superiore del file build.gradle(.kts) del modulo.

Specifica la versione della toolchain Java nel seguente modo:

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

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

Questa operazione funziona se la sorgente è Kotlin, Java o un mix di entrambi.

La versione JDK della toolchain può essere la stessa del JDK utilizzato per eseguire Gradle, ma tieni presente che hanno scopi diversi.

Quali funzionalità di origine del linguaggio Java posso utilizzare nel codice sorgente Java?

La proprietà sourceCompatibility determina quali funzionalità del linguaggio Java sono disponibili durante la compilazione della sorgente Java. Non influisce sulla sorgente Kotlin.

Specifica sourceCompatibility nel file build.gradle(.kts) del modulo nel seguente modo:

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

Se non specificata, questa proprietà utilizza per impostazione predefinita la toolchain Java versione. Se non utilizzi una toolchain Java, il valore predefinito è una versione scelta dal plug-in Android per Gradle (ad esempio, Java 8 o versioni successive).

Quali funzionalità binarie Java possono essere utilizzate durante la compilazione della sorgente Kotlin o Java?

La proprietà targetCompatibility determina la versione del formato della classe Java utilizzata per generare rispettivamente il bytecode per la sorgente Java e Kotlin compilata.

Alcune funzionalità di Kotlin esistevano prima che venissero aggiunte le funzionalità Java equivalenti. I primi compilatori Kotlin dovevano creare un proprio modo per rappresentare queste funzionalità Kotlin. Alcune di queste funzionalità sono state aggiunte in un secondo momento a Java. Con i livelli targetCompatibility successivi, il compilatore Kotlin potrebbe utilizzare direttamente la funzionalità Java, il che potrebbe comportare un miglioramento delle prestazioni.

Versioni diverse di Android supportano versioni diverse di Java. Puoi sfruttare le funzionalità Java aggiuntive aumentando targetCompatibility, ma potresti anche dover aumentare la versione minima dell'SDK Android per assicurarti che la funzionalità sia disponibile.

Tieni presente che targetCompatibility deve essere maggiore o uguale a sourceCompatibility. In pratica, sourceCompatibility e targetCompatibility dovrebbero in genere utilizzare lo stesso valore. Puoi impostarli nel seguente modo:

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
}

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
}

Se utilizzi una versione di Kotlin precedente alla 2.2, devi anche impostare kotlinOptions:

android {
    kotlinOptions {
        jvmTarget = "17"
    }
}

android {
    kotlinOptions {
        jvmTarget = "17"
    }
}

Se non specificate, queste proprietà utilizzano per impostazione predefinita la toolchain Java versione. Se non utilizzi una toolchain Java, i valori predefiniti potrebbero variare e causare problemi di build. Pertanto, ti consigliamo di specificare sempre esplicitamente questi valori o di utilizzare una toolchain Java.