内测阶段最容易出现「我这边好好的,用户那边连不上」的场景,外设类尤其典型。手机型号、系统版本、外设固件、应用权限,任何一环不同,表现就完全不一样。这类问题靠猜没有意义,靠清单才有。
为什么这类问题在你的机器上复现不了
- 你的测试机早就配对过这台外设,系统层第一步被跳过了
- 你的账号带调试权限,用户装的是普通分发包
- 你连着公司 Wi-Fi,而投屏端和车机在另一个网段
- 外设固件版本不同,同一套协议的行为会变
第一步:先分清卡在哪一环
外设问题看着复杂,其实只会在四个环节出岔子,按顺序排掉就行。
- 权限环节:应用是否已拿到蓝牙、本地网络、相册等系统授权
- 配对环节:系统设置里能不能搜到并连上这台设备
- 发现环节:应用内的设备列表能不能刷出目标设备
- 交互环节:连上之后数据能否正常收发
判断方法很简单:让用户截一张系统设置里的蓝牙列表。系统层都连不上,问题就不在应用里。
三类外设各自的检查重点
蓝牙音频与穿戴设备
- 核对
AndroidManifest.xml里的蓝牙权限声明,安卓 12 之后扫描与连接已拆成两组权限 - 核对
Info.plist中的蓝牙用途说明,缺失时系统会直接拒绝授权 - 确认设备没被其他手机占用,多数外设同一时间只接受一个连接
- 确认是否需要先升级固件才能被应用识别
投屏与多屏
- 确认手机与接收端在同一局域网,不少投屏走的是本地发现而非云端
- 确认路由器没开 AP 隔离,开启后同网段设备互相看不见
- 对比应用在前台与切到后台时的投屏状态是否一致
车机与车载
- 确认连接方式:有线走 USB 通道,无线走蓝牙加 Wi-Fi 组合
- 确认车机侧是否需要单独授权该应用
- 确认应用被系统清后台后,连接是否会静默断开
让测试用户一次把信息给全
外设问题来回沟通成本很高,第一轮问清楚能省掉后面三轮。
- 手机型号与系统版本,设置里截图即可
- 外设品牌、型号与固件版本
- 应用版本号,例如
1.4.3 - 系统设置中的蓝牙列表截图
- 一段完整操作过程的录屏
建议 把上面五项做成固定反馈模板,放进内测群的置顶消息;同时在应用内加一个「复制设备信息」入口,用户点一下就带上机型与版本,比手打准确得多。
常见问题
| 问题 | 说明 |
|---|---|
| 用户说连不上,我这边却正常 | 先比对机型、系统版本、外设固件三项,差异多半在这里 |
| 应用内搜不到设备 | 先看系统蓝牙列表,能连说明是扫描逻辑,不能连说明是权限 |
| 连上后频繁断开 | 查后台保活与省电策略,部分系统会限制后台扫描 |
| 换一台手机就好了 | 把这台机型的系统版本记下来,作为兼容性样本 |
写在最后
外设类问题不必一上来就怀疑代码。按权限、配对、发现、交互四层走一遍,多数情况能在系统层定位。把每次的机型与外设组合记录下来,下次同类反馈能直接对上号。
分发环节也建议一起规范:把每个版本的安装入口固定到一个码上,用户报问题时能立刻确认装的是哪个版本。这种双端合并的分发方式在 https://xiafenfa.com 上可以直接配置,省去在群里反复核对安装包的时间。