[3.8.8] What and which versions need to be installed to build for Android?

Hi all!

I am using Cocos Creator 3.8.8.

The documentation says that for Cocos Creator 2.4.12+ or Cocos Creator 3.8.0+:

  • Recommended Android Studio version 2022.2.1 or 2022.3.1
  • JDK version 17

However, Cocos Creator version 3.8.0 was released on August 1, 2023.

I installed Android Studio Giraffe | 2022.3.1 Patch 4 November 16, 2023. A project created by Cocos Creator for Android Studio opens there with an error. The error was related to the version of the Android Gradle plugin (AGP).

Cocos Creator version 3.8.8 was released on December 16, 2025. More than two years passed between versions 3.8.0 and 3.8.8. Which version of Android Studio should I install? Which JDK version do I need?

I use Cocos Creator 3.8.1, Android Studio 2025.2.2, JDK 21 and gradle 8.13
Does your log shows the version limitation? Post it here.

Yeah, documentation needs to be updated, but here are my current specs and everything works great.

See proof below: :grinning_face:

I currently use:

  • Cocos Creator 3.8.8
  • Android Studio Otter 3 2025.2.3
  • Java\jdk-17.0.12
  • Android\Sdk\ndk\android-ndk-r28c
  • Build → Target API Level = android-35

[ Project Structure ]
Android Gradle Plugin Version → 8.10.1
Gradle Version → 8.11.1

[ gradle.properties ]
PROP_COMPILE_SDK_VERSION=36
PROP_MIN_SDK_VERSION=23
PROP_TARGET_SDK_VERSION=35

Hope that helps. :grinning_face: