Cocos 打包 APK 兼容环境表(Android API Level 10~15)
使用 Cocos 打包 APK:Android 10 ~ Android 15 兼容版本对照表
✅ 本表基于 Cocos Creator 3.x 实际测试及官方建议整理
📆 最后更新时间:2025年6月
💡 推荐使用 Android Studio 2022+ 或命令行构建工具
Android 版本 | API Level | 推荐 Cocos 版本 | Android SDK Platform | NDK Version | Gradle Version | CMake Version |
---|---|---|---|---|---|---|
Android 10 | 29 | Cocos Creator 3.6 ~ 3.8 | android-29 | r21e 或 r23b | 7.4.2 | 3.22.1 |
Android 11 | 30 | Cocos Creator 3.6 ~ 3.8 | android-30 | r21e 或 r23b | 7.4.2 | 3.22.1 |
Android 12 | 31/32 | Cocos Creator 3.7 ~ 3.8 | android-31, android-32 | r23b 或 r25c | 8.0.2 | 3.22.1 |
Android 13 | 33 | Cocos Creator 3.8.1+ | android-33 | r25c | 8.1.0 | 3.22.1 |
Android 14 | 34 | Cocos Creator 3.8.2+ | android-34 | r26b | 8.3.0 | 3.22.1 |
Android 15 | 35(预览) | Cocos Creator 3.8.2+ | android-34(兼容构建) | r26b | 8.4.0(预览) | 3.22.1 |
✅ 开发环境建议
- Cocos Creator:3.6 ~ 3.8.2 是支持 Android 29~34 最稳定版本
- Android SDK Tools:建议安装 Android SDK Platform 29~34,全选安装
- NDK 推荐版本:
- 稳定优先:
r23b
(官方长期支持) - 高兼容版本:
r25c
(支持新架构)
- 稳定优先:
- Gradle Plugin 版本:
- 修改
build.gradle
里com.android.tools.build:gradle
- 建议配套使用 Android Studio 自动生成的版本
- 修改
- CMake:
- 安装 Android Studio 的 SDK Manager 中内置版本
3.22.1
- 如果使用 CLI,可通过
sdkmanager
安装:cmake;3.22.1
- 安装 Android Studio 的 SDK Manager 中内置版本
⚠️ 注意事项
- Android 15 目前为开发者预览版,建议使用 Android 14 构建测试
- 若使用远程构建或自动打包,确保 CI 环境中的 NDK/SDK/Gradle 版本一致
- 使用 Cocos Dashboard 可自动配置大部分构建环境(推荐使用)