SDK对接文档

主题

官方文档 ​

  1. 谷歌官方文档

  2. Unity 升级方案

  3. CocosCreator 升级方案

前言 ​

重要通知：16 KB Google Play 兼容性要求 ​

自2025年11月1日起，提交到Google Play且以Android 15及更高版本的设备为目标平台的所有新应用和现有应用更新都必须支持64位设备上的16 KB页面大小。

Starting November 1st, 2025, all new apps and updates to existing apps submitted to Google Play and targeting Android 15+ devices must support 16 KB page sizes on 64-bit devices.

Google开始正式强制Android适配16 KB Page Size，这是一个关键的技术要求，确保您的用户能够在新设备上获得性能提升，并为平台未来在新硬件上的改进性能做好准备。如果不重新编译以支持16 KB页面，您的应用在这些设备变得更广泛普及时可能无法在这些设备上正常运行。官方数据显示，配置为使用16 KB页面大小的设备，平均会使用略多一些的内存，但系统和应用的性能也会得到各种提升。

性能提升预览

Google 测试显示，16 KB 页面可以带来：

  • 应用启动速度提升：3% 到 30% 不等
  • 电池续航改善：平均提升 4.5%
  • 相机启动加速：4.5% 到 6.6% 的提升
  • 系统启动加速：约 8% 的提升

适配方案 ​

Unity适配方案 ​


2021适配 ​

需要使用企业版证书下载 2021.3.56f2版本，该版本自动适配16kb

2022适配 ​

Unity引擎升级到 2022.3.67f2 即可

2023 & Unity6 ​

无需适配，直接支持16kb

  1. 现有的项目可以在 16 KB 的设备上运行吗？

答：Android 15 不可以， Android 16 增加了兼容模式，有可能运行。

  1. 项目依赖包含原生库的第三方插件/SDK。怎么好？

答：建议联系插件开发者，确保其原生库兼容 16 KB。您需要更新所有相关的 SDK，然后重新提交您的应用。

  1. 在构建时，Unity 版本使用 NDK 并不是最新的，所以导出的 Gradle 工程中，建议使用 AGP 较低的版本方式，参考： https://developer.android.com/guide/practices/page-sizes?hl=zh-cn#update-packaging

CocosCreator适配方案 ​

v3.8.7 ​

CocosCreator官方对v3.8.7版本，添加了-16k的分支，在构建前拉取引擎对应版本的16k分支后打包即可。

链接地址：https://github.com/cocos/cocos-engine/pull/18910

v3.x ~ v3.8.7 ​

对于v3.x ~ v3.8.7 之间的版本，也给出了升级方案，可以选择手动同步这部分代码修改，来适配16kb。

链接地址：https://github.com/cocos/cocos-engine/pull/18999

v2.x ​

对于v2.x版本的适配就比较麻烦了，目前官方只给出了v2.4.16版本的适配方案。

链接地址：https://github.com/cocos/engine-native/pull/4403

其他版本要参考此方案自行修改。

目前CocosCreator这边的方案还不够稳定，后续修改方案会持续迭代至此文档

点我快速对接
›