抓取 iOS 日志(排查 HomeKit)
无法配对、配对失败、配件异常、摄像头视频流转圈等,除了看 Olink 侧日志 / 输入抓取外,用 Mac 抓 iPhone 系统日志(聚焦 homed)往往能更快定位。把完整 ios.log 发给开发者即可继续查。
Olink 主机侧日志不够细时,先按 如何开启 Debug 日志 把 log4rs.yaml 的 root.level 改为 debug。
适用场景
下列情况都建议抓一份 iOS 日志:
- 无法配对 / 配对失败 / 一直卡在「连接中」
- 配件异常、无响应、反复掉线
- 「家庭」里摄像头打开后视频流转圈、黑屏、无法出画
准备
- 一台 Mac。
- 安装 libimobiledevice 工具集(内含
idevicesyslog)。常用安装方式:
bash
brew install libimobiledevice- 用数据线把 iPhone / iPad 连上 Mac(见下一节)。
安装后可先确认工具存在:
bash
which idevicesyslog用数据线连接手机
idevicesyslog 走 USB 有线 读系统日志,请按下面连接:
- 使用能传数据的 USB 数据线(Lightning / USB-C,视机型而定)把手机接到 Mac。
- 不要用「只能充电、不能传数据」的线;
- 无线 / 隔空投送 不能替代本步骤。
- 手机解锁,若弹出 「要信任此电脑吗?」,点 信任,并输入锁屏密码。
- 在 Mac 上确认已识别到设备:
bash
idevice_id -l应打印出一串 UDID。若没有输出:换线、换口、重新拔插,或再点一次「信任此电脑」。
连接成功后再执行下面的抓取命令;抓取过程中保持数据线插着,不要中途拔掉。
抓取命令
数据线已连上且 idevice_id -l 有输出后,在 Mac 终端执行(日志追加写入当前目录的 ios.log):
bash
idevicesyslog -p homed >> ios.log说明:
-p homed:只保留与 HomeKit 守护进程homed相关的输出,文件更小、更易排查家庭 / 配件问题。>> ios.log:追加写入;需要全新文件可先删旧的,或改用> ios.log。
保持该命令一直运行(线不要拔),然后在 iPhone 上复现问题(再次配对、打开摄像头预览等)。复现结束后在终端按 Ctrl+C 结束抓取。
交给开发者时请附带
- 完整的
ios.log(从开始抓取到复现结束) - 大致操作时间点(例如「约 21:05 点了仍然添加」「约 21:06 打开摄像头」)
- 现象简述:配对失败 / 连接中 / 视频转圈等
- Olink 版本、桥接器或配件名称、手机 iOS 版本(可选)
若同时有 Olink 主机日志或摄像头 输入抓取 样本,一并附上更好。
注意
- 必须用数据线连接;仅充电线或未信任电脑时,
idevice_id/idevicesyslog都会失败。 - 抓取期间手机尽量不要锁屏过久;保持「家庭」相关操作可完成。
- 未加
-p homed时日志会极大,排查 HomeKit 时建议始终加进程过滤。 - 多台 iOS 设备用线连着 Mac 时,可用
idevicesyslog -u <UDID> -p homed >> ios.log指定设备(UDID 见idevice_id -l)。 - 日志可能含家庭名称、配件名等本地信息,发送前自行确认是否可接受。