React Native Android与USB设备通信报错求助及替代库推荐

我需要在React Native的Android端实现与USB设备的串口通信，但找不到靠谱的React Native库。目前正在试用react-native-usb-serialport-for-android，但运行代码时出现了错误。附上代码片段和报错内容，求帮忙解决，同时也欢迎推荐其他好用的同类库。

代码片段 #

import {
  UsbSerialManager,
  UsbSerial,
  Parity,
} from "react-native-usb-serialport-for-android"
import {Alert} from "react-native"

/**
 * Requests USB permission and opens a USB serial port.
 * @returns {Promise<null>} A promise that resolves to null.
 */
export async function requestUSBPermission(): Promise<null> {
  try {
    // Get a list of available USB devices
    const devices = await UsbSerialManager.list();

    // Try to request permission for the first device in the list
    const granted = await UsbSerialManager.tryRequestPermission(
      devices[0].deviceId
    );

    if (granted) {
      // Open a USB serial port with the specified configuration
      const usbSerialport = await UsbSerialManager.open(devices[0].deviceId, {
        baudRate: 9600,
        parity: Parity.None,
        dataBits: 8,
        stopBits: 1
      });

      // TODO: Add code to interact with the USB serial port

    } else {
      // Show an alert indicating that USB permission was denied
      Alert.alert('USB permission denied');
      return null;
    }

    return null;
  } catch (err) {
    // Log any errors that occur during USB permission request or port opening
    console.error(err);
    return null;
  }
}

报错信息 #

执行上述函数时触发以下错误：

TypeError: null is not an object (evaluating 'devices[0].deviceId')

问题排查与修复建议 #

• 添加设备空检查：错误根源是devices返回空数组，直接访问devices[0]导致报错。先判断设备列表是否为空：

  const devices = await UsbSerialManager.list();
  if (devices.length === 0) {
    Alert.alert('未检测到USB设备');
    return null;
  }
  

• 确认权限配置：在Android项目的AndroidManifest.xml中添加必要的USB权限声明：

  <uses-permission android:name="android.permission.USB_PERMISSION" />
  <uses-feature android:name="android.hardware.usb.host" />
  

• 检查版本兼容性：确保react-native-usb-serialport-for-android版本与你的React Native版本匹配，可尝试切换到库的稳定版本。

替代USB串口库推荐 #

• react-native-usb-serial：社区活跃度高，支持多种串口参数配置，适配多数Android设备，文档齐全。
• react-native-serial-port-api：支持USB和蓝牙双串口通信，API设计简洁，适合快速集成。
• rn-usb-serial：轻量级Android USB串口库，集成步骤简单，专注核心功能实现。

内容的提问来源于stack exchange，提问作者Pelé Peluche