React Native蓝牙开发初始化BleManager报非空参数错误如何解决

Invariant Violation: new NativeEventEmitter() requires a non-null argument 报错的核心原因是 react-native-ble-plx 对应的原生蓝牙模块未成功集成到项目中，创建 BleManager 实例时无法获取原生层提供的事件发射器实例。

• 第一步：完成依赖安装
  先确认核心库和配套权限库已安装：

  npm install react-native-ble-plx react-native-permissions --save
  

• 第二步：完成原生模块链接
  根据你使用的React Native版本做对应处理：

  • React Native 0.59及以下版本，手动执行链接命令：
    react-native link react-native-ble-plx
  • React Native 0.60及以上版本，安卓默认自动链接，iOS端需执行pod安装：

    cd ios && pod install && cd ..
    

  • 若你使用Expo开发，需先执行expo prebuild生成原生项目后再执行上述操作，Expo GO开发模式不支持该原生库。

• 第三步：配置蓝牙权限
  权限配置缺失也会导致原生模块初始化失败：

  • 安卓端在android/app/src/main/AndroidManifest.xml添加权限：

    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!-- 安卓12及以上额外权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    

  • iOS端在ios/[你的项目名]/Info.plist添加蓝牙使用说明：

    <key>NSBluetoothAlwaysUsageDescription</key>
    <string>需要使用蓝牙连接外设</string>
    <key>NSBluetoothPeripheralUsageDescription</key>
    <string>需要使用蓝牙连接外设</string>
    

• 第四步：重启编译项目
  完全关闭当前Metro服务，清除缓存后重新编译运行：

  # 重启Metro并清除缓存
  npx react-native start --reset-cache
  # 新开终端运行对应端应用
  # 安卓
  npx react-native run-android
  # iOS
  npx react-native run-ios
  

如果你启用了React Native新架构，需确认你使用的react-native-ble-plx版本兼容当前RN版本，版本不兼容也会触发原生模块加载失败的问题，可降级到适配的稳定版本后重试。

内容的提问来源于stack exchange，提问作者Timothy Wilmot