各位开发者,你好!
为了提升引擎在特定 Android 设备(如 ARM64 架构的终端)上的兼容性与性能,我们近期完成了对 Android 16KB 内存页面大小 特性的支持工作。相关代码变更已准备就绪。
CocosCreator 下载链接
本次更新的核心内容
- 引擎核心库 (
engine仓库)
- 内容 : 包含了支持 Android 16KB 页面大小的关键代码改动。
- 状态 : 已提交 PR。
- 外部依赖库 (
external仓库)
- 内容 : 主要更新了 V8 的版本(11.8 -> 12.7.140) 以匹配新特性。
备选方案:避免 V8 升级带来的包体增长
如果您不希望升级 V8 引擎(例如出于控制包体大小的考虑),我们提供了备选方案:
-
引擎代码更新:参考
engine仓库的 PR #18999 中的代码变更,手动应用到您的引擎版本中。 -
external V8 库:从提供的 PR 更新 V8 库(包括 x64 和 arm64 架构)。
重点与反馈方向
我们特别希望您能在以下场景进行测试,并反馈任何异常情况:
- 核心功能回归测试 : 在 ARM64 Android 设备 (尤其是页面大小为16KB的设备)上,验证引擎的各项基础功能是否正常。
- 兼容性 :在升级 V8 前后,项目兼容性是否有出现问题。
- 性能表现 : 关注启动时间、内存占用、JS执行性能等是否有显著变化。
- 稳定性 : 长时间运行应用,检查是否存在崩溃(Crash)或内存泄漏。
如何开始集成?
- 获取代码 :
- 切换到 仓库的
v3.8.7-16k分支进行构建。 - external 用到了大文件,需要先安装 git lfs 才能正常下载
- 环境准备
- 【强烈建议】升级开发环境 :为确保构建过程顺利,请将 Android Studio 更新至 2024 年或更高版本 。旧版本IDE可能无法正确处理新的依赖或构建配置。
-
【重要】清理本地项目 :
- 若本地已有构建出的 Android 项目,请务必先 备份 您项目中的
native目录(如有自定义修改)。 -
删除 项目下的
native目录及相关构建缓存(如build目录),然后 重新执行构建 ,以确保所有原生依赖都被正确更新。
- 若本地已有构建出的 Android 项目,请务必先 备份 您项目中的
针对 Cocos Creator 2.x 用户
Cocos Creator 2.x 请参考 engine-native 仓库的 PR #4403 进行验证,过程中请确保使用 NDK 28 及以上版本。




