如何将PLCrashReporter崩溃报告导入Xcode以获取崩溃行号

前提准备 #

确保你拥有与崩溃App完全对应版本的两个关键文件：

• 编译生成的.dSYM符号文件
• 发布/归档的.app安装包文件

步骤1：将PLCrashReporter日志转为Xcode兼容格式 #

PLCrashReporter默认生成.plcrash格式日志，需要转为标准.crash格式：

• 命令行方式（使用PLCrashReporter自带的plcrashutil工具）：

plcrashutil convert --format=iphone /path/to/your/report.plcrash > output.crash

• GUI方式：打开PLCrashReporter的CrashReporter.app，导入.plcrash文件后，选择导出为.crash格式。

步骤2：统一存放文件 #

将转换后的output.crash、.dSYM文件、.app文件放在同一个文件夹下，方便Xcode自动匹配符号。

步骤3：导入Xcode分析 #

1. 打开Xcode，点击顶部菜单 Window → Organizer
2. 切换到Crashes标签页
3. 点击左下角的Import按钮，选择刚才生成的output.crash文件

步骤4：触发符号化（若未自动执行） #

如果导入后日志仍未显示行号：

• 右键点击崩溃条目，选择Re-Symbolicate Crash
• 等待Xcode完成符号匹配，之后就能看到类似苹果官方报告的可读格式，包含类名、方法名及具体行号。

关键注意事项 #

• UUID匹配检查：确保.app和.dSYM的UUID完全一致，可通过以下命令验证：

  # 检查.app的UUID
  dwarfdump --uuid /path/to/your/AppName.app/AppName
  # 检查.dSYM的UUID
  dwarfdump --uuid /path/to/your/AppName.app.dSYM
  

• Xcode版本兼容：尽量使用编译该App的Xcode版本处理日志，避免Swift编译器版本差异导致符号化失败。
• 归档保存dSYM：发布App时务必归档保存对应版本的dSYM文件，丢失后无法完成完整符号化。

内容的提问来源于stack exchange，提问作者Sajid Zeb