React Native BLE Manager 在 Android 蓝牙 5.1+ 版本上的通知数据读取问题解析

问题背景

在使用 React Native BLE Manager 库（版本 11.0.5）进行蓝牙开发时，开发者遇到了一个特定于 Android 设备蓝牙版本的问题。当设备蓝牙版本为 5.0 时一切正常，但在蓝牙 5.1 及更高版本的设备上，应用在尝试读取通知数据时会意外崩溃。

核心问题表现

1. 蓝牙连接和写入操作（writeWithoutResponse）在所有版本设备上都能正常工作
2. 当尝试使用 notifyRead 方法监听蓝牙设备发送的通知数据时
3. 仅蓝牙 5.1+ 设备会出现应用崩溃
4. 崩溃发生时没有明确的错误信息输出

问题根源分析

经过深入排查，发现问题与 Android 系统的权限管理机制变化有关。从 Android 6.0 (API 23) 开始，系统对位置权限的要求变得更加严格，而蓝牙扫描功能需要位置权限的支持。

特别是从 Android 10 (API 29) 开始，系统对位置权限的管理又有了新的调整。开发者最初在 AndroidManifest.xml 中设置的权限声明限制了最大 SDK 版本为 28：

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="28"/>

这种设置会导致在较新的 Android 版本上权限不足，从而引发应用崩溃。

解决方案

将 AndroidManifest.xml 中的位置权限声明修改为：

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30"/>

这个修改将权限支持扩展到 Android 11 (API 30)，解决了在新版本系统上的兼容性问题。

深入理解

1. 蓝牙与位置权限的关系：Android 系统要求蓝牙扫描需要位置权限，这是因为蓝牙信号可以被用来推断设备位置

2. maxSdkVersion 的作用：这个属性指定了权限适用的最高 API 级别，超过这个版本的设备将不再需要此权限

3. 版本兼容性考虑：随着 Android 系统更新，权限模型也在不断演进，开发者需要关注目标设备群体的系统版本分布

最佳实践建议

1. 对于需要支持最新 Android 版本的蓝牙应用，建议将 maxSdkVersion 设置为 30 或更高

2. 除了清单文件中的声明，运行时还需要动态请求位置权限

3. 考虑使用 ACCESS_FINE_LOCATION 替代 ACCESS_COARSE_LOCATION 以获得更全面的功能支持

4. 在代码中添加适当的错误处理机制，即使解决了权限问题，也应优雅地处理各种异常情况

总结

这个案例展示了 Android 权限模型变化可能导致的兼容性问题。作为 React Native 开发者，在实现蓝牙功能时，不仅要关注库本身的使用，还需要了解底层平台的权限机制变化，特别是当目标设备覆盖多种 Android 版本时。通过合理配置权限声明和运行时检查，可以确保应用在各种设备上稳定运行。