Versioni di Java nelle build di Android

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

Figura 1. Relazioni JDK in una build

Glossario

Java Development Kit (JDK)

Java Development Kit (JDK) contiene:

• Strumenti, come un compilatore, un profiler e un creator di archivi. Vengono utilizzati dietro le quinte durante la compilazione 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.
• La Java Virtual Machine (JVM), un interprete che esegue le applicazioni Java. Utilizzi la JVM per eseguire l'IDE Android Studio e lo strumento di compilazione Gradle. La JVM non viene utilizzata su dispositivi o emulatori 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 correlati di JetBrains, 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 disegnato e utilizzato per testare Android Studio e include miglioramenti per un uso ottimale di Android Studio. Per farlo, non impostare la variabile di ambiente STUDIO_JDK.

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

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

Come faccio a scegliere quale JDK esegue le mie build di 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, viene utilizzato il comando java sulla variabile di ambiente PATH.

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

Nota: se esegui un comando Gradle nel terminale di Android Studio 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 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 build con versioni JDK o Gradle diverse, vengono creati daemon aggiuntivi che consumano più CPU e memoria.

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

Configurazione di JDK 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
• Le voci della tabella JDK in 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.

Figura 2. Impostazioni JDK di Gradle in Android Studio.

Le macro consentono di selezionare il percorso del JDK del progetto dinamico:

• 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 di Gradle e risolvere i riferimenti alle API JDK quando modifichi gli script di build e il codice sorgente. Tieni presente che il valore compileSdk specificato limiterà ulteriormente i simboli Java disponibili durante la modifica e la compilazione del codice sorgente.

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

Assicurati di scegliere una versione JDK superiore o uguale alle versioni JDK utilizzate dai plug-in che utilizzi nella compilazione 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 compilazione Gradle che lo utilizza con una versione precedente delJDK, 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 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 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
}

Groovy

android {
    ...
    compileSdk 33
}

Ogni versione di Android supporta una versione specifica del JDK e un sottoinsieme delle sue API Java disponibili. Se utilizzi un'API Java disponibile in un compileSdk non disponibile nel minSdk specificato, potresti essere in grado di utilizzare l'API nella versione precedente di Android tramite una procedura nota come desugaring. Per le API supportate, consulta API Java 11 e versioni successive disponibili tramite la desugaring.

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 versioni precedenti		Versioni di Android

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 di unità durante la compilazione.

La toolchain predefinita è il JDK utilizzato per eseguire Gradle. Se utilizzi il valore predefinito e esegui una compilazione su macchine diverse (ad esempio la tua macchina locale e un server di integrazione continua separato), i risultati della compilazione possono variare se vengono utilizzate versioni JDK diverse.

Per creare una build più coerente, puoi specificare esplicitamente una versione della toolchain Java. Specificando quanto segue:

• Individua un JDK compatibile sul sistema su cui viene eseguita la compilazione.
  • 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 relativa versione del linguaggio Java.
• I valori predefiniti per le forniture sono sourceCompatibility e targetCompatibility.

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

Puoi specificare la toolchain se il codice sorgente è scritto in Java, Kotlin o in entrambi i linguaggi. Specifica la toolchain al livello superiore del file build.gradle(.kts) del modulo.

Specifica la versione della toolchain Java come segue:

Kotlin

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

Alla moda

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

Questo funziona se il 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à del codice sorgente 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.

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

Kotlin

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

Groovy

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

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

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 funzionalità di file binari Java posso utilizzare quando compilo il codice sorgente Kotlin o Java?

Le proprietà targetCompatibility e jvmTarget determinano la versione del formato della classe Java utilizzata per generare il bytecode rispettivamente per il codice sorgente Java e Kotlin compilato.

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

Versioni diverse di Android supportano versioni diverse di Java. Puoi usufruire di funzionalità Java aggiuntive aumentando targetCompatibility e jvmTarget, ma questo potrebbe costringerti anche ad 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, in genere sourceCompatibility, targetCompatibility e jvmTarget devono utilizzare lo stesso valore. Puoi impostarli come segue:

Kotlin

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

Groovy

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

Se non specificato, per queste proprietà viene utilizzato il valore predefinito della versione della toolchain Java. Se non utilizzi una toolchain Java, i valori predefiniti potrebbero essere diversi e causare problemi di build. Pertanto, ti consigliamo di specificare sempre esplicitamente questi valori o di utilizzare una toolchain Java.