使用React Native BLEManager遇Android蓝牙扫描权限问题求助

问题分析 #

报错明确指向缺少BLUETOOTH_SCAN权限，这是Android 12（API 31）及以上版本新增的蓝牙细分权限。仅配置运行时的「使用应用时」权限不足以覆盖要求，必须同时在清单文件中正确声明权限，并根据App需求添加必要的权限标记。

解决方案 #

1. 完善AndroidManifest.xml权限声明 #

在项目的AndroidManifest.xml中添加以下权限配置：

<!-- Android 12+ 蓝牙扫描权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<!-- 若需通过蓝牙扫描获取设备位置，添加位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 兼容Android 11及以下版本的蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />

如果你的App不需要通过蓝牙扫描获取位置信息，可以给BLUETOOTH_SCAN权限添加标记以跳过位置权限要求：

<uses-permission android:name="android.permission.BLUETOOTH_SCAN"
    android:usesPermissionFlags="neverForLocation" />

2. 修正运行时权限申请逻辑 #

在React Native代码中，针对Android版本做权限适配，确保主动申请所需权限：

import { PermissionsAndroid, Platform } from 'react-native';

async function requestBlePermissions() {
  if (Platform.OS !== 'android') return true;

  const permissions = Platform.Version >= 31 
    ? [
        PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN,
        // 不需要位置则注释掉下面一行
        // PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION
      ]
    : [
        PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION,
        PermissionsAndroid.PERMISSIONS.BLUETOOTH_ADMIN
      ];

  const granted = await PermissionsAndroid.requestMultiple(permissions);
  return Object.values(granted).every(status => status === PermissionsAndroid.RESULTS.GRANTED);
}

3. 调整权限申请时机 #

确保在调用蓝牙扫描接口之前完成权限申请流程。比如在用户点击“扫描”按钮时，先执行权限请求，确认所有权限授予后再启动扫描操作。

关键注意事项 #

• Android 12+将蓝牙权限拆分为BLUETOOTH_SCAN、BLUETOOTH_ADVERTISE、BLUETOOTH_CONNECT三个细分权限，需根据App实际功能按需申请。
• 使用neverForLocation标记后，部分旧型号Android 12设备可能存在兼容性问题，需实测验证。

内容的提问来源于stack exchange，提问作者Griffin Doherty