iOS 符号表

符号表是内存地址与函数名、文件名、行号的映射表。符号表元素如下所示：

[]

为了能快速并准确地定位用户APP发生Crash的代码位置，Bugly使用符号表对APP发生Crash的程序堆栈进行解析和还原。

举一个例子：

iOS平台中，dSYM文件是指具有调试信息的目标文件，文件名通常为：xxx.app.dSYM。如下图所示：

为了方便找回Crash对应的dSYM文件和还原堆栈，建议每次构建或者发布APP版本的时候，备份好dSYM文件。

一般情况下，项目编译完dSYM文件跟app文件在同一个目录下，下面以XCode作为IDE详细说明定位dSYM文件。

-> 进入XCode；

-> 打开工程（已编译过）；

-> 在左栏找到“Product”项；

-> 鼠标右键点击编译生成的“xxx.app”；

-> 点击“Show in Finder”；

如下图所示：

如果有多个dSYM文件，可以在使用工具时指定输入为dSYM文件所在的目录或者工程目录。

XCode Release编译默认会生成dSYM文件，而Debug编译默认不会生成，对应的Xcode配置如下：

XCode -> Build Settings -> Code Generation -> Generate Debug Symbols -> Yes

XCode -> Build Settings -> Build Option -> Debug Information Format -> DWARF with dSYM File

在配置符号表文件之前，需要从App Store中把该版本对应的dSYM文件下载回本地（参考“如何找回已发布到App Store的App对应的dSYM文件？”），然后用符号表工具生成和上传符号表文件。

不需要配置自动生成符号表的脚本了，也不要用本地生成的dSYM文件来生成符号表文件，因为本地编译生成的dSYM文件的符号表信息都被隐藏了。如果用本地编译生成的dSYM文件生成符号表文件并配置到Bugly平台之后，还原出来的结果将是类似于“__hiden#XXX”这样的符号。

Bugly还原Crash堆栈时，需要根据UUID来匹配符号表文件，因此只有上传的符号表文件的UUID与Crash对应APP的UUID一致时，才能准确地对堆栈进行还原。

查看符号表文件的UUID（“如何查看dSYM文件的UUID？”）

查看Crash对应的APP的UUID

Bugly v1.0页面

崩溃 ---> Crash issue ---> dSYM UUID

Bugly v2.0页面

崩溃分析 ---> Crash issue ---> 符号表 ---> UUID

符号表文件的UUID与dSYM文件的UUID是一致的，因此可以通过符号表工具生成的符号表文件来查看dSYM文件的UUID：

生成符号表文件(.zip) ---> 解压符号表文件(.symbol) ---> 使用文本编辑器打开符号表文件

其中符号表文件的“UUID”信息即Debug SO文件的UUID，亦是符号表文件的UUID，如果文件较大，建议使用“Sublime Text”等文本编辑器来打开符号表文件。

打开 Xcode 顶部菜单栏 -> Window -> Organizer 窗口：

打开 Xcode 顶部菜单栏，选择 Archive 标签：

找到发布的归档包，右键点击对应归档包，选择Show in Finder操作：

右键选择定位到的归档文件，选择显示包内容操作：

选择dSYMs目录，目录内即为下载到的 dSYM 文件：

登录iTunes Connect；

进入“我的App（My Apps）”的“活动（Activity）”页面：

在“所有构件版本（All Builds）”中选择某一个版本，点“下载dSYM（Download dSYM）”下载dSYM文件：

在Bugly的issue页面查询到crash对应的UUID：

然后在Mac的Shell中，用mdfind命令定位dSYM文件：

注意，使用mdfind时，UUID需要格式转换（增加“-”）： 12345678-1234-1234-1234-xxxxxxxxxxxx

例如，要定位的dSYM的UUID为：E30FC309DF7B3C9F8AC57F0F6047D65F 则定位dSYM文件的命令如下：

建议每次构建或者发布APP版本的时候，备份App对应的dSYM文件！

目前只支持通过符号表工具上传，请下载符号表工具上传（内附详细使用说明文档），下载链接：https://bugly.qq.com/v2/downloads