Android 设备的 16 KB 内存页面正在推出。如果一个 Capacitor 插件（或其本机依赖项）没有准备好，一些功能可能会停止工作，或者在某些手机上会崩溃。强制措施正在加强，因此尽快计划修复。
重要提示：从 2025 年 11 月 1 日起，所有新应用程序和针对 Android 15+ 设备的现有应用程序的更新必须支持 64 位设备上的 16 KB 页面大小。
本指南简单明了：找到会导致问题的插件，检查是否有简单的更新，如果插件看起来不再维护，请 Capgo 咨询 16 KB 设备上的症状
在某些 Android 手机上工作，但在其他手机上会崩溃（通常是新款手机）。
- 当使用特定插件（摄像头、文件、蓝牙等）时，某个功能会停止工作。
- 调试有时会工作，但发布版本不会。
- 提示：尝试在最新旗舰 Android 设备上重现问题。
Editor
步骤 1 — 确保这是插件问题
- 重现问题并记录正在使用的功能
- 暂时隐藏/禁用该功能（code）。如果问题消失，相关插件很可能是原因
步骤 2 — 找到失败的插件
- 逐一关闭功能（或注释掉插件调用）直到应用程序停止失败
- 最后一个您禁用的功能指向问题插件
步骤 3 — 检查快速修复
一旦您知道插件：
- 更新插件和您的Capacitor包的最新版本
- 阅读插件的README/更改日志以获取Android 16 KB的说明
- 检查类似报告和推荐版本的开源问题/讨论
步骤 4 — 询问维护者
If the latest version still breaks:
- 打开一个清晰的issue： “在Android设备上16 KB页面大小下，功能X不再工作。”
- 包含您的 Capacitor 版本、插件版本和快速复现描述。
- 稍等一下，等待回复 — 一些团队需要几天时间。
第 5 步 — 如果插件看起来不维护
注意事项：
- 几个月没有发布或维护者回复。
- 关于Android兼容性的多个打开问题没有答案。
您的选项：
- 替换它使用一个活跃维护的替代品。
- 或者请 Capgo 咨询 为了让您的应用程序保持兼容，需要将其分叉并维护它。
第 6 步 — Sanity Checks
在交付之前，进行快速检查：
- 在至少一个最新的 Android 设备和一个较旧的设备上测试该功能。
- 使用 Release 构建进行最终测试。
- 记下通过的应用程序版本、插件版本和设备模型。
第 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原生构建的产品工作流程
