Skip to content

抓取 iOS 日志(排查 HomeKit) ​

无法配对、配对失败、配件异常、摄像头视频流转圈等,除了看 Olink 侧日志 / 输入抓取外,用 Mac 抓 iPhone 系统日志(聚焦 homed)往往能更快定位。把完整 ios.log 发给开发者即可继续查。

Olink 主机侧日志不够细时,先按 如何开启 Debug 日志 把 log4rs.yaml 的 root.level 改为 debug。

适用场景 ​

下列情况都建议抓一份 iOS 日志:

  • 无法配对 / 配对失败 / 一直卡在「连接中」
  • 配件异常、无响应、反复掉线
  • 「家庭」里摄像头打开后视频流转圈、黑屏、无法出画

可与 配对卡在连接中、配对后一直转圈 等步骤一起做。

准备 ​

  1. 一台 Mac。
  2. 安装 libimobiledevice 工具集(内含 idevicesyslog)。常用安装方式:
bash
brew install libimobiledevice
  1. 用数据线把 iPhone / iPad 连上 Mac(见下一节)。

安装后可先确认工具存在:

bash
which idevicesyslog

用数据线连接手机 ​

idevicesyslog 走 USB 有线 读系统日志,请按下面连接:

  1. 使用能传数据的 USB 数据线(Lightning / USB-C,视机型而定)把手机接到 Mac。
    • 不要用「只能充电、不能传数据」的线;
    • 无线 / 隔空投送 不能替代本步骤。
  2. 手机解锁,若弹出 「要信任此电脑吗?」,点 信任,并输入锁屏密码。
  3. 在 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 主机日志或摄像头 输入抓取 样本,一并附上更好。

注意 ​

  1. 必须用数据线连接;仅充电线或未信任电脑时,idevice_id / idevicesyslog 都会失败。
  2. 抓取期间手机尽量不要锁屏过久;保持「家庭」相关操作可完成。
  3. 未加 -p homed 时日志会极大,排查 HomeKit 时建议始终加进程过滤。
  4. 多台 iOS 设备用线连着 Mac 时,可用 idevicesyslog -u <UDID> -p homed >> ios.log 指定设备(UDID 见 idevice_id -l)。
  5. 日志可能含家庭名称、配件名等本地信息,发送前自行确认是否可接受。

相关文档 ​