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