Versioni di Java nelle build di Android

Che il codice sorgente sia scritto in Java, Kotlin o entrambi, esistono diverse posizioni in cui devi scegliere una versione in linguaggio JDK o Java per la tua build.

Glossario

Java Development Kit (JDK)

Il Java Development Kit (JDK) contiene:

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

Runtime JetBrains (JBR)

JetBrains Runtime (JBR) è un JDK avanzato, 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 implementato e utilizzato per testare Android Studio e include miglioramenti per un utilizzo ottimale di Android Studio. Per farlo, non impostare la variabile di ambiente STUDIO_JDK.

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

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

Come faccio a scegliere quale JDK esegue le mie build Gradle?

Se esegui Gradle utilizzando i pulsanti in Android Studio, il JDK impostato nelle impostazioni di Android Studio viene utilizzato per eseguire Gradle. 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 è impostato, utilizza il comando java nella variabile di ambiente PATH.

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

Nota: se esegui un comando Gradle in Android Studio Terminal facendo clic con il tasto destro del mouse e selezionando Esegui comando evidenziato utilizzando l'IDE, verrà utilizzato il JDK nelle impostazioni di Android Studio, non JAVA_HOME.

Quando esegui la build, Gradle crea un processo chiamato daemon per eseguire la build effettiva. Questo processo può essere riutilizzato, purché le build utilizzino la stessa versione 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 build con versioni JDK o Gradle diverse, vengono creati daemon aggiuntivi che consumano più CPU e memoria.

Suggerimento: quando lavori con più progetti contemporaneamente, se possibile, specifica la stessa versione Gradle nel file gradle-wrapper.properties per ridurre il numero di daemon Gradle creati.

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, Execution, Deployment > Build Tools > Gradle. Il menu a discesa Gradle JDK contiene le seguenti opzioni tra cui scegliere:

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

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

Figura 1. Impostazioni JDK di Gradle in Android Studio.

Le macro abilitano 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 è il runtime JetBrains.

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 il valore compileSdk specificato limiterà ulteriormente i simboli Java disponibili durante la modifica e la creazione del codice sorgente.

Nota: nella maggior parte dei casi, consigliamo di utilizzare GRADLE_LOCAL_JAVA_HOME, l'impostazione predefinita per i progetti appena creati. In questo modo puoi definire un JDK specifico del progetto senza prima aprire il progetto.

Assicurati di scegliere una versione JDK superiore 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 Gradle (AGP), consulta la tabella di compatibilità nelle note di rilascio.

Ad esempio, il plug-in Android Gradle versione 8.x richiede JDK 17. Se provi a eseguire una build Gradle che la utilizza con una versione precedente del JDK, verrà 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/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`.

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

Un'applicazione 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 sue API disponibili. La proprietà compileSdk specifica la versione dell'SDK Android da utilizzare durante la compilazione del codice sorgente Kotlin o Java.

Kotlin

android {
    ...
    compileSdk = 33
}

Alla moda

android {
    ...
    compileSdk 33
}

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 che non è disponibile nel minSdk specificato, potresti riuscire a utilizzare l'API nella versione precedente di Android tramite una procedura nota come desugaring. Vedi API Java 11 e versioni successive disponibili tramite desugaring per le API supportate.

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

Android	Java	Funzionalità di API e lingua supportate
14 (API 34)	17	Librerie di base
13 (API 33)	11	Librerie di base
12 (API 32)	11	API Java
11 e inferiori		Versioni di Android

Quale JDK compila il mio codice sorgente Java?

Il JDK Java toolchain 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 è il JDK utilizzato per eseguire Gradle. Se utilizzi l'impostazione predefinita ed esegui una build su macchine diverse (ad esempio, la tua 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. Specifica questo:

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

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

Puoi specificare la toolchain se il tuo codice sorgente è 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:

Kotlin

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

Alla moda

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

Questa opzione funziona se il tuo codice sorgente è Kotlin, Java o una combinazione di entrambi.

La versione JDK della toolchain può essere uguale a quella JDK utilizzata per eseguire Gradle, ma tieni presente che servono scopi diversi.

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

La proprietà sourceCompatibility determina quali funzionalità del linguaggio Java sono disponibili durante la compilazione del codice sorgente Java. Questa operazione non influisce sull'origine di Kotlin.

Se non specificato, viene utilizzata per impostazione predefinita la toolchain Java o il JDK utilizzato per eseguire Gradle. Ti consigliamo di specificare sempre in modo esplicito una toolchain (opzione preferita) o sourceCompatibility.

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

Kotlin

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

Alla moda

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

Nota: a partire da Android Studio Giraffe, quando vengono importati i progetti, l'opzione sourceCompatibility viene utilizzata come predefinita anche per l'assistenza del codice IDE e il linting durante la scrittura del codice sorgente Java. Alcune funzionalità del linguaggio Java richiedono il supporto della libreria e non sono disponibili su Android. L'opzione compileSdk determina quali librerie sono disponibili. Altre funzionalità, come le espressioni di cambio, richiedono solo il compilatore Java e funzionano su Android.

Quali caratteristiche binarie Java possono essere utilizzate durante la compilazione del mio codice sorgente Kotlin o Java?

Se specifichi targetCompatibility e jvmTarget, viene determinata la versione del formato di classe Java utilizzata durante la generazione del bytecode rispettivamente per l'origine Java e Kotlin compilata.

Alcune caratteristiche Kotlin esistevano prima dell'aggiunta di caratteristiche Java equivalenti. I primi compilatori Kotlin dovevano creare il proprio modo per rappresentare le caratteristiche di Kotlin. Alcune di queste funzionalità sono state aggiunte in seguito a Java. Con livelli jvmTarget successivi, il compilatore Kotlin potrebbe utilizzare direttamente la funzionalità Java, il che potrebbe portare a prestazioni migliori.

Il valore predefinito di targetCompatibility è lo stesso di sourceCompatibility, ma, se specificato, deve essere maggiore o uguale a sourceCompatibility.

Per impostazione predefinita, jvmTarget utilizza la versione toolchain.

Versioni diverse di Android supportano versioni diverse di Java. Puoi usufruire di funzionalità Java aggiuntive aumentando targetCompatibility e jvmTarget, ma questo potrebbe costringere ad aumentare anche la versione minima dell'SDK per Android per garantire che la funzionalità sia disponibile.

Kotlin

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

Alla moda

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