Cocos Creator 3.8.5 构建依赖环境配置文档
文章目录
适用于打包 Android 和 Windows 平台的完整依赖说明。
✅ 构建依赖汇总表
| 依赖项 | 用于平台 | 推荐版本 | 说明 | 下载地址 |
|---|---|---|---|---|
| Node.js | 全平台 | >=16.x（推荐 18.x） |
构建工具链依赖 | Node.js 官网 |
| CMake | Windows, Android native | 3.22 ~ 3.26（推荐 3.26.4） |
构建 native 项目 | CMake v3.26.4 |
| Python | Android | 3.6 ~ 3.10（推荐 3.10.x） |
用于构建脚本调用 | Python 3.10.11 |
| Visual Studio | Windows 原生 | 2019 或 2022 | 必须安装 “C++ 桌面开发工具集” | VS2022 下载 |
| Android Studio | Android | Hedgehog 或 Giraffe | 用于 SDK/NDK 配置和 Android 项目构建 | Android Studio |
| Android NDK | Android | r25c 或 r26b |
Cocos 3.8.5 默认兼容版本 | NDK r25c 下载 |
| Android SDK | Android | API 30 ~ 34 | 使用 Android Studio 安装 | 使用 SDK Manager |
| Java JDK | Android | JDK 8 或 JDK 11 | 不建议使用 JDK 17+ | JDK 11 下载 |
✅ 构建平台配置说明
👉 Windows 构建
安装 Visual Studio 2019 或 2022：
- 安装“使用 C++ 的桌面开发”工作负载
- 启用组件：
MSVC v14.x、Windows 10 SDK
确保
cmake可用且版本为3.22 ~ 3.26：
cmake --version
👉 Android 构建
- 推荐使用 Android Studio 配置 SDK 和 NDK。
- 在 Cocos Creator 中设置以下路径：
JDK 路径： C:\Program Files\Java\jdk-11.0.x
Android SDK： C:\Users\你的用户名\AppData\Local\Android\Sdk
NDK 路径： C:\Users\你的用户名\AppData\Local\Android\Sdk\ndk\25.2.9519653
✅ 推荐构建环境组合（稳定）
| 依赖项 | 推荐版本 |
|---|---|
| Node.js | 18.18.0 |
| Python | 3.10.11 |
| CMake | 3.26.4 |
| JDK | 11.0.20 |
| NDK | r25c |
| Visual Studio | VS2022 Community |
✅ 常见问题提示
- 避免将项目路径设置为包含中文、空格或特殊字符的位置。
- 打包失败请手动运行 CMake 命令查看更详细报错。
- 如果 CMake 版本过高（如 4.x），请降级到推荐版本。