Android 设备的 16 KB 内存页面正在推出。如果一个 Capacitor 插件（或其本机依赖项）没有准备好，某个功能可能会停止工作，或者在某些手机上会出现崩溃。强制执行正在加速，因此尽快计划修复。
重要提示：从 2025 年 11 月 1 日起，所有向 Google Play 提交的新应用和现有应用的更新，针对 Android 15+ 设备必须支持 64 位设备上的 16 KB 页面大小。
本指南简化了流程：找到会出现问题的插件，检查是否有简单的更新，如果插件看起来不维护，请 Capgo 咨询 to fork and maintain it for you.
16 KB 设备上的症状
- 在某些安卓手机上工作，其他手机上会崩溃（通常是新款手机）。
- 当使用特定插件（摄像头、文件、蓝牙等）时，某个功能会停止工作。
- 调试有时会工作，发布版本不会工作。
提示：尝试在最新旗舰安卓设备上重现问题。
步骤 1 — 确保是插件问题
- 重现问题并记录正在使用的功能。
- 暂时隐藏/禁用 code 中的该功能。如果问题消失，相关插件很可能是原因。
步骤 2 — 找到失败的插件
- 逐一关闭功能（或注释掉插件调用）直到应用程序停止崩溃。
- 最后一个你禁用的功能之前它开始正常工作，指向问题插件。
步骤 3 — 检查快速修复
一旦您了解插件：
- 更新插件和您的 Capacitor 包的最新版本。
- 阅读插件的 README/ changelog 以获取 Android 16 KB 的注意事项。
- 检查开放的问题/讨论以查找类似报告和推荐版本。
步骤 4 — 询问维护者
如果最新版本仍然会崩溃：
- 打开一个清晰的短期问题： “在 Android 设备上（16 KB 页面大小）会崩溃；功能 X 不再工作。”
- 包含您的 Capacitor 版本、插件版本和快速复现描述。
- 等待一下回应 — 一些团队需要几天时间。
步骤 5 — 如果插件看起来不维护
需要注意的迹象：
- No releases or maintainer replies for months.
- Android兼容性问题多个未解决的issue.
Your options:
- 将其替换为一个活跃维护的替代品.
- Or ask Capgo 咨询 向应用程序保持兼容性而fork和维护它
Step 6 — Sanity Checks
在发布前进行快速检查：
- 在至少一个最新的Android设备和一个较旧的设备上测试该功能。
- 使用Release build进行最终测试。
- 记录通过的应用程序版本、插件版本和设备型号。
第 7 步 — 决定：更新、替换或分叉
- 更新：最佳情况 — 安装最新插件/应用程序版本并完成。
- 替换：如果存在一个维护的替代品，则切换到它。
- 分叉：当您需要它工作并且插件没有移动时，让 Capgo 咨询 分叉并为您维护它。
支持包（简短且有用）
分享此内容以加快帮助（与维护者或 Capgo 咨询):
- 应用程序版本/构建号
- Capacitor 版本
- 插件名称和版本
- 受影响的设备/Android 版本
- 您尝试过的内容（更新、替代等）
- 简化步骤来重现问题
雇用 Capgo: 我们会让它工作
如果 16 KB 设备破坏了您的应用程序，并且插件尚未准备好，请与我们联系：
- 我们快速识别问题插件并确认失败
- 我们修复它：更新、补丁或分叉——并保持其维护
- 我们帮助您避免最后一分钟的紧张局势，因为执行出台
告诉我们哪个功能失败了，并且插件名称（如果您知道它）。我们会处理剩下的。访问我们的服务页面： Capgo 咨询
继续从 Android 16 KB 页面大小：找到问题插件并继续下一步
如果您正在使用 Android 16 KB 页面大小：找到问题插件并了解下一步骤 为了规划原生插件工作，连接它到 Capgo 插件目录 在Capgo 插件目录中，了解产品工作流程 Capacitor 插件由Capgo 了解Capacitor 插件由Capgo 的实现细节 添加或更新插件 了解添加或更新插件的实现细节 Ionic 企业插件替代方案 了解Ionic 企业插件替代方案的产品工作流程， Capgo 原生构建 了解Capgo 原生构建的产品工作流程。
