分析iOS Crash文件:符号化iOS Crash文件的3种方法

当你的应用提交到AppStore或者各个渠道之后,请问你多久会拿到crash文件?你如何分析crash文件的呢?


上传crash文件

你的应用应当有模块能够在应用程序crash的时候上传crash信息。 要么通过用户反馈拿到crash文件,要么借助自己或第3方的crash上传模块拿到crash文件。

今天要分析的场景是你拿到用户的.crash文件之后,如何符合化crash文件(Symbolicating crash logs)的3种方法。帮助尽快找到crash原因。


crash文件例子

crash文件的部分内容:

Last Exception Backtrace:

  • 0 CoreFoundation 0x30acaf46 exceptionPreprocess + 126

  • 1 libobjc.A.dylib 0x3af0b6aa objc_exception_throw + 34

  • 2 CoreFoundation 0x30a0152e -[__NSArrayM objectAtIndex:] + 226

  • 3 appName 0x000f462a 0x4000 + 984618

  • 4 appName 0x00352aee 0x4000 + 3468014

  • 18 appName 0x00009404 0x4000 + 21508

大家一眼就能看到:

  • 2 CoreFoundation 0x30a0152e -[__NSArrayM objectAtIndex:] + 226

这一行有问题。

但是,第3行和第4行的:

  • 3 appName 0x000f462a 0x4000 + 984618

  • 4 appName 0x00352aee 0x4000 + 3468014

并没有指出到底是app的那个模块导致的问题,如何排查呢?


有如下3种方法


方法1 使用XCode

这种方法可能是最容易的方法了。

要使用Xcode符号化 crash log,你需要下面所列的3个文件:

  • crash报告(.crash文件)
  • 符号文件 (.dsymb文件)
  • 应用程序文件 (appName.app文件,把IPA文件后缀改为zip,然后解压,Payload目录下的appName.app文件), 这里的appName是你的应用程序的名称

把这3个文件放到同一个目录下,打开Xcode的Window菜单下的organizer,然后点击Devices tab,然后选中左边的Device Logs。

然后把.crash文件拖到Device Logs或者选择下面的import导入.crash文件。

这样你就可以看到crash的详细log了。 如下图:


方法2 使用命令行工具symbolicatecrash

有时候Xcode不能够很好的符号化crash文件。我们这里介绍如何通过symbolicatecrash来手动符号化crash log。

在处理之前,请依然将“.app“, “.dSYM”和 ".crash"文件放到同一个目录下。现在打开终端(Terminal)然后输入如下的命令:

export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer

然后输入命令:

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKitBase.framework/Versions/A/Resources/symbolicatecrash appName.crash appName.app > appName.log

现在,符号化的crash log就保存在appName.log中了。


方法3 使用命令行工具atos

如果你有多个“.ipa”文件,多个".dSYMB"文件,你并不太确定到底“dSYMB”文件对应哪个".ipa"文件,那么,这个方法就非常适合你。

特别当你的应用发布到多个渠道的时候,你需要对不同渠道的crash文件,写一个自动化的分析脚本的时候,这个方法就极其有用。

这里先介绍一个概念:UUID

什么是UUID

每一个可执行程序都有一个build UUID来唯一标识。Crash日志包含发生crash的这个应用(app)的 build UUID以及crash发生的时候,应用加载的所有库文件的[build UUID]。

那如何知道crash文件的UUID呢?

可以用:

grep "appName armv" *crash

或者

grep --after-context=2 "Binary Images:" *crash

可以得到类似如下的结果:

appName.crash-0x4000 - 0x9e7fff appName armv7 <8bdeaf1a0b233ac199728c2a0ebb4165> /var/mobile/Applications/A0F8AB29-35D1-4E6E-84E2-954DE7D21CA1/appName.crash.app/appName

(请注意这里的0x4000,是模块的加载地址,后面用atos的时候会用到)

如何找到app的UUID

可以使用命令:xcrun dwarfdump -–uuid <AppName.app/ExecutableName>

比如:

xcrun dwarfdump --uuid appName.app/appName

结果如下:

UUID: 8BDEAF1A-0B23-3AC1-9972-8C2A0EBB4165 (armv7) appName.app/appName

UUID: 5EA16BAC-BB52-3519-B218-342455A52E11 (armv7s) appName.app/appName

这个app有2个UUID,表明它是一个fat binnary。

它能利用最新硬件的特性,又能兼容老版本的设备。

对比上面crash文件和app文件的UUID,发现它们是匹配的

8BDEAF1A-0B23-3AC1-9972-8C2A0EBB4165

用atos命令来符号化某个特定模块加载地址

命令是:

atos [-o AppName.app/AppName] [-l loadAddress] [-arch architecture]

亲测:下面3种都可以:

  • xcrun atos -o appName.app.dSYM/Contents/Resources/DWARF/appName -l 0x4000 -arch armv7

  • xcrun atos -o appName.app.dSYM/Contents/Resources/DWARF/appName -arch armv7

  • xcrun atos -o appName.app/appName -arch armv7

(这3行选任意一行执行都可以达到目的,其中0x4000是模块的加载地址,从上面的章节可以找到如何得到这个地址。)

文章开头提到crash文件中有如下两行,

* 3 appName 0x000f462a 0x4000 + 984618 
* 4 appName **0x00352aee** 0x4000 + 3468014  

在执行了上面的

xcrun atos -o appName.app.dSYM/Contents/Resources/DWARF/appName -l 0x4000 -arch armv7

之后,输入如下地址:

0x00352aee

(crash文件中的第4行:4 appName **0x00352aee** 0x4000 + 3468014

可以得到结果:

-[UIScrollView(UITouch) touchesEnded:withEvent:] (in appName) (UIScrollView+UITouch.h:26)

这样就找到了应用种到底是哪个模块导致的crash问题。


总结

本文分析了拿到用户的.crash文件之后,如何符合化crash文件的3种方法,分别有其适用场景,方法3适用于自动化crash文件的分析。


参见:

[1] :How to Match a Crash Report to a Build

[2] :Understanding and Analyzing iOS Application Crash Reports

[3] :Fixing Bugs: Using OS X crash logs and atos to symbolicate and find line numbers

[4] :Symbolicating Crash Logs

[5] :Symbolicating iPhone App Crash Reports


关于我

大家好,我是@吴发伟Ted,我会在博客上分享自己学习的一些东西。

好文推荐 && iOS Wiki

好文推荐(news.ios-wiki.com)iOS Wiki(www.ios-wiki.com)是我利用业余时间建立的网站。

欢迎使用Feedly等工具订阅好文推荐RSS Feed

微信公众账号

微信公众账号:iOS技术分享

Ted /
Published under (CC) BY-NC-SA in categories ios  tagged with iOS 

comments powered by Disqus