具有 16 KB 内存页面的 Android 设备正在推出。如果 Capacitor 插件（或其本机依赖项之一）未准备好，功能可能会停止工作，或应用可能会在某些手机上崩溃。实施正在加强，所以立即计划修复。
重要：从 2025 年 11 月 1 日起，所有提交到 Google Play 并针对 Android 15+ 设备的新应用和现有应用的更新必须在 64 位设备上支持 16 KB 页面大小。
本指南简化了一切：找到失败的插件，检查简单的更新，如果插件看起来未维护，请要求 Capgo 咨询 为您分叉和维护它。
16 KB 设备上的症状
- 在某些 Android 手机上有效，在其他手机上失败（通常是较新的型号）。
- 当使用特定插件（相机、文件、蓝牙等）时，功能停止工作。
- 有时在调试中工作，在发布中不工作。
提示：尝试在最近的旗舰 Android 设备上重现早期问题。
第 1 步 — 确保这是插件问题
- 重现问题并注意您正在使用的功能。
- 在代码中临时隐藏/禁用该功能。如果问题消失，相关插件可能是原因。
第 2 步 — 找出哪个插件失败了
- 逐一关闭功能（或注释掉插件调用），直到应用停止失败。
- 您在它再次开始工作之前禁用的最后一个功能指向有问题的插件。
第 3 步 — 检查快速修复
一旦您知道了插件：
- 更新到插件和 Capacitor 包的最新版本。
- 阅读插件的 README/changelog 以了解 Android 16 KB 说明。
- 检查公开的问题/讨论，了解类似的报告和推荐的版本。
第 4 步 — 询问维护者
如果最新版本仍然失败：
- 打开一个简短明确的问题：“在 16 KB 页面大小的 Android 设备上失败；功能 X 不再工作。”
- 包括您的 Capacitor 版本、插件版本和快速重现描述。
- 等待响应 — 某些团队需要几天时间。
第 5 步 — 如果插件看起来未维护
需要注意的迹象：
- 几个月没有发布或维护者回复。
- 关于 Android 兼容性的多个公开问题没有答案。
您的选择：
- 用积极维护的替代品替换它。
- 或要求 Capgo 咨询 分叉并维护它，以便您的应用保持兼容。
第 6 步 — 健全性检查
在发货前进行快速检查：
- 在至少一个最新的 Android 设备和一个较旧的设备上测试该功能。
- 使用发布版本进行最终测试。
- 保持应用版本、插件版本和通过的设备型号的记录。
第 7 步 — 决定：更新、替换或分叉
- 更新：最好的情况 — 安装最新的插件/应用版本即可完成。
- 替换：切换到维护的替代品（如果存在）。
- 分叉：当您需要它工作而插件没有进行时，让 Capgo 咨询 为您分叉和维护。
支持包（简短而有用）
分享这个以加速帮助（与维护者或 Capgo 咨询）：
- 应用版本/内部版本号
- Capacitor 版本
- 插件名称和版本
- 受影响的设备/Android 版本
- 您尝试的内容（更新、替代品等）
- 简单的重现步骤
聘请 Capgo：我们会让它工作
如果 16 KB 设备破坏了您的应用，而插件还没有准备好，请与我们联系：
- 我们快速识别有问题的插件并确认故障。
- 我们修复它：更新、修补或分叉 — 并继续维护。
- 在推出实施时，我们帮助您避免最后一刻的仓促。
告诉我们哪个功能失败了以及插件名称（如果您知道的话）。我们会处理剩下的。访问我们的服务页面：Capgo 咨询