Crash
文件获取
- 大致可以分为两种方式:远程获取和本地获取;具体可以分为如下四种途径
1.1. 远程获取;已经上传到iTunes Connect
的应用,可以通过iTunes Connect
的App分析
查看App
崩溃情况不会有崩溃日志
,如果是TestFlight
测试,则可以在iTunes Connect
获取到崩溃日志
1.2. 远程获取;通过Xcode
菜单Window -> Organizer -> Crashes
获取用户的崩溃日志
- 注意:以上两种途径都需要登录开发者账号,并且需要用户共享
iPhone
分析,才能够获取到用户的崩溃日志 - 注意:官方提供的崩溃信息并不是实时的,只能查看两天之前的崩溃信息,需要实时的可以使用第三方工具
1.3. 本地获取;在手机上设置 -> 隐私 -> 分析与改进 -> 分析数据
中,根据应用名称和日期时间找到你需要的日志,点击进去后,右上角会有个分享按钮,分享给Mac
1.4. 把手机连接到Mac
,通过Xcode
菜单Window -> Devices and Simulators -> Devices -> View Device Logs
获取用户的崩溃日志
- 注意某些
iOS
系统会没有上面提到的分享按钮,这时候可以全选复制,再发送给Mac
Crash
文件符号化
- 大致也是分为两种方式:使用
Xcode
自动符号化和通过手动命令行工具symbolicatecrash
符号化;这两种方式原理一样,都需要dSYM
文件,只不过前者是Xcode
自动帮我们完成的 - 注意:如果你们的应用是通过
Xcode
上传iTunes Connect
的,并同时上传了.xcarchive
文件(实际上是一个文件夹,包含.ipa和.dSYM文件)
,Xcode
会默认帮你勾选该选项,那么从iTunes Connect
获取到的日志就已经是符号化过的了
2.1. 使用Xcode
自动符号化Crash
文件,Xcode
自带的工具非常好用
- 如果你用的
Mac
就是打包的机子,并且得到了发生崩溃的手机,那么手机连接电脑,通过Xcode
菜单Window -> Devices and Simulators -> Devices -> View Device Logs
找到自己的日志,就是符号化过后的,如果没有符号化,就稍微等待一会儿,或者右击点出菜单选择Re-Symbolicate Log
- 如果只有
Mac
出包机,没有手机只有崩溃日志,那么同样可以通过Xcode
菜单Window -> Devices and Simulators -> Devices -> View Device Logs
把崩溃日志直接拖进去,就是符号化过后的,如果没有符号化,就稍微等待一会儿,或者右击点出菜单选择Re-Symbolicate Log
- 注意:在有些版本的
Xcode
是拖不进去的,遇到这种情况可以用下面的手动符号化方式 - 注意:上面的方法不一定要是出包机,本质是只要你的电脑上有
dSYM
文件,Xcode
就能自动找到他并为你符号化
2.2. 通过终端命令行工具symbolicatecrash
符号化
大概需要如下三个文件,下面是获取这些文件的方法
- 通过菜单
Xcode -> Window -> Organizer -> Archiver
找到打包的项目,右键Show In Finder
,找到AppName.xcarchive
,右键显示包内容,找到AppName.app.dSYM
- 在桌面创建一个文件夹
tmp
,将以上两个文件拷贝到tmp
文件夹中 - 打开终端,用
find /Applications/Xcode.app -name symbolicatecrash -type f
查找symbolicatecrash
,其中/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash
路径是需要的symbolicatecrash
文件,将symbolicatecrash
文件也拷贝到tmp
文件夹中 - 将需要分析的
crash
文件也拷贝到tmp
文件夹中,crash
文件的格式可能是.beta
、.crash
或.ips
- 在终端中使用以下命令行,
crash
文件格式以.crash
为例1
2
3
4
5
6# 进入到 tmp 文件夹中
cd ~/Desktop/tmp
# 分析 crash 文件,会在 `tmp` 文件夹中生成 crash.log 文件
./symbolicatecrash ./xxx.crash ./AppName.app.dSYM > crash.log
或./symbolicatecrash ./xxx.crash ./.app.dSYM > crash.log - 如果终端报类似这样的错
zsh: permission denied: ./symbolicatecrash
说明是symbolicatecrash
文件有问题,可能该文件不是本机获取的,或者是之前获取的、Xcode
升级等问题造成的,重新在本机上按上面方法获取即可 - 如果终端报类似这样的错
Error: "DEVELOPER_DIR" is not defined at ./symbolicatecrash line 69.
尝试以下命令后,再重复上面命令,正常情况就可以分析bug了export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
- 符号化之前,首先得确保
Crash
文件和dSYM
这两个文件里面的UUID
是一致的,如果不一致,就说明不是本次Crash
对应的文件,就不能进行符号化;查看dSYM
文件里面的UUID
命令:dwarfdump --uuid AppName.app.dSYM
;查看Crash
文件文件的UUID
就比较简单了,直接打开,Crash
最上面的就是各种信息,不同系统版本给的格式可能会有不同,下图内容为参考
Xcode
在Debug
模式下默认关闭生成dSYM
文件,Release
模式下默认生成dSYM
文件的, 要生成dSYM
文件需要查看一下项目的Build Settigns -> Build Options -> Debug information Format
属性;只有该属性设置为DWARF with dSYM File
时,编译才会生成dSYM
文件- 该文是在
Xcode 11.2
和iOS 13.2
上写的教程,不同的系统版本的Xcode
和手机系统获取路径和符号化方式会有变化