Flutter 三方库 serial 的鸿蒙化适配指南

3.2 基础开仓与发送示例

import 'package:serial/serial.dart';

Future<void> openOhosSerial() async {
  // 1. 请求权限并发现端口
  final port = await Serial.requestPort();
  // 2. 开启通信链路
  await port.open(baudRate: 115200);
  // 3. 发送鸿蒙指令
  final writer = port.writable.getWriter();
  await writer.write(Uint8List.fromList([0x01, 0x02, 0x03]));
  print("数据已成功推送至鸿蒙外设");
}

3.3 异步接收解析

// 在鸿蒙端持续监听串口回传
port.readable.stream.listen((data) {
  print("收到远端硬件回传：${data.length} 字节");
});

四、典型应用场景

4.1 鸿蒙智能收银：外接热敏打印机

通过串口向小票打印机发送 ESC/POS 指令，完成实时单据输出。

4.2 鸿蒙实验室：传感器数据采集

采集温湿度或压力传感器数据，在鸿蒙大屏上绘制实时波动曲线图。

五、OpenHarmony 平台适配挑战

5.1 Webview 的串口权限拦截 (Critical)

在鸿蒙系统开发中，默认的 Webview 容器处于安全考虑可能会禁用 serial API。开发者必须在鸿蒙 Native 层（ArkTS/C++）拦截 onPermissionRequest 事件，并显式授予 ohos.permission.SERIAL_PORT（根据具体版本路径有所差异），否则 Serial.requestPort() 在鸿蒙端将静默失效。

5.2 平台差异化处理 (断链重连)

鸿蒙手持设备在移动过程中，USB 连接器可能由于震动产生物理断开。serial 库支持通过 getPorts() 轮询已授权端口。建议在鸿蒙端实现一套'心跳包'与'重连机制'，确保当硬件再次插入时，应用能静默恢复通信。

六、综合实战演示

import 'package:flutter/material.dart';
import 'package:serial/serial.dart';

class OhosHardLinkDemo extends StatefulWidget {
  @override
  _OhosHardLinkDemoState createState() => _OhosHardLinkDemoState();
}

class _OhosHardLinkDemoState extends State<OhosHardLinkDemo> {
  String _status = "等待连接鸿蒙硬件...";

  void _connectDevice() async {
    try {
      final port = await Serial.requestPort();
      await port.open(baudRate: 9600);
      setState(() => _status = "✅ 串口已链接：BaudRate 9600");
    } catch (e) {
      setState(() => _status = "❌ 连接失败：$e");
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("鸿蒙硬软连接工作台")),
      body: Center(
        child: Column(
          children: [
            SizedBox(height: 50),
            Icon(Icons.settings_input_composite, size: 100, color: Colors.amber),
            Padding(
              padding: EdgeInsets.all(30),
              child: Text(_status, textAlign: TextAlign.center),
            ),
            ElevatedButton(
              onPressed: _connectDevice,
              child: Text("扫射鸿蒙可用串口"),
            )
          ],
        ),
      ),
    );
  }
}

七、总结

serial 库为鸿蒙应用打通了 Web 虚拟世界与硬件物理世界之间的屏障。虽然适配过程中需重点关注 Webview 的底层权限授予，但其标准化带来的高开发效率是其他方案无法比拟的。

知识点回顾：

1. requestPort 是触发鸿蒙权限弹窗的关键。
2. 鸿蒙 Native 层必须配合处理 Webview 的硬件授权回调。
3. 利用 Dart Stream 实现非阻塞式的串口高频数据交互。