Flutter 安卓USB串口插件——全面安装与配置手册（小白版）

Flutter 安卓USB串口插件——全面安装与配置手册（小白版）

usbserial Flutter Android USB Serial plugin 项目地址: https://gitcode.com/gh_mirrors/usb/usbserial

项目基础介绍及编程语言

项目名称：Flutter安卓USB串口插件 主要编程语言：Dart（Flutter框架）、Java（Android原生部分） 本项目由altera2015维护，旨在提供一个易于使用的Flutter插件，使得开发者能够通过Flutter代码控制连接至安卓设备上的USB串行设备，如FTDI、Arduino等。它基于felHR85的UsbSerial库实现了与多种USB串行设备的交互，极大简化了在Flutter应用中集成USB通信的过程。

关键技术和框架

• Flutter框架：用于构建跨平台的UI。
• felHR85/UsbSerial：作为核心依赖，处理Android端的USB串行通信。
• 异步API与事务API：提供了两种API模式，异步API适用于实时数据交换，而事务API便于基于特定格式的数据交换操作。

准备工作与详细安装配置步骤

第一步：环境准备

确保您已安装：

• Flutter SDK：最新稳定版本。
• Android Studio：带有Android SDK。
• Xcode（仅iOS开发时需要）。
• Git：用于克隆项目源码。

第二步：获取项目源码

打开终端，使用git命令下载项目到本地：

git clone https://github.com/altera2015/usbserial.git

第三步：设置AndroidManifest.xml

为了监听特定USB设备插入，需在您的应用的AndroidManifest.xml文件内添加如下代码段：

<intent-filter>
    <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
</intent-filter>
<meta-data android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" android:resource="@xml/device_filter" />

同时，在res/xml目录下创建device_filter.xml文件，并列出您想支持的设备ID（示例代码已在项目中提供）。

第四步：添加依赖

在Flutter项目的pubspec.yaml文件中，添加usb_serial插件依赖：

dependencies:
  flutter:
    sdk: flutter
  usb_serial: ^0.5.0  # 使用实际最新的版本号

之后运行flutter pub get以安装依赖。

第五步：基本使用与配置

在您的Flutter代码中导入插件：

import 'package:usb_serial/usb_serial.dart';

简单实例展示如何查找并连接设备：

Future<void> _connectToDevice() async {
  List<UsbDevice> devices = await UsbSerial.listDevices();
  if (devices.isEmpty) {
    print('No devices found');
    return;
  }
  
  UsbPort port = await devices.first.create();
  bool isOpen = await port.open();
  if (!isOpen) {
    print('Failed to open the USB device.');
    return;
  }

  // 设置串口参数
  await port.setPortParameters(115200, UsbPort.DATABITS_8, UsbPort.STOPBITS_1, UsbPort.PARITY_NONE);
  
  // 数据读取与写入示例
  port.inputStream.listen((data) => print('Received: ${data}'));
  await port.write(Uint8List.fromList([0x10, 0x00]));
  
  // 记得关闭端口
  await port.close();
}

至此，您已完成了项目的配置与基本使用流程。请注意，实际应用中还需处理权限请求以及异常情况，以保证应用的健壮性。祝您开发顺利！

usbserial Flutter Android USB Serial plugin 项目地址: https://gitcode.com/gh_mirrors/usb/usbserial