一：介绍
1、什么是符号表？
符号表是内存地址与函数名、文件名、行号的映射表。
符号表元素如下所示：
<起始地址> <结束地址> <函数> [<文件名:行号>]
2、为什么要配置符号表？
为了能快速并准确地定位用户APP发生Crash的代码位置，Bugly使用符号表对APP发生Crash的程序堆栈进行解析和还原。
举一个例子：
Bugly提供了自动和手动两种方法配置iOS符号表。
二、自动配置：XCode + sh脚本(推荐)
1、自动配置请首先下载和解压自动配置符号表工具包，然后选择上传方式并配置Xcode的编译执行脚本。
2、直接上传dSYM文件（默认方式 ）
配置Xcode编译执行脚本
-
在Xcode工程对应Target的Build Phases中新增Run Scrpit Phase
4003.jpg
打开工具包中的dSYM_upload.sh，复制所有内容，在新增的Run Scrpit Phase中粘贴
修改新增的Run Scrpit中的 内容：
<YOUR_APP_ID> 为您的App ID
<YOUR_APP_KEY>为您的App Key
<YOUR_BUNDLE_ID> 为App的Bundle Id
注意事项：
脚本默认在Debug模式及模拟器编译情况下不会上传符号表，在需要上传的时候，请修改下列选项
- Debug模式编译是否上传，1＝上传 0＝不上传，默认不上传
UPLOAD_DEBUG_SYMBOLS=0 - 模拟器编译是否上传，1＝上传 0＝不上传，默认不上传
UPLOAD_SIMULATOR_SYMBOLS=0
至此，自动上传符号表脚本配置完毕，Bugly 会在每次 Xcode 工程编译后自动完成符号表配置工作。
三、手动配置
手动配置的流程如下：
-
下载最新版Bugly iOS符号表工具，其中工具包中包括：
- 符号表工具JAR包（buglySymboliOS.jar）
- Windows的脚本（buglySymboliOS.bat）
- Shell脚本（buglySymboliOS.sh）
- 默认符号表配置文件（settings.txt）
-
符号表工具iOS版-使用指南
4009.png
根据Crash的UUID定位dSYM文件
使用工具生成符号表文件（zip文件）
在页面上传符号表文件
注意事项:
环境要求 : 符号表工具的运行需要Java运行环境
示例操作：
1、将Xcode生成的dSYM文件拷贝至桌面
2、生成符号表文件
使用符号表工具的JAR包生成符号表文件的命令如下:
cd /Users/liuyi/Downloads/buglySymboliOS2.4.3\ \(1\)
java -jar buglySymboliOS.jar -i /Users/liuyi/Desktop/HDGansuKJG.app.dSYM
生成的符号表文位于: /Users/liuyi/Desktop/
3、上传 buglySymbol_HDGansuKJG_arm64-f1abe.zip 文件
四、dSYM文件
什么是dSYM文件？
iOS平台中，dSYM文件是指具有调试信息的目标文件，文件名通常为：xxx.app.dSYM。如下图所示：
为了方便找回Crash对应的dSYM文件和还原堆栈，建议每次构建或者发布APP版本的时候，备份好dSYM文件。
如何定位dSYM文件？
一般情况下，项目编译完dSYM文件跟app文件在同一个目录下，下面以XCode作为IDE详细说明定位dSYM文件。
-> 进入XCode；
-> 打开工程（已编译过）；
-> 在左栏找到“Product”项；
-> 鼠标右键点击编译生成的“xxx.app”；
-> 点击“Show in Finder”；
如下图所示：
XCode编译后没有生成dSYM文件？
XCode Release编译默认会生成dSYM文件，而Debug编译默认不会生成，对应的Xcode配置如下：
XCode -> TARGETS -> Build Settings -> Code Generation -> Generate Debug Symbols -> Yes
XCode -> TARGETS -> Build Settings -> Build Option -> Debug Information Format -> DWARF with dSYM File
