支持 16 KB 内存页的 Android 设备正在逐步推出。如果 Capacitor 插件（或其原生依赖项）尚未适配，某些功能可能会失效，甚至导致应用在部分手机上崩溃。随着强制执行力度的加大，请尽快制定修复计划。
重要提示：从 2025 年 11 月 1 日起，所有提交至 Google Play 且目标版本为 Android 15+ 的新应用及现有应用更新，都必须在 64 位设备上支持 16 KB 页大小。
本指南很简单：找出出问题的插件，检查能否轻松更新；如果插件看起来无人维护，可以请我们 Capgo 咨询 帮你 fork 并维护它。
16 KB 设备上的症状
- 在部分 Android 手机上正常，在其他机型（通常是较新机型）上会出问题。
- 使用特定插件（如相机、文件、蓝牙等）时，某个功能会失效。
- Debug 有时正常，Release 不行。
提示：在较新的 Android 旗舰机上测试，以便尽早复现。
第 1 步 — 确认是否为插件问题
- 复现问题，并记下你正在使用的功能。
- 在 code 中暂时隐藏或禁用该功能。如果问题消失，相关插件很可能就是原因。
第 2 步 — 找出故障插件
- 逐一关闭功能（或注释掉插件调用），直到应用不再报错。
- 恢复正常前最后关闭的那个功能，就指向有问题的插件。
第 3 步 — 检查是否有快速修复方案
确定是哪个插件后：
- 请将插件和 Capacitor 包更新到最新版本。
- 阅读插件的 README/changelog，了解 Android 16 KB 相关说明。
- 查看 open issues/discussions 中是否有类似报告和推荐版本。
第 4 步 — 联系维护者
如果最新版本仍然报错：
- 提交一个简短清晰的 issue：“在页面大小为 16 KB 的 Android 设备上崩溃；功能 X 无法使用。”
- 请注明您的 Capacitor 版本、插件版本以及简要的复现说明。
- 稍等回复——有些团队可能需要几天时间。
第 5 步 — 如果插件看起来已停止维护
需要注意的迹象：
- 数月没有发布新版本或维护者未回复。
- 存在多个关于 Android 兼容性的未解决 Issue。
你的选择：
- 替换为活跃维护的替代方案。
- 或者请求 Capgo 咨询 进行 fork 并进行维护，以确保你的 App 保持兼容。
第 6 步 — 完整性检查
发布前，请进行快速检查：
- 至少在一台较新的 Android 设备和一台旧设备上测试该功能。
- 使用 Release build 进行最终测试。
- 记录下通过测试的 App 版本、插件版本和设备型号。
第 7 步 — 决策：更新、替换或 Fork
- 更新：最佳情况 — 安装最新的插件/App 版本即可完成。
- 替换：如果存在其他维护中的替代方案，请切换过去。
- Fork：当你急需使用且插件不再维护时，可以 Capgo 咨询 将其 fork 并由你自行维护。
提供 Bundle 信息（简洁有效）
分享这些信息以加快求助速度（联系维护者或 Capgo 咨询):
- App 版本/构建号）
- Capacitor 版本
- 插件名称和版本
- 受影响的设备/Android 版本
- 已尝试的操作（更新、替代方案等）
- 简要复现步骤
聘请 Capgo：我们帮你搞定
如果 16 KB 设备导致您的 App 无法运行，而插件还没适配，请联系我们：
- 我们会快速定位问题插件并确认故障。
- 我们会修复：更新、打补丁或 fork，并持续维护。
- 随着强制执行逐步落地，我们会帮您避免临时赶工。
请告诉我们哪个功能出问题以及插件名称（如果知道的话）。剩下的交给我们。请访问我们的服务页面： Capgo 咨询
继续阅读：Android 16 KB 页大小——找出有问题的插件及后续操作
如果你正在使用 Android 16 KB 页大小：找出问题插件及下一步该怎么做 要规划原生插件工作，请将其与 Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 查看添加或更新插件中的实现细节， Ionic Enterprise 插件替代方案 查看 Ionic Enterprise 插件替代方案中的产品工作流，以及 Capgo Native Build 查看 Capgo Native Builds 中的产品工作流。
