Capacitor Android应用在蓝牙设备连接时崩溃问题解析

问题现象

在基于Capacitor 6.0.0构建的Android应用中，当用户将应用切换到后台后连接或断开蓝牙设备（特别是BLE设备如iRig BlueTurn），再次返回应用时会出现应用崩溃并重启的现象。这种异常行为影响了用户体验，特别是在需要频繁使用蓝牙外设的场景下。

技术背景

Android系统有一个特殊机制：当设备配置发生变化时（如屏幕旋转、语言切换、输入设备连接等），系统默认会销毁并重建当前Activity。这种行为虽然保证了应用能适应新的配置环境，但有时会导致不必要的应用重启。

Capacitor作为混合应用框架，虽然已经处理了部分常见的配置变更情况（如屏幕方向变化），但对于蓝牙设备连接/断开这类事件的处理还不够完善。

根本原因分析

经过技术团队深入调查，发现问题根源在于：

1. Android系统将蓝牙设备的连接/断开视为一种"配置变更"（configuration change）
2. 默认情况下，这类变更会触发Activity重建
3. Capacitor框架未完全覆盖这种特定类型的配置变更处理
4. 某些Android设备（特别是需要导航功能的设备）对此类事件更为敏感

解决方案

解决此问题有两种途径：

1. 修改AndroidManifest.xml（推荐）

在应用的AndroidManifest.xml文件中，为MainActivity添加configChanges属性，明确声明应用将自行处理蓝牙相关的配置变更：

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|screenLayout|smallestScreenSize|navigation|bluetooth"
    ... >
</activity>

其中关键点是添加了bluetooth和navigation配置项，告知系统这些变更不应触发Activity重建。

2. 覆盖Activity配置变更处理

对于已经发布的应用，可以通过Java/Kotlin代码在Activity中覆盖配置变更处理方法：

@Override
public void onConfigurationChanged(Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    // 自定义处理逻辑
}

注意事项

1. 此问题主要影响Capacitor 6.x版本的Android应用
2. 解决方案对新建项目和已有项目都有效
3. 对于已发布应用，建议采用第一种方案作为长期解决方案
4. 测试时建议使用真实的BLE设备（如蓝牙键盘、耳机等）进行验证

最佳实践

为避免类似问题，开发者在Capacitor项目开发中应当：

1. 全面测试应用在各种设备配置变更下的行为
2. 提前在AndroidManifest中声明所有可能处理的配置变更
3. 对于关键业务流程，实现状态保存和恢复机制
4. 定期更新Capacitor版本以获取最新的兼容性修复

通过以上措施，可以有效避免因系统配置变更导致的应用意外重启问题，提升用户体验和应用稳定性。