01
先理解现有应用。
在改动依赖或源码前，识别语言、UI 架构、状态归属与现有测试。
指南涵盖内容
面向生产的路径，不止一段示例代码。
在修改代码前，指南会明确产品、传输、权限、状态归属与连接生命周期，让集成建立在可靠上下文上。
02
选择准确的读写器路径。
明确 TT7、TT5 或 TT3，以及 BLE、Wi-Fi 或 USB。电池备份版本使用对应的 TT SDK 型号。
发现
连接
就绪
盘点
03
验证软件，并指出硬件检查项。
运行项目现有格式化、构建与测试命令，模拟回调与状态边界，并列出仍需实体读写器、BLE、网络或 USB 完成的检查。
Helios 小程序
把受信任的网页应用变成 RFID 操作界面。
只需部署一次网页，把 HTTPS 地址添加到 Helios Showcase，即可通过注入的桥接对象操作读写器。页面继续使用您现有的 HTML、CSS、框架与状态管理，无需为网页重写原生界面。
01 · 网页
您的 HTTPS 页面
任意响应式网页技术栈
02 · 桥接
Helios Showcase
Promise 调用 · 事件返回
03 · 硬件
Mark3 读写器
BLE · Wi-Fi · USB*
在 Showcase 中连接，在网页中渲染事件。
- 1
部署到受信任的 HTTPS 来源，然后在小程序中添加 URL。
- 2
直接使用桥接对象，或等待
rfidreaderready事件。 - 3
订阅
tag、scanStart、scanStop、disconnect与error。 - 4
调用
getState()，仅在共享读写器就绪后开始盘点。
* USB 是否可用取决于 Showcase 所在平台。命令 Promise 只表示已发送，硬件状态以事件为准。
可复制的实施说明
让页面适配 Helios Showcase。
把这份说明交给开发者或常用编程工具。它会保留现有前端，加入经过验证的桥接生命周期，并明确可模拟测试的标签数据流。
让这个现有网页应用作为小程序运行在 Helios Showcase 内，并与 AERO UHF Mark3 读写器交互。
先检查项目并保留现有框架、状态架构、样式与测试方式。阅读并遵循：
https://www.aerouhf.com/skills/aero-uhf-integration/SKILL.md
https://www.aerouhf.com/skills/aero-uhf-integration/references/web-showcase.md
使用注入的 window.RFIDReader API，不要在网页项目中加入原生 SDK。同时支持桥接对象已存在与等待 rfidreaderready 事件两种情况。调用 getState()；在盘点前订阅 ready、scanStart、scanStop、tag、disconnect 与 error；按 EPC 去重标签；清理时移除监听并停止进行中的盘点。命令 Promise 只表示已发送，硬件状态以事件为准。
为 window.RFIDReader 添加开发用模拟器，并针对未连接、标签突发、重复 EPC、错误与清理编写测试。不要加入标签写入、永久设置、重置、重启或 OTA。报告通过的检查，以及仍需 Helios Showcase 和实体读写器验证的项目。
直接启动
用一条深层链接打开小程序。
rfidreader://miniprogram?id=my.inventory&name=Inventory&url=https%3A%2F%2Fexample.com%2Frfid
官方 SDK 路径
沿用产品已经信任的平台。
集成说明会对应每条经过验证的分发路径，并在修改依赖前检查访问权限，绝不会把私有或不可用的软件包当作公开依赖。
Apple
适用于 iPhone、iPad 与 Mac 的 Swift Package 和 XCFramework，最低支持 iOS 13 与 macOS 13。
打开 Apple 文档 →Android
Kotlin SDK，可通过 JitPack 或手动 AAR 分发，最低支持 Android 8.0 / API 26。
打开 Android 文档 →Flutter
Flutter 分发仓库目前为私有。Skill 会在更改依赖前验证访问权限，并在无法访问时明确停止。
申请 Flutter 访问 →
统一生命周期
应用跟随读写器状态，而不是按钮点击。
Helios 命令是异步的。连接、就绪、扫描、标签与错误通过委托回调到达，并成为应用状态的唯一依据。
平台发现逻辑独立管理。
请求权限、发现设备，并在连接前停止扫描。
保留一个读写器与委托。
在完整应用生命周期中持有二者，并等待就绪回调。
让回调驱动状态。
开始盘点、接收标签元数据并停止，不猜测命令是否完成。