符号表和 dSYM UUID 确认

什么是符号表?

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

<起始地址> <结束地址> <函数> [<文件名:行号>]

为什么要配置符号表?

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

举一个例子:

dSYM文件

什么是dSYM文件?

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

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

如何定位dSYM文件?

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

  • > 进入XCode;
  • > 打开工程(已编译过);
  • > 在左栏找到"Product"项;
  • > 鼠标右键点击编译生成的"xxx.app";
  • > 点击"Show in Finder";

如下图所示:

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

XCode编译后没有生成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

开启Bitcode之后需要注意哪些问题?

  • 在点"Upload to App Store"上传到App Store服务器的时候需要声明符号文件(dSYM文件)的生成:
  • 在配置符号表文件之前,需要从App Store中把该版本对应的dSYM文件下载回本地(参考"如何找回已发布到App Store的App对应的dSYM文件?"),然后用符号表工具生成和上传符号表文件。
  • 不需要配置自动生成符号表的脚本了,也不要用本地生成的dSYM文件来生成符号表文件,因为本地编译生成的dSYM文件的符号表信息都被隐藏了。如果用本地编译生成的dSYM文件生成符号表文件并配置到Bugly平台之后,还原出来的结果将是类似于"__hiden#XXX"这样的符号。

如何判断dSYM文件是否与Crash的UUID匹配?

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

Bugly v1.0页面

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

Bugly v2.0页面

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

如何查看dSYM文件的UUID?

通过命令查看UUID

复制代码
xcrun dwarfdump --uuid <dSYM文件>

通过符号表文件查看UUID

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

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

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

如何找回已发布到App Store的App对应的dSYM文件?

通过Xcode找回

  1. 打开 Xcode 顶部菜单栏 -> Window -> Organizer 窗口:

  2. 打开 Xcode 顶部菜单栏,选择 Archive 标签:

  3. 找到发布的归档包,右键点击对应归档包,选择Show in Finder操作:

  4. 右键选择定位到的归档文件,选择显示包内容操作:

  5. 选择dSYMs目录,目录内即为下载到的 dSYM 文件:

通过iTunes Connect找回

  1. 登录iTunes Connect

  2. 进入"我的App(My Apps)"的"活动(Activity)"页面:

  3. 在"所有构件版本(All Builds)"中选择某一个版本,点"下载dSYM(Download dSYM)"下载dSYM文件:

通过mdfind工具找回

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

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

复制代码
mdfind "com_apple_xcode_dsym_uuids == <UUID>"

注意,使用mdfind时,UUID需要格式转换(增加"-"): 12345678-1234-1234-1234-xxxxxxxxxxxx

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

复制代码
mdfind "com_apple_xcode_dsym_uuids == E30FC309-DF7B-3C9F-8AC5-7F0F6047D65F"
                                     |12345678-1234-1234-1234-xxxxxxxxxxxx|

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

mdfind 查看 xxx.app 的 UUID

objectivec 复制代码
# 查看 xx.app 文件的 UUID
dwarfdump --uuid xx.app/xx

# 查看 xx.app.dSYM 文件的 UUID
dwarfdump --uuid xx.app.dSYM

如何上传符号表到bugly平台?

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

参考链接:

Bugly iOS 符号表配置

iOS 符号化浅析

相关推荐
大熊猫侯佩2 小时前
Swift 6.4 的 Ref / MutableRef 大揭秘:给值类型开一扇“安全的小窗”
ios·swift·编程语言
黑科技iOS上架3 小时前
没有mac电脑如何借助windows系统上传ipa到App Store
经验分享·ios
Layer4 小时前
从 WWDC 26 空间重构(Spatial Reframing)再看端侧 2D 转 3D 的技术演进
ios·aigc
Cutecat_13 小时前
视频字幕处理工具横向:提取模式 vs 编辑模式,该如何选择
android·前端·ios·语音识别
大熊猫侯佩18 小时前
WWDC26 SwiftUI 进化之路:砸碎黑盒,彻底迎来开发自由!
ios·swiftui·swift
游戏开发爱好者819 小时前
iPhone真机调试有哪些方法?一次定位推送权限问题时整理出来的几种方案
ide·vscode·ios·objective-c·个人开发·swift·敏捷流程
大熊猫侯佩1 天前
WWDC26 最被忽视的王炸:告别“伪并发”陷阱,Swift 6.4 的 async defer
ios·swift·编程语言
h-189-53-6712071 天前
苹果开发者账号防关联3.2f隔离环境传包提审iOS开发上架的高效隔离方案:iOSUploader工具实用解析
ios·ios上架·ios审核·苹果审核·苹果开发者账号·苹果开发者封号
Legendary_0081 天前
LDR6020P:iPad 一体式皮套键盘 OTG 应用的核心引擎
ios·计算机外设·ipad
Digitally2 天前
如何高效地将文件从电脑传输到 iPad:6 种简单方法
ios·电脑·ipad