第五章 常见问题
按“现象 → 先查什么”排列。多数问题不是页面坏了,而是字段或连接没对上。
以下以蓝牙项目为例;物联/WiFi 的字段规则相同,协议问题看各自文档。
页面相关
拖不进画布 / 保存后看不到
- 确认点的是「保存」,不是只改了设置
- 刷新一次页面再打开
- 组件可能被别的组件盖住了,试着拖动或调整层级
手机上打开是空白
- 确认手机连的是这个项目的设备
- 确认项目类型选对了(蓝牙项目不要用 WiFi/物联项目)
- 页面很大时先只放一个组件试
操作没反应
点开关,设备不动
- 设备和手机连上了吗?没连上,页面操作发不出去
- 字段名和固件里写的是否完全一致(大小写也算)
- 固件里有没有处理这个字段(很多问题出在“没写分支”)
- 这个字段的方向是不是“页面 → 设备”
拖滑块,设备只动一下或不动
- 滑块可能配置成“抬手才发送”,拖动过程中不发
- 也可能是固件只在特定范围处理,检查量程
数据不上来
先加一个“接收框”确认链路
比逐个组件排查更快:
- 从左侧拖一个接收框(
ReceiverFragment)到页面 - 让设备发一条固定内容,例如
temp:26.5 - 看接收框里有没有这条消息
判断:
| 接收框 | 说明 |
|---|---|
| 有消息 | 连接、鉴权、解析都正常,问题在具体组件的字段/方向 |
| 没消息 | 设备没发、字段名不同、协议模式不对,或根本没连上 |
注意:接收框显示的是设备发来的原始通知(包括鉴权握手阶段的帧)和页面发出的内容,不是解析后的业务字段,也不是串口日志。所以“接收框完全没反应”通常意味着设备根本没发通知,或连接没建立。
温度、电量不显示
- 字段名是否一致
- 设备有没有真的发(看设备日志)
- 页面是文本项目还是二进制项目,设备发的方式要一致
- 数值超出范围时页面会贴边显示,看起来像“不动”
图表不画线
- 图表用的是图表的 key,不是组件字段名
- 时间戳要毫秒,且要递增
- 第一次发
N,后面发A - 只发一个点看不出线,至少两个点
倒计时不走
- 开始要发
start_600000这种带毫秒的格式 - 只发
start不会启动 - 时间单位是毫秒,不是秒(10 分钟 = 600000)
- 设备跑完要回
finished_ok,页面才写“已完成”
两个组件一起动
大概率是字段重复:复制组件时把字段名也复制了。
解决:选中其中一个,把字段名改成别的(比如 switch2)。
改了字段名之后设备失效
字段名是暗号,改了暗号设备就不认识。两种做法:
- 把固件里的字段名一起改掉
- 或者把页面字段名改回去
改完记得重新烧录或重新生成固件。
还是不行
按顺序提供这三样,基本能定位:
- 页面截图(能看到字段名)
- 设备开机日志(前 10 行)
- 你发的是什么、期望发生什么
如果怀疑是连接问题,看《常见问题》蓝牙篇:搜不到设备、搜到连不上、广播内容对不对。
