Android设备的16 KB内存页面正在推出。如果一个Capacitor插件(或其本机依赖项)没有准备好,某个功能可能会停止工作,或者在某些手机上会出现崩溃。强制执行正在加剧,因此尽快计划解决方案。
重要提示:从2025年11月1日起,所有提交到Google Play的新应用和更新的现有应用,针对Android 15+设备,必须支持64位设备上的16 KB页面大小。
这份指南简单明了:找到会出问题的插件,检查是否有简单的更新,如果插件看起来不再维护,建议 Capgo 咨询 16 KB 设备上的症状
在某些安卓手机上可以正常工作,但在其他手机上会出问题(尤其是新款手机)。
- 当使用特定的插件时(摄像头、文件、蓝牙等),某个功能会停止工作。
- 调试时可以正常工作,但发布版却不能正常工作。
- 提示:尝试在最新款旗舰安卓设备上重现问题。
步骤 1 — 确保是插件问题
重现问题并记录正在使用的功能。
- 暂时隐藏/禁用 __CAPGO_KEEP_0__ 中的该功能。如果问题消失,相关插件很可能是原因。
- Temporarily hide/disable that feature in code. If the problem disappears, the related plugin is likely the cause.
步骤 2 — 找到会出问题的插件
- 逐一关闭功能(或注释掉插件调用)直到应用程序停止崩溃。
- 在应用程序恢复正常工作之前最后一次关闭的功能指向了问题插件。
步骤 3 — 检查快速修复
一旦你知道了插件:
- 更新插件和你的Capacitor包的最新版本。
- 阅读插件的README/changelog以获取Android 16 KB注意事项。
- 检查开放的问题/讨论以查找类似报告和推荐版本。
步骤 4 — 询问维护者
如果最新版本仍然崩溃:
- 打开一个简短、清晰的问题:“在Android设备上(16 KB页面大小)崩溃;功能X不再工作。”
- 包含你的Capacitor版本、插件版本和快速重现描述。
- 等待一下回应 — 一些团队需要几天时间。
第 5 步 — 如果插件看起来不维护
需要注意的迹象:
- 没有发布或维护者回复几个月
- 关于 Android 兼容性的多个打开问题没有答案
您的选项:
- 替换它使用一个活跃维护的替代品
- 或者问 Capgo 咨询 让它分叉并维护它以确保您的应用程序保持兼容
第 6 步 — 审计
在发布之前,进行快速检查:
- 在至少一个最新的 Android 设备和一个较旧的设备上测试该功能
- 使用 Release 构建进行最终测试。
- 记下应用版本、插件版本和通过的设备型号。
第 7 步 — 决定:更新、替换或分叉
- 更新:最佳情况 — 安装最新的插件/应用版本并完成。
- 替换:如果有一个维护的替代品存在,则切换到它。
- 分叉:当您需要它工作且插件没有移动时,让 Capgo 咨询 分叉并为您维护它。
支持包(简短且有用)
分享此内容以加快帮助(与维护者或 Capgo 咨询):
- 应用版本/构建号
- Capacitor 版本
- 插件名称和版本
- 受影响的设备/Android 版本
- 您尝试过的内容(更新、替代等)
- 简化步骤重现问题
雇用 Capgo: 我们会让它工作
如果 16 KB 设备破坏了您的应用程序,并且一个插件尚未准备好,请与我们联系:
- 我们快速识别问题插件并确认失败
- 我们修复它:更新、修补或分叉——并保持其维护
- 我们帮助您避免最后一分钟的紧张局势,因为执行出台
告诉我们哪个功能失败了,并且插件名称(如果您知道它)。我们会处理剩下的。访问我们的服务页面: Capgo 咨询