uni-app 本身不原生支持支付宝 IoT 设备固件级开发，需通过编译为支付宝小程序后，适配 IoT 容器并调用 ant.iot. 原生 API 实现设备交互，所有硬件操作不可使用 uni. 接口。
直接说结论：uni-app 本身不原生支持支付宝 IoT 设备（如蜻蜓 F4、商米蜻蜓）的固件级开发，但可通过「支付宝小程序 + uni-app 编译」路径实现上层应用逻辑，设备端需另配蚂蚁 IoT-SDK 或 ABCP-SDK。
支付宝 IoT 设备 ≠ 普通支付宝小程序
支付宝 IoT 设备（比如蜻蜓系列）运行的是定制化轻量 OS，不是标准 Android 或小程序容器。它不加载 webview，也不执行 uni-app 编译出的 JS bundle。你看到的“uni-app 支持支付宝 IoT”其实是 IDE 层的误导——2019 年支付宝 IDE 0.70 版本所谓“内置 uni-app 支持”，仅指能用 uni-app 语法生成普通支付宝小程序代码，再手动适配到 IoT 设备的前端容器中，而非直连设备固件。
真实链路是：uni-app → 编译为支付宝小程序 → 支付宝 IoT 小程序容器（需厂商预装或 OTA 推送）→ 调用设备侧 ant.iot.* 原生 API（非 uni.*）。
- 支付宝 IoT 设备前端必须使用
ant对象调用硬件能力，例如ant.iot.bluetooth.connect()、ant.iot.device.report() -
uni.getConnectedBluetoothDevices()在 IoT 设备上会直接报错或静默失败，因为底层没桥接 - 设备 SN、OTA 版本、摄像头型号等强绑定信息，必须通过
ant.iot.device.getInfo()获取，不能靠uni.getSystemInfoSync()
怎么让 uni-app 项目跑在支付宝 IoT 设备上
关键不是“开发”，而是“适配+封装”。你需要把 uni-app 当作 UI/业务逻辑层，所有设备交互必须走支付宝 IoT 提供的 JS SDK。
- 在
manifest.json中将name和appid替换为支付宝 IoT 平台分配的真实产品 ID，不是普通小程序的 AppID - 删掉所有
uni.request直连 HTTP 的写法，改用ant.iot.http.request()（需先在 IoT 开放平台开通 HTTP 通道权限） - 蓝牙、Wi-Fi、串口等外设操作，全部替换为
ant.iot.bluetooth.*系列方法，并在onLoad里主动调用ant.iot.permission.request({ permissions: ['bluetooth'] }) - 页面路由不能依赖
uni.navigateTo，IoT 设备只支持单页模式或预定义 tab 配置，跳转需走ant.iot.page.navigate()
示例：上报设备状态
ant.iot.device.report({
data: {
temperature: 25.3,
humidity: 62
},
success: () => console.log('上报成功'),
fail: (err) => console.error('上报失败', err)
});
真机调试时最常踩的三个坑
支付宝 IoT 设备调试不像手机 App 那样连 USB 就能看 log，整个流程更接近嵌入式开发。
- 设备必须已通过 IoT 开放平台「添加调试设备」并录入 SN，否则
ant.iot.*全部返回permission denied - 调试包不是直接 HBuilderX 发行，而是要用支付宝 IoT 开放平台的「OTA 分发」功能上传，再在设备端手动触发「检查更新」
-
console.log不会输出到 IDE 控制台，得用ant.iot.log.debug()，且日志只存本地，需通过ant.iot.log.upload()主动上传到平台查看
另外注意：支付宝 IoT 设备默认关闭开发者模式，首次调试前必须在设备设置里打开「开发者选项」并启用「USB 调试」——但这只是用于 ADB shell，对 uni-app JS 无用，别浪费时间连 adb logcat。
真正卡住人的地方，从来不是语法或编译，而是设备侧 SDK 权限模型和 uni-app 运行时模型的错位。一个 ant.iot.device.report() 调用失败，可能是因为平台没开数据通道、设备没绑产品、SN 录错了、OTA 包版本不匹配，或者上报频率超限——这些错误都不会抛出 JS 异常，只会静默丢弃。
