Android 设备的 16 KB 内存页面正在推出。如果一个 Capacitor 插件（或其本机依赖项）没有准备好，某个功能可能会停止工作或在某些手机上崩溃。强制执行正在加速，因此尽快计划修复。
重要提示：从 2025 年 11 月 1 日起，所有新应用程序和针对 Android 15+ 设备的现有应用程序的更新必须支持 64 位设备上的 16 KB 页面大小。
本指南保持简单：找到会导致问题的插件，检查是否有简单的更新，如果插件看起来不维护，请 Capgo 咨询 16 KB 设备上的症状
在某些 Android 手机上工作，在其他手机上会崩溃（通常是新款手机）。
- 当使用特定插件时（摄像头、文件、蓝牙等），某个功能会停止工作。
- 插件
- 调试有时会工作，但Release不行。
提示：尝试在最新旗舰Android设备上重现早期问题。
步骤 1 — 确保是插件问题
- 重现问题并记录您正在使用的功能。
- 临时隐藏/禁用该功能（code），如果问题消失，相关插件很可能是原因。
步骤 2 — 找到哪个插件出问题
- 逐一关闭功能（或注释掉插件调用）直到应用程序停止失败。
- 最后一个您禁用的功能之前应用程序恢复工作的功能指向问题插件。
步骤 3 — 检查快速修复
一旦您知道插件：
- 更新插件和您的Capacitor包的最新版本。
- 阅读插件的README/更改日志以获取Android 16 KB的说明。
- 检查类似报告和推荐版本的开源问题/讨论。
步骤 4 — 向维护者提问。
如果最新版本仍然会崩溃：
- 打开一个简短、清晰的问题： “在 Android 设备上（16 KB 页面大小）会崩溃；特性 X 不再工作。”
- 包含您的 Capacitor 版本、插件版本和快速复现描述。
- 等待一下回应 — 一些团队需要几天时间。
步骤 5 — 如果插件看起来不被维护
注意以下迹象：
- 几个月没有发布或维护者回复。
- 关于 Android 兼容性的多个开源问题没有答案。
您的选项：
- 用一个活跃维护的替代品替换它。
- 或者请问 Capgo 咨询 以确保您的应用程序兼容性
第 6 步 — 审核
在交付之前，进行快速检查：
- 在至少一个最新的 Android 设备和一个较旧的设备上测试该功能。
- 使用 Release 构建进行最终测试。
- 记下通过的应用程序版本、插件版本和设备模型。
第 7 步 — 决定：更新、替换或分叉
- 更新：最佳情况 — 安装最新的插件/应用程序版本并完成。
- 替换：如果存在维护的替代品，则切换到它。
- 分叉：当您需要它工作并且插件没有移动时， Capgo 咨询服务 我们会帮你 fork 和维护它。
支持包 (简洁且有用)
分享此内容以加速帮助 (与维护者或) Capgo 咨询服务):
- 应用程序版本/构建号
- Capacitor 版本
- 插件名称和版本
- 受影响的设备/Android 版本
- 您尝试过的内容 (更新、替代等)
- 简化步骤以重现问题
聘用 Capgo: 我们会让它工作
If 16 KB devices are breaking your app and a plugin isn’t ready, please contact us:
- We quickly identify the problematic plugin and confirm the failure.
- We will fix it: update, patch, or fork — and continue to maintain it.
- We can help you avoid last-minute rushes as enforcement rolls out.
Please tell us which feature is failing and the plugin name (if you know it). We will handle the rest. Please visit our services page: Capgo Consulting
Continue from Android 16 KB Page Size: Find the Problem Plugin and What to Do Next
If you are using Android 16 KB Page Size: Find the Problem Plugin and What to Do Next to plan native plugin work, connect it with Capgo Plugin Directory for the product workflow in Capgo Plugin Directory Capacitor Capgo Capacitor Capgo 添加或更新插件 添加或更新插件 Ionic 企业插件替代品 为 Ionic 企业插件替代品的产品工作流程 Capgo 本机构建 为 Capgo 本机构建的产品工作流程
