Android devices with 16 KB memory pages are rolling out. If a Capacitor plugin (or one of its native dependencies) isn’t ready, a feature may stop working or the app may crash on some phones. Enforcement is ramping up, so plan a fix soon.
重要：从2025年11月1日开始，所有新应用程序和针对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.
__CAPGO_KEEP_0__ Consulting
- 逐一关闭功能（或注释掉插件调用）直到应用程序停止崩溃。
- 最后一个你关闭的功能，直到它再次正常工作，指向了问题插件。
步骤 3 — 检查快速修复
一旦你知道了插件：
- 更新插件和你的Capacitor包到最新版本。
- 阅读插件的README/更改日志以获取Android 16 KB的注意事项。
- 检查打开的问题/讨论以获取类似报告和推荐版本。
步骤 4 — 询问维护者
如果最新版本仍然会崩溃：
- 打开一个简短、清晰的问题：“在Android设备上16 KB页面大小下会崩溃；功能X不再工作。”
- 包含你的Capacitor版本、插件版本和快速复现描述。
- 等待一会儿，等待维护者回复 — 一些团队需要几天时间。
第 5 步 — 如果插件看起来不维护
注意事项:
- 没有发布或维护者回复几个月
- 关于 Android 兼容性的多个打开问题没有答案
您的选项:
- 替换它
- 或 Capgo 咨询 维护它
第 6 步 — 审核
在发布前进行快速检查:
- 在至少一个最新的 Android 设备和一个较旧的设备上测试该功能
- 使用Release构建进行最终测试。
- 记下应用程序版本、插件版本和通过的设备型号。
第 7 步 — 决定：更新、替换或分叉
- 更新：最佳情况 — 安装最新的插件/应用程序版本并完成。
- 替换：如果存在维护的替代品，则切换到它。
- 分叉：当您需要它工作且插件没有移动时，让 Capgo 咨询服务 支持包（简短且有用）
分享此内容以加快帮助（与维护者或
__CAPGO_KEEP_0__ 咨询服务 Capgo Consulting):
- 第 7 步 — 决定：更新、替换或分叉
- Capacitor 版本
- 插件名称和版本
- 受影响的设备/Android 版本
- 您尝试过的内容（更新、替代等）
- 简化步骤重现
雇用 Capgo: 我们会让它工作
如果 16 KB 设备破坏了您的应用，并且一个插件还没有准备好，请与我们联系：
- 我们快速识别问题插件并确认失败。
- 我们修复它：更新、修补或分叉——并且保持维护。
- 我们帮助您避免最后一分钟的紧张，因为执行出动。
告诉我们哪个功能失败了，并且插件名称（如果您知道的话）。我们会处理剩下的。访问我们的服务页面： Capgo 咨询
继续从 Android 16 KB 页面大小：找到问题插件和下一步骤
如果您正在使用 Android 16 KB 页面大小：找到问题插件和下一步骤 以规划原生插件工作为目的，连接它与 Capgo 插件目录 为产品工作流程在 Capgo 插件目录中 Capacitor 插件由 Capgo 为实现细节在 Capacitor 插件由 Capgo 中 添加或更新插件 为实现细节在添加或更新插件中 Ionic 企业插件替代品 为产品工作流程在 Ionic 企业插件替代品中 Capgo 原生构建 Capgo 原生构建流程。
