Cocos Creator 安卓环境配置

news2024/11/18 11:45:40

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

安装 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)

安装 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"` 错误 .

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
```
在 Android Studio 中发布 .apk，正式上线版本需要创建密钥.