From 47c8938f7fe1ace5b940f32c980a88c566c081c1 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Fri, 22 Aug 2025 19:46:23 +0200 Subject: [PATCH] Update required JDK version to 17 in Exporting/Compiling for Android - Recommend Adoptium for OpenJDK builds on both locations for consistency. --- development/compiling/compiling_for_android.rst | 12 ++++++------ tutorials/export/exporting_basics.rst | 2 +- tutorials/export/exporting_for_android.rst | 4 ++-- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/development/compiling/compiling_for_android.rst b/development/compiling/compiling_for_android.rst index fcd5cd338..ddd0de00a 100644 --- a/development/compiling/compiling_for_android.rst +++ b/development/compiling/compiling_for_android.rst @@ -36,9 +36,9 @@ For compiling under Windows, Linux or macOS, the following is required: **do not use an Android SDK provided by your distribution's repositories as it will often be outdated**. - Gradle (will be downloaded and installed automatically if missing). -- JDK 11 (either OpenJDK or Oracle JDK). +- JDK 17 (either OpenJDK or Oracle JDK). - - You can download a build from `ojdkbuild `_. + - You can download a build from `Adoptium `_. .. seealso:: To get the Godot source code for compiling, see :ref:`doc_getting_source`. @@ -51,13 +51,13 @@ For compiling under Windows, Linux or macOS, the following is required: Setting up the buildsystem -------------------------- -- Set the environment variable ``ANDROID_SDK_ROOT`` to point to the Android +- Set the environment variable ``ANDROID_SDK_ROOT`` to point to the Android SDK. If you downloaded the Android command-line tools, this would be the folder where you extracted the contents of the ZIP archive. - Install the necessary SDK components in this folder: - - Accept the SDK component licenses by running the following command + - Accept the SDK component licenses by running the following command where ``android_sdk_path`` is the path to the Android SDK, then answering all the prompts with ``y``: :: @@ -70,7 +70,7 @@ Setting up the buildsystem tools/bin/sdkmanager --sdk_root= "platform-tools" "build-tools;30.0.3" "platforms;android-29" "cmdline-tools;latest" "cmake;3.10.2.4988404" -.. seealso:: To set the environment variable on Windows, press :kbd:`Windows + R`, type +.. seealso:: To set the environment variable on Windows, press :kbd:`Windows + R`, type "control system", then click on **Advanced system settings** in the left pane, then click on **Environment variables** on the window that appears. @@ -219,7 +219,7 @@ Android might complain the application is not correctly installed. If so: - Check that the debug keystore is properly generated. -- Check that the jarsigner executable is from JDK 8. +- Check that the jarsigner executable is from JDK 17. If it still fails, open a command line and run `logcat `_: diff --git a/tutorials/export/exporting_basics.rst b/tutorials/export/exporting_basics.rst index 3077ec323..940039053 100644 --- a/tutorials/export/exporting_basics.rst +++ b/tutorials/export/exporting_basics.rst @@ -336,7 +336,7 @@ Before you can export your project for Android, you must download the following software: * Android SDK: https://developer.android.com/studio/ -* Open JDK (**version 11 is required**, more recent versions won't work): https://adoptopenjdk.net/index.html +* OpenJDK (**version 17 is required**, older or newer versions won't work): https://adoptopenjdk.net/index.html When you run Android Studio for the first time, click on **Configure -> SDK Manager** and install **Android SDK Platform Tools**. This installs the ``adb`` diff --git a/tutorials/export/exporting_for_android.rst b/tutorials/export/exporting_for_android.rst index 2e46af1f8..7d865299b 100644 --- a/tutorials/export/exporting_for_android.rst +++ b/tutorials/export/exporting_for_android.rst @@ -13,10 +13,10 @@ Exporting for Android Exporting for Android has fewer requirements than compiling Godot for Android. The following steps detail what is needed to set up the Android SDK and the engine. -Install OpenJDK 11 +Install OpenJDK 17 ------------------ -Download and install `OpenJDK 11 `__. +Download and install `OpenJDK 17 `__. Download the Android SDK ------------------------