Modbus TCP 客户端 - 更新日志

1.3.13（2026-09-07）

  • 修复 Android：init 等成功回调 ClassCast（InitOption 不可强转为 BaseOption；按具体 Option 取 success/fail）
  • 须重打自定义基座并云端传统打包；.vue 直接传对象，.uvue 仍须 as XxxOption

1.3.12（2026-09-07）

  • 修复 Android：.vue 调用带数字字段与 success/fail 时 ClassCast（对外形参改回 XxxOption，由 JS 桥接正确映射回调）
  • uni-app x 调用请对入参使用 as XxxOption；须重打自定义基座并云端传统打包
  • 不传参行为与上一版兼容

1.3.11（2026-09-07）

  • 修复 Android：带数字参数（如 port/unitId/maxQueue）与 success/fail 同时传入时 ClassCast 崩溃
  • 入口透传对象字面量，按键名读取字段与回调；uni-app / uni-app x 均可直接传对象
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）

1.3.10（2026-09-07）

  • 优化 uni-app x：入口将对象字面量归一化为 Option，业务页可直接 init({...}) / connect({...}) / pollUnits({...})，无需再写 as XxxOption
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容

1.3.9（2026-09-06）

  • 修复 Android 运行时 ClassCastException：成功回调结果改为 UTSJSONObject 别名，避免 UTSJSONObject 强转为独立 SuccessResult 类型
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 【务必使用此版本及以上版本打包使用，低版本存在缺陷】

1.3.8（2026-09-05）

  • 修复 Android 云打包：可选 number 去掉 undefined 联合与危险三元，避免 compareTo / expected Number actual Any
  • 三端对齐 coalesce；去掉 as ErrorCode / ?? / setTimeout as number 等易触发云编译问题的写法
  • Android InputStream.read 返回值先 Number.from 再比较；协议层去掉 >>>，改 toU32；iOS IO 错误码去嵌套三元
  • invoke 回调改为判空后直接调用（去掉 ?.success?.）；iOS 关闭流去可选链；空数组去掉 as 断言
  • 可变属性改局部拷贝：socket/streamTask/队列 shift、defaultByteOrder、多写 values、host/items/onConnectionLost/pdu，避免 ! 与 smart cast 失败
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容
  • 【务必使用此版本及以上版本打包使用，低版本存在缺陷】

1.3.7（2026-09-04）

  • 修复 Android 云打包：可选 number 先赋局部再比较，避免 Number.from 收可空联合与可变属性 smart cast 失败
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容
  • 【务必使用此版本及以上版本打包使用，低版本存在缺陷】

1.3.6（2026-09-04）

  • 修复 Android 云打包：可选 number（unitId/timeout/port 等）先 Number.from 再比较返回，避免 compareTo / expected Number actual Any
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容
  • 【务必使用此版本及以上版本打包使用，低版本存在缺陷】

1.3.5（2026-09-04）

  • 修复 Android 云打包：number 调用原生 API 显式转 Int/Byte/Long；ByteArray 用 size；Kotlin 值用 Number.from
  • 修复 Option 回调与 pollUnits：invoke 入参 any；dispatchPollItem 用 BaseOption 取 success/fail；扩展字段经 UTSJSONObject
  • 使用说明明确：pollUnits 支持同一从站多地址批量读写（同 unitId、不同 address）
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 【务必使用此版本及以上版本打包使用，低版本存在缺陷】

1.3.4（2026-09-03）

  • 修复 UTS Option 类型：去掉对象类型交叉，改为扁平单 type，满足普通授权云编译
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容

1.3.3（2026-09-02）

  • 修复 UTS 类型声明：去掉匿名对象交叉与 index signature，满足 UTS110111101（普通授权云编译）
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容

1.3.2（2026-09-02）

  • 平台插件版本号与最低系统版本声明对齐；清理源码授权相关声明
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容

1.3.1（2026-09-02）

  • 平台插件版本号对齐本版；清理源码授权相关声明
  • 使用须制作自定义基座，并走云端传统打包（不支持离线打包、安心打包）
  • 不传参行为与上一版兼容

1.3.0（2026-08-17）

  • 新增多从站巡检 pollUnits：可按顺序调度多个 unitId 的读写并汇总结果
  • 导出 clearQueue / cancelPending：清空等待队列；排队中请求返回「队列已清空」
  • 数值辅助支持工业四字序 ABCD / BADC / CDAB / DCBA（BE/LE 仍为别名）；float32 / u32 挂其上
  • 从站异常码 01～08 写入中文 errMsg；完善默认错误文案
  • destroy 取消排队请求并复位；uni-app x 鸿蒙支持；平台插件版本号对齐本版
  • 不传参行为与上一版兼容（默认字节序仍为大端）

1.2.0（2026-08-17）

  • 读写请求在忙碌时自动入队串行执行，不再立即返回忙碌失败
  • init.maxQueue：可选队列上限；满时仍返回 9050002；不传表示不限制
  • 清理源码授权声明；平台插件版本号对齐本版
  • 不传参行为与上一版兼容（单请求路径不变）

1.1.0（2026-08-13）

  • 新增 init.transport：可选 tcp（默认，标准 MBAP）或 rtu-over-tcp（RTU 帧 + CRC16，经 TCP，适配串口服务器）
  • 不传 transport 时行为与上一版完全一致
  • 新增错误码 9050012（CRC 校验失败）；功能码 API 不变

1.0.0（2026-08-11）

  • 首个市场正式版：Android / iOS / 鸿蒙 TCP；FC01～06、FC15、FC16
  • 寄存器数值辅助（i16 / u32BE / float32BE）与 init.defaultByteOrder、registersToU32 / registersToFloat32（可选 LE）
  • 支持 App-vue / App-nvue、uni-app x App（Android/iOS）；微信小程序本期不支持