Wersje Javy w kompilacjach Androida

Niezależnie od tego, czy kod źródłowy jest napisany w języku Java, Kotlin czy w obu tych językach, musisz wybrać wersję JDK lub Javy na potrzeby kompilacji.

Słowniczek

Pakiet Java Development Kit (JDK)

Pakiet programistyczny Java (JDK) zawiera:

• narzędzia, takie jak kompilator, profilator i twórca archiwum; Są one używane w tle podczas kompilacji w celu utworzenia aplikacji.
• Biblioteki zawierające interfejsy API, które możesz wywoływać z kodu źródłowego Kotlin lub Java. Pamiętaj, że nie wszystkie funkcje są dostępne na Androida.
• Maszyna wirtualna Java (JVM), czyli interpreter, który wykonuje aplikacje w Javie. JVM służy do uruchamiania środowiska IDE Android Studio i narzędzia do kompilacji Gradle. JVM nie jest używana na urządzeniach z Androidem ani na emulatorach.

JetBrains Runtime (JBR)

JetBrains Runtime (JBR) to ulepszony pakiet JDK rozpowszechniany w Android Studio. Zawiera ona kilka optymalizacji do stosowania w Studio i powiązanych usługach JetBrains, ale można jej też używać do uruchamiania innych aplikacji w języku Java.

Jak wybrać pakiet JDK do uruchomienia Android Studio?

Zalecamy użycie JBR do uruchomienia Android Studio. Jest ono wdrażane i używane do testowania Android Studio. Zawiera ulepszenia, które optymalizują korzystanie z Android Studio. Aby to zrobić, nie ustawiaj zmiennej środowiskowej STUDIO_JDK.

Skrypty startowe Android Studio wyszukują JVM w takim porządku:

1. STUDIO_JDK zmienna środowiskowa
2. katalog studio.jdk (w wersji Android Studio).
3. jbr (czas wykonywania JetBrains), w rozpowszechnieniu Android Studio. Zalecane.
4. zmienna środowiskowa JDK_HOME,
5. JAVA_HOME zmienna środowiskowa
6. plik wykonywalny java w zmiennej środowiskowej PATH,

Jak wybrać JDK, który będzie uruchamiać kompilacje Gradle?

Jeśli uruchomisz Gradle za pomocą przycisków w Android Studio, Gradle będzie używać JDK określonego w ustawieniach Android Studio. Jeśli uruchomisz Gradle w terminalu, w Android Studio lub poza nim, zmienna środowiskowa JAVA_HOME (jeśli jest ustawiona) określa, który pakiet JDK uruchamia skrypty Gradle. Jeśli zmienna JAVA_HOME nie jest skonfigurowana, używane jest polecenie java w przypadku zmiennej środowiskowej PATH.

Aby uzyskać jak najbardziej spójne wyniki, ustaw zmienną środowiskową JAVA_HOME i konfigurację JDK Gradle w Android Studio na ten sam JDK.

Podczas uruchamiania kompilacji Gradle tworzy proces zwany demonem, który wykonuje właściwą kompilację. Tego procesu można użyć ponownie, o ile kompilacje korzystają z tej samej wersji pakietu JDK i Gradle. Ponowne użycie demona skraca czas uruchamiania nowej maszyny JVM i inicjowania systemu kompilacji.

Jeśli rozpoczniesz kompilację z użyciem różnych wersji JDK lub Gradle, zostaną utworzone dodatkowe demony, które będą zużywać więcej pamięci i zasobów procesora.

Konfiguracja JDK w Android Studio

Aby zmodyfikować konfigurację Gradle JDK w istniejącym projekcie, otwórz ustawienia Gradle z poziomu Plik (lub Android Studio na komputerze Mac) > Ustawienia > Kompilacja, wykonanie, wdrożenie > Narzędzia do kompilacji > Gradle. W menu Gradle JDK dostępne są te opcje:

• makro JAVA_HOME i GRADLE_LOCAL_JAVA_HOME,
• Wpisy w tabeli JDK w formacie vendor-version, np. jbr-17, które są przechowywane w plikach konfiguracji Androida.
• Pobieranie pakietu JDK
• Dodawanie konkretnej wersji JDK
• Pliki JDK wykryte lokalnie w domyślnym katalogu instalacyjnym pakietu JDK systemu operacyjnego

Wybrana opcja jest przechowywana w opcji gradleJvm w pliku .idea/gradle.xml projektu, a rozwiązanie ścieżki JDK jest używane do uruchamiania Gradle, gdy jest uruchamiany przez Android Studio.

Makra umożliwiają dynamiczny wybór ścieżki JDK w projekcie:

• JAVA_HOME: używa zmiennej środowiskowej o tej samej nazwie.
• GRADLE_LOCAL_JAVA_HOME: używa właściwości java.home w pliku .gradle/config.properties, którego domyślne ustawienie to środowisko wykonawcze JetBrains.

Wybrany pakiet JDK służy do uruchamiania kompilacji Gradle i rozwiązywania odwołań do interfejsu API JDK podczas edytowania skryptów kompilacji i kodu źródłowego. Pamiętaj, że wybrana opcja compileSdk dodatkowo ograniczy dostępność symboli Java podczas edytowania i generowania kodu źródłowego.

Pamiętaj, aby wybrać wersję JDK, która jest równa lub nowsza niż wersje JDK używane przez wtyczki używane w kompilacji Gradle. Aby określić minimalną wymaganą wersję JDK dla wtyczki Androida do obsługi Gradle (AGP), zapoznaj się z tabelą zgodności w informacjach o wersji.

Na przykład wtyczka Androida do obsługi Gradle w wersji 8.x wymaga pakietu JDK 17. Jeśli spróbujesz uruchomić kompilację Gradle, która korzysta z wersji JDK, która jest starsza niż ta, która jest wymagana, pojawi się komunikat podobny do tego:

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

Których interfejsów API Java mogę używać w kodzie źródłowym Java lub Kotlin?

Aplikacja na Androida może używać niektórych interfejsów API zdefiniowanych w JDK, ale nie wszystkich. Pakiet Android SDK definiuje implementacje wielu funkcji biblioteki Java jako część dostępnych interfejsów API. Właściwość compileSdk określa, której wersji pakietu SDK na Androida należy użyć podczas kompilowania kodu źródłowego Kotlin lub Java.

android {
    ...
    compileSdk = 33
}

android {
    ...
    compileSdk 33
}

Każda wersja Androida obsługuje określoną wersję JDK i podzbiór dostępnych interfejsów API Java. Jeśli używasz interfejsu Java API dostępnego w compileSdk, który nie jest dostępny w określonej minSdk, możesz spróbować użyć tego interfejsu w starszej wersji Androida za pomocą procesu zwanego desugaringiem. Informacje o obsługiwanych interfejsach API znajdziesz w artykule Interfejsy API Java 11 i nowsze dostępne dzięki desugaringowi.

Z tej tabeli dowiesz się, która wersja Javy jest obsługiwana przez każdy interfejs API Androida oraz gdzie znaleźć informacje o tym, które interfejsy API Javy są dostępne.

Która wersja JDK kompiluje mój kod źródłowy Java?

Ciąg narzędzi Java w pakiecie JDK zawiera kompilator Java używany do kompilowania kodu źródłowego w Javie. Ten pakiet JDK uruchamia także testy javadoc i testy jednostkowe podczas kompilacji.

Domyślnie używana jest platforma JDK używana do uruchamiania Gradle. Jeśli używasz domyślnej wersji i uruchamiasz kompilację na różnych maszynach (np. na komputerze lokalnym i na osobnym serwerze ciągłej integracji), wyniki kompilacji mogą się różnić, jeśli używasz różnych wersji JDK.

Aby utworzyć bardziej spójną kompilację, możesz wyraźnie określić wersję łańcucha narzędzi Java. Określenie:

• Znajduje zgodną wersję JDK na systemie, na którym działa kompilacja.
  • Jeśli nie ma zgodnego pakietu JDK (a jest zdefiniowany rozwiązujący toolchain), pobiera go.
• Udostępnia interfejsy Java toolchain do wywołań z kodu źródłowego.
• Kompiluje kod źródłowy w języku Java, korzystając z odpowiedniej wersji językowej.
• Domyślne wartości dostaw dla sourceCompatibility i targetCompatibility.

Zalecamy, aby zawsze wskazywać łańcuch narzędzi Java i upewnić się, że określony pakiet JDK jest zainstalowany lub dodać do kompilacji mechanizm resolverowy.

Możesz określić zestaw narzędzi, niezależnie od tego, czy kod źródłowy jest napisany w języku Java, Kotlin czy w obu tych językach. Określ narzędziownik na najwyższym poziomie pliku build.gradle(.kts) modułu.

Podaj wersję łańcucha narzędzi Java w ten sposób:

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

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

Ta metoda działa, jeśli źródło to Kotlin, Java lub obie te technologie.

Wersja toolchain JDK może być taka sama jak wersja JDK używana do uruchamiania Gradle, ale pamiętaj, że służą one do różnych celów.

Których funkcji języka Java mogę używać w kodzie źródłowym Java?

Właściwość sourceCompatibility określa, które funkcje języka Java są dostępne podczas kompilacji kodu źródłowego Java. Nie ma to wpływu na kod Kotlin.

W pliku build.gradle(.kts) w module określ wartość sourceCompatibility w następujący sposób:

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
    }
}

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
    }
}

Jeśli nie podasz żadnej wartości, domyślnie zostanie użyta wersja kompilatora Java. Jeśli nie używasz łańcucha narzędzi Java, domyślnie wybierana jest wersja wybrana przez wtyczkę Androida do obsługi Gradle (np. Java 8 lub nowsza).

Których funkcji binarnych Javy można używać podczas kompilowania kodu źródłowego w Kotlinie lub Javie?

Właściwości targetCompatibility i jvmTarget określają wersję formatu klasy Java używaną podczas generowania kodu bajtowego odpowiednio dla skompilowanego kodu źródłowego w języku Java i Kotlin.

Niektóre funkcje Kotlina istniały przed dodaniem odpowiednich funkcji Java. Wczesne kompilatory Kotlina musiały tworzyć własne sposoby reprezentowania tych funkcji Kotlina. Niektóre z tych funkcji zostały później dodane do Javy. W przypadku wyższych poziomów jvmTarget kompilator Kotlina może bezpośrednio korzystać z funkcji Java, co może skutkować większą wydajnością.

Różne wersje Androida obsługują różne wersje języka Java. Aby skorzystać z dodatkowych funkcji Javy, zwiększ targetCompatibility i jvmTarget. Może to jednak wymagać także zwiększenia minimalnej wersji pakietu Android SDK, aby zapewnić ich dostępność.

Pamiętaj, że targetCompatibility musi być większa lub równa sourceCompatibility. W praktyce pola sourceCompatibility, targetCompatibility i jvmTarget powinny mieć tę samą wartość. Możesz je ustawić w ten sposób:

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

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

Jeśli nie podasz żadnej wartości, te właściwości zostaną domyślnie ustawione na wersję łańcucha narzędzi Java. Jeśli nie używasz łańcucha narzędzi Java, wartości domyślne mogą się różnić i spowodować problemy z kompilacją. Dlatego zalecamy zawsze jawne określenie tych wartości lub użycie zestawu narzędzi Java.