Cocos Creator 安卓环境配置

系统：Win10，引擎版本：CocosCreator3.8.2， 时间：2024.05.23

1. 安装 Java SDK(JDK)下载地址

• 注意：Java版本对应的Gradle: 详见表 Table 1. Java Compatibility

• 此处选择 Java 21 对应 Gradle 8.5

• 配置Java系统环境变量，我的电脑上右键 -> 属性 -> 高级系统设置 -> 高级 -> 环境变量，新建：

  变量名：JAVA_HOME
  变量值：C:\Program Files\Java\jdk-21

  Path变量加入：

  %JAVA_HOME%\bin;

  查看是否成功安装(可能需要重启)：

  C:\Users\Administrator>java -version
  java version "21.0.3" 2024-04-16 LTS
  Java(TM) SE Runtime Environment (build 21.0.3+7-LTS-152)
  Java HotSpot(TM) 64-Bit Server VM (build 21.0.3+7-LTS-152, mixed mode, sharing)

1. 安装 Android Studio 下载地址(需要连接外网下载)，此处安装了最新版: Android Studio Jellyfish | 2023.3.1

• Tools -> SDK Manager.
• 在 SDK Platforms 分页栏，勾选你希望安装的 API Level .
• 在 SDK Tools 分页栏，勾选右下角的 Show Package Details，显示详细包.
  • 在 Android SDK Build-Tools 里，选择最新的版本.
  • 在 NDK 里，CocosCreator3.8.2 规定使用 21~23，否则在 CocosCreator 编辑器中配置 NDK 时会出现红色警告。
  • 余下的设置默认即可，如需安装 Android 支持库，请参考 支持库设置.
  • 拷贝窗口上方的 Android SDK Location 目录，稍后在 Cocos Creator 编辑器中填写这个 SDK 目录
  • 点击 OK，根据提示完成安装.
• 在 Settings 窗口就是上一步的窗口，File -> Settings -> Build,Execution,Deployment -> Build Tools -> Gradle，在Gradle JDK 选择步骤1安装的 JDK 版本.
  ---------------------------------------------- CocosCreator构建完成后 ------------------------------------------
• 在打开项目生成 .apk 时，还需要设置 Android Gradle Plugin(AGP) 与 Gradle 的版本，Gradle插件(AGP) 的版本对 Gradle 的最低版本是有要求的：Gradle插件对应的最低Gradle的版本 见下表：
• File -> Project Structure -> Project 选择 Android Gradle Plugin 7.4.2，Gradle 8.5
  • 升级 Gradle 插件版本， 菜单 Tools -> AGP Upgrade Assistant.. (需要连接外网)
  • 更换 Gradle 版本，直接在 Gradle Version 下拉列表中选择，选择完成点 OK ，将进入 Gradle Build Running 任务，在状态栏中可以看到(打开项目时会自动执行该任务)，如果连接外网也长时间下载失败时，可以在 Gradle | Releases 下载需要安装的 Gradle 版本，注意是点击 binary-only 链接下载，将下载的 .zip 直接放入到 C:\Users\Administrator.gradle\wrapper\dists 对应的文件夹里，重新在 Android Studio 打开项目进入 Gradle Build Running 时，即可自动解压. 如果安装失败可能会出现 ``"No matching variant of com.android.tools.build:gradle:x.x.x was found"` 错误 .

1. CocosCreator 中配置 Android NDK、Android SDK 目录，File -> Preferences -> Program Manager，粘贴 步骤2 的 Android SDK Location 到 Android SDK，Android NDK 设置为同目录下的 ndk 下的对应版本子文件夹，如下图

   C:\Users\Administrator\AppData\Local\Android\Sdk\ndk\21.4.7075529
   C:\Users\Administrator\AppData\Local\Android\Sdk

2. 在 Android Studio 中发布 .apk，正式上线版本需要创建密钥.

参考文献：
CocosCreator: 安装配置原生开发环境
CocosCreator: Android 原生开发环境配置Compatibility NotesAndroid Gradle plugin 8.4 release notesGradle | Releases