第一步:下载并安装 WiFi 调试 Profile (描述文件)
默认情况下,iOS/iPadOS 的日志级别不足以分析复杂的连接问题,需要安装苹果官方的调试配置文件。
- 下载 Profile:
-
在 MacBook 或 iPad 上访问 Apple Developer Profiles and Logs (developer.apple.com/bug-reporti…) 页面(需要登录 Apple ID)。
-
找到 "Wi-Fi" 相关的 Profile (通常名为 Wi-Fi for iOS/iPadOS) 并下载。
- 安装 Profile:
-
如果是在 Mac 上下载的,通过 AirDrop或者OPPO互联 发送到 iPad/iPhone 。
-
在 iPad/iPhone 上, 找到描述文件,点击文件,会提示已下载的描述文件。
-
然后进入设置界面,找到 "已下载描述文件"这项,点击后输入锁屏密码安装。
- 注意:此 Profile 通常有效期为数天(如 7 天),过期后会自动失效, 失效后需要重新从开发者网站上下载。
第二步:复现问题 & 触发 Sysdiagnose
- 复现问题:
- 在 iPhone/iPad上尝试复现问题,记下问题发生的准确时间点(精确到分钟)
- 打包log (Pack Log):
- iPhone/iPad进入设置-无线局域网, 点击"诊断信息", 评论处输入复现问题的时间点, 然后点击"保存日志"
然后等待, 系统会在后台收集日志,这通常需要3~5分钟。log收集完成后会弹框。
- 触发抓取 (Sysdiagnose):
在iOS设备上,同时按下“Volume Up”、“Volume Down”和“Power”按钮约2秒。系统诊断启动时,会出现小振动(仅iPhone有);长按时,可能会进入关机界面,在关机界面继续保持1~2秒即可松开
此时进入到设置 > 隐私 > 分析和改进界面, 找下有没有Sysdiagnose开头的文件,有就是已经完成log打包。
可以参考思科的文档
第三步:导出日志至 MacBook
-
物理连接: 使用 USB 数据线将 iPad 连接到 MacBook。
-
Mac 端同步:
-
打开 Finder。
-
在左侧边栏“位置”下点击你的 iPad 名称。
-
在右侧的主界面中,点击 “同步” (Sync) 按钮。此时,Mac 会将设备上的诊断日志拉取到电脑本地。
- 日志在 MacBook 上的存放路径
同步完成后,WiFi Log 不会自动弹出来,你需要手动前往以下隐藏路径查找:
路径:
~/Library/Logs/CrashReporter/MobileDevice/[iOS设备名]/DiagnosticLogs/sysdiagnose
如何快速进入该文件夹:
-
在 MacBook 上打开 Finder。
-
按下快捷键 Command + Shift + G(或在菜单栏选择“前往” > “前往文件夹”)。
-
输入上述路径(将 [你的设备名称] 替换为实际名称,或直接输入 ~/Library/Logs/CrashReporter/MobileDevice/ 后逐级查找)。
提供对应的文件(夹)。