美文网首页
Bugly iOS 符号表配置

Bugly iOS 符号表配置

作者: 平凡之路561 | 来源:发表于2018-11-22 09:35 被阅读0次

一:介绍

1、什么是符号表?

符号表是内存地址与函数名、文件名、行号的映射表。

符号表元素如下所示:

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

2、为什么要配置符号表?

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

举一个例子: 4001.png

Bugly提供了自动和手动两种方法配置iOS符号表。

二、自动配置:XCode + sh脚本(推荐)

1、自动配置请首先下载和解压自动配置符号表工具包,然后选择上传方式并配置Xcode的编译执行脚本。

10002.png

2、直接上传dSYM文件(默认方式 )

配置Xcode编译执行脚本

  • 在Xcode工程对应Target的Build Phases中新增Run Scrpit Phase


    4003.jpg
4004.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

4005.jpg

注意事项:
脚本默认在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 文件

upload.png

四、dSYM文件

什么是dSYM文件?

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

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

如何定位dSYM文件?

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

-> 进入XCode;

-> 打开工程(已编译过);

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

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

-> 点击“Show in Finder”;

如下图所示: 4006.png 4007.png

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

4008.png

相关文章

网友评论

      本文标题:Bugly iOS 符号表配置

      本文链接:https://www.haomeiwen.com/subject/fwykqqtx.html