iOS_crash文件的获取及符号化(解析)

文章目录

  • [1. 使用 symbolicatecrash 解析 .ips 文件:](#1. 使用 symbolicatecrash 解析 .ips 文件:)
  • [2. 使用 CrashSymbolicator.py 解析 ips 文件](#2. 使用 CrashSymbolicator.py 解析 ips 文件)
  • [3. 使用 atos 解析 crash 文件](#3. 使用 atos 解析 crash 文件)
  • [4. Helps](#4. Helps)
    • [4.1 .ips 文件获取](#4.1 .ips 文件获取)
    • [4.2 .crash 文件获取](#4.2 .crash 文件获取)
    • [4.3 获取 .dSYM 和 .app 文件](#4.3 获取 .dSYM 和 .app 文件)
    • [4.4 使用 dwarfdump 查询 uuid](#4.4 使用 dwarfdump 查询 uuid)
  • [5. Tips](#5. Tips)
  • [6. 总结](#6. 总结)

1. 使用 symbolicatecrash 解析 .ips 文件:

symbolicatecrash是Xcode自带的crash日志分析工具

步骤1. 找到symbolicatecrash,打开Terminal执行:

shell 复制代码
find /Applications/Xcode.app -name symbolicatecrash -type f

稍等一会,就会输出路径,然后将路径复制,右键 Finder -> 前往文件夹 -> 粘贴 -> 回车,就能找到symbolicatecrash,将symbolicatecrash拷贝出来备用

步骤2. 将./symbolicatecrash、crash和dSYM文件放在同一文件夹里

步骤3. 执行解析命令

shell 复制代码
./symbolicatecrash 《crash文件绝对路径》 《拖入xx.app.dSYM里的xx文件》 > log.crash 回车

可能会报错:

错误1:Error: "DEVELOPER_DIR" is not defined at /Users/yourname/Downloads/crash/symbolicatecrash line 69.

解决:执行export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer后重试


错误2:No crash report version in /xxx.crash at ./symbolicatecrash line 1365.

原因:Apple 在 Xcode13.3 已经废弃了symbolicatecrash

解决:如果需要使用,需要将.ips转化为之前的格式。可以使用 AppleCrashScripts 进行转化

步骤:

  1. 下载AppleCrashScripts项目,进入到项目目录下
  2. 将 .ips 文件复制到AppleCrashScripts-master文件夹下:
  3. 执行:
shell 复制代码
swift convertFromJSON.swift -i xxx.ips -o log.crash

生成的log.crash就是旧格式的文件了,再用 ./symbolicatecrash 进行解析。


2. 使用 CrashSymbolicator.py 解析 ips 文件

步骤1. 找到CrashSymbolicator.py文件,
find /Applications/Xcode.app -name CrashSymbolicator.py -type f

结果:
/Applications/Xcode.app/Contents/SharedFrameworks/CoreSymbolicationDT.framework/Versions/A/Resources/CrashSymbolicator.py

步骤2. 使用CrashSymbolicator.py和.dSYM 对.ips文件进行解析

shell 复制代码
python3 《CrashSymbolicator.p文件路径》 -d xxx.dSYM -p xxx.ips

运行结果会直接显示在terminal里,需要的可以复制出来保存一下。

步骤3. 分析

shell 复制代码
...
"queue": "com.apple.main-thread",
"frames": [
  {
    "imageOffset": 117622764,
    "imageIndex": 0,
    "symbol": "__57-[QNBUALiveFeedCategoryChannelViewController viewDidLoad]_block_invoke",
    "sourceFile": "QNBUALiveFeedCategoryChannelViewController.m",
    "sourceLine": 80,
    "symbolLocation": 32
  },
  ...
  ]
...

找到了崩溃时主线程正在执行的代码,invoke了一个空的block。


3. 使用 atos 解析 crash 文件

命令格式:

shell 复制代码
atos -arch <Binary Architecture> -o <Path to dSYM file>/Contents/Resources/DWARF/<binary image name> -l <load address> <address to symbolicate>

操作:

shell 复制代码
atos -arch arm64 -o 《拖入xxx.app.dSYM里的xxx文件》 -l 《基地址》《偏移后的地址》

Tips: xxx 为项目名

shell 复制代码
如1:
atos -arch arm64 -o ~/xxx.app.dSYM/Contents/Resources/DWARF/xxx 0x10b3e47ec 0x1043b8000

atos -arch arm64 -o ~/xxx.app.dSYM/Contents/Resources/DWARF/xxx 0x104885ec0 0x1043b8000

-[TTAttributedLabel encodeWithCoder:] (in xxx) (TTAttributedLabel.m:1534)
-[QNBUAPosterVerticalPaddingPicViewModel posterBackgroundOperation] (in xxx) (QNBUAPosterVerticalPaddingPicViewModel.m:115)

4. Helps

4.1 .ips 文件获取

  1. 设备 -> 设置 -> 隐私与安全性 -> 分析与改进 -> 分析数据 -> (对应app名+时间点)
  2. TestFlight 的可以在 iTunes Connect 获取到崩溃日志
    iTunes Connect -> Manage Your Applications -> 对应app -> View Detail -> Crash Reports (已符号化)
  3. Xcode -> Window -> Origanizer -> Crash 获取 (需登录开发者账号)
    需要用户共享分享,才能获取到他的崩溃日志
    官方提供的崩溃信息不是实时的,只能查看两天前的崩溃信息,需要试试可以使用第三方工具

4.2 .crash 文件获取

设备连接电脑 XCode -> Windows -> Device and Simulator -> View Device Logs -> (对应app名+时间点) -> 右键 Export Log

4.3 获取 .dSYM 和 .app 文件

.dSYM是十六进制函数地址映射信息的中转文件,调试的symbols会包含在这个文件中,symbols即类名、函数名等。

  1. 在Archives打包时,应该保存每个正式版的dSYM和app文件,以备定位线上问题使用

Window -> Organizer -> Archives -> 右键(需要的包) -> Show in Finder -> 右键 .xcarchive 显示包内容

Tips:Archives包文件路径为:~/Library/Developer/Xcode/Archives

  1. debug模式获取

修改设置:Xcode -> Targets -> Build Setting

2.1:Debug Infomation Format -> DWARF -> DWARF with dSYM File

2.2:Generate Debug Symbols -> YES

用真机编译就能生成.dSYM和.app文件了,在项目工程的Products文件夹里,右键 xxx.app 文件 -> Show in Finder -> 就能找到

4.4 使用 dwarfdump 查询 uuid

查询.dSYM的uuid,确保跟.ips或.crash文件的uuid一致

shell 复制代码
dwarfdump -u <dSYM所在文件路径>

5. Tips

  • Tips1: Apple deprecated symbolicatecrash at Xcode13.3, use atos instead
  • Tips2: 有些app有很多dSYM文件,需要把所有dSYM文件都拷贝到待解析文件同一文件夹下
  • Tips3: simulator不会生成crash文件
  • Tips4: XCode设置生成dSYM文件,并跑到真机上,此时app产生的.ips文件会自动符号化

6. 总结

  • CrashSymbolicator.py解析结果显示在 Terminal 里,且 没有保持原来的堆栈格式
  • atos效率好低,只能一个地址一个地址的解析
  • symbolicatecrash被废弃了,但文件进过转换还能用,且会解析一整个文件,还保留原来的堆栈格式(推荐使用)

参考:
Diagnosing issues using crash reports and device logs
Acquiring crash reports and diagnostic logs
Understanding Crashes and Crash Logs
iOS Debugging Magic
iOS Crash 分析攻略

本文的描述很难不掺杂作者的主观意见,如果对文章中的内容有疑问,欢迎评论区提出不同的意见进行讨论

相关推荐
我是谁的程序员9 小时前
iOS 性能分析在 Windows 上怎么做,用 KXBuild 的 kxdevice 替代 Instruments
后端·ios
开心就好202510 小时前
通配符 Bundle ID 和精确 Bundle ID 怎么选,推送、iCloud 能不能用通配符
后端·ios
布莱克60515 小时前
Swift 枚举详解:从基础语法到关联值与模式匹配
开发语言·ios·swift·枚举
茶底世界之下15 小时前
冬日窗边的早餐:用 Awaking 留住冷光里的暖意
ios·app·产品
布莱克60515 小时前
Swift 闭包详解:从语法到实战的完整指南
服务器·开发语言·ios·ssh·swift·闭包
茶底世界之下2 天前
雨后的黄电车:用 Awaking 给灰色街景定一个主角
ios·app·产品
恋猫de小郭2 天前
iOS for Web ,把原生 iOS App 跑到进浏览器里面,倒反天罡
android·前端·ios
wuxianda10302 天前
Swift 项目用 Xcode 脚手架起步:默认工程结构和依赖组合为什么会被识别成同源
开发语言·xcode·swift·4.3a·appstore审核
00后程序员2 天前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
iReaShare2 天前
如何在没有 Wi-Fi 的情况下备份 iPhone
ios