Bugly使用

Bugly使用

第一部分“使用Bugly”是我第一次使用Bugly时的记录，第二部分“Bugly的简单使用”是我搞明白怎么用之后的简单总结。如果已经看完了Bugly的官方文档的话直接跳过第一部分即可，因为第一部分比较乱，但是也有可读性，记录了第一次使用过程中的问题。

一、使用Bugly

Bugly是腾讯日志上报的SDK，有异常上报和运营统计上报。App集成后，即可在Web站点查看应用上报的崩溃数据和联网数据。

1、统计奔溃信息Bugly SDK

Bugly iOS SDK 使用指南

如果只是统计简单的奔溃日志的话，集成Bugly这个SDK就可以了。

pod ‘Bugly’

需要去后台创建一个应用，并生成appId

引入头文件#import <Bugly/Bugly.h>

注册Bugly

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [Bugly startWithAppId:k_Bugly_AppId];//注册
    [BuglyLog initLogger:BuglyLogLevelVerbose consolePrint:YES];//设置日志
    return YES;
}

然后做一个测试，弄一个简单的闪退试试看

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
    [dict setObject:@"bugly test" forKey:nil];
}

进入App，点击，闪退

控制台将奔溃堆栈日志打印了出来

2019-11-11 14:03:26.625 BuglyTest[523:209320] <Unknown>: [BLYLog]  Trapped uncaught exception 'NSInvalidArgumentException', reason: '*** -[__NSDictionaryM setObject:forKey:]: key cannot be nil' 
(
	0   CoreFoundation                      0x00000001d2649294 <redacted> + 252
	1   libobjc.A.dylib                     0x00000001d18239f8 objc_exception_throw + 56
	2   CoreFoundation                      0x00000001d25c2ce8 _CFArgv + 0
	
...

然后去Bugly管理后台查看奔溃日志统计，在异常上报里已经将刚才的闪退堆栈信息统计到了，可以直接查看。

挺好用的。

2、Bugly Extension SDK

iOS App Extension SDK 使用指南

BuglyExtension SDK是做什么用的呢？

先按照文档来弄弄看吧。

Bugly Extension 依赖于 Bugly iOS SDK 1.2.9 及以上版本

pod ‘BuglyExtension’

引入头文件#import <BuglyExtension/CrashReporterLite.h>

注意需要在入口的 ViewController.h 中导入头文件

我是先pod Bugly，之后pod BuglyExtension的，pod完之后编译一下报下面错误：

duplicate symbol _WatchExtensionHandlerKey in: /Users/vhall/Desktop/BuglyTest/Pods/Bugly/Bugly.framework/Bugly(libBugly.a-arm64-master.o) /Users/vhall/Desktop/BuglyTest/Pods/BuglyExtension/BuglyExtension.framework/BuglyExtension(RqdCrashReporterLiteException.o) duplicate symbol _WatchExtensionExceptionDataKey in: /Users/vhall/Desktop/BuglyTest/Pods/Bugly/Bugly.framework/Bugly(libBugly.a-arm64-master.o) /Users/vhall/Desktop/BuglyTest/Pods/BuglyExtension/BuglyExtension.framework/BuglyExtension(RqdCrashReporterLiteException.o) duplicate symbol _OBJC_CLASS_$_RqdCrashReporterLiteException in: /Users/vhall/Desktop/BuglyTest/Pods/Bugly/Bugly.framework/Bugly(libBugly.a-arm64-master.o) /Users/vhall/Desktop/BuglyTest/Pods/BuglyExtension/BuglyExtension.framework/BuglyExtension(RqdCrashReporterLiteException.o) duplicate symbol _OBJC_METACLASS_$_RqdCrashReporterLiteException in: /Users/vhall/Desktop/BuglyTest/Pods/Bugly/Bugly.framework/Bugly(libBugly.a-arm64-master.o) /Users/vhall/Desktop/BuglyTest/Pods/BuglyExtension/BuglyExtension.framework/BuglyExtension(RqdCrashReporterLiteException.o) duplicate symbol _WatchExtensionHandlerMessage in: /Users/vhall/Desktop/BuglyTest/Pods/Bugly/Bugly.framework/Bugly(libBugly.a-arm64-master.o) /Users/vhall/Desktop/BuglyTest/Pods/BuglyExtension/BuglyExtension.framework/BuglyExtension(RqdCrashReporterLiteException.o) ld: 5 duplicate symbols for architecture arm64 clang: error: linker command failed with exit code 1 (use -v to see invocation)
Bugly.framework 和 BuglyExtension.framework有重复文件。

到这还是不清楚这个BuglyExtension SDK是做什么用的呢？

是不是不是这么用的啊，第一次用，文档也没说，有点蒙圈。

然后通过Bugly问题反馈问了一下 BuglyExtension SDK是做什么用的呢？我查到了一个问题：

iOS SDK和iOSExtension SDK的区别

回答是：

1.iOS SDK包：用于收集主程序的崩溃、卡顿，统计APP的运营数据等（详细功能可以进入更新历史进行了解）
2.iOS Extension SDK包：用于收集扩展中的崩溃，在集成时，需要集成在你的APP的扩展中（扩展是iOS 8中引入的一个非常重要的新特性，如果你的APP无扩展不用集成Extension SDK）

🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣分割线

请忽略上面Bugly Extension SDK的使用尝试，原来这个是给自己App的扩展App用的，用于手机扩展App的日志的，工程和Bugly应该是一样的。

怪不得文档上说，要将头文件引入到InterfaceController.m，当时看的时候我还想哪里来个InterfaceController.m的，再想想App扩展，就怀疑好像用法不对。

￣□￣｜｜尴尬了…

🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣🤣分割线

3、Bugly iOS 符号表

Bugly iOS 符号表配置

什么事符号表？符号表的作用是什么？在App中有什么用？怎么用？对我们的项目有什么帮助？带着疑问读文档。

假设上面的问题已经大体上明白了，再看配置符号表，即在项目中的使用。

3.1 配置符号表

下载工具包，里面有一个buglySymboliOS.jar和一个脚本文件。

文档上说“选择上传方式并配置Xcode的编译执行脚本“，看来这个脚本是添加到Xcode中的，编译就会执行。上传是生么鬼？

文档说有两种上传方式

3.1.1 自动配置：XCode + sh脚本

文档：

使用脚本自动配置支持两种上传方式：
	方式一：直接上传dSYM文件（默认方式 ）

	方式二：提取dSYM文件的符号表文件并上传

其中，使用方式二需要额外操作以下几步：
	下载符号表提取工具依赖的Java运行环境（JRE或JDK版本需要>=1.6）

	把工具包buglySymbolIOS.jar保存在用户主目录（Home）的bin目录下（没有bin文件夹,请自行创建）:

”提取dSYM文件的符号表文件并上传其中“，这说法有点模棱两可，上传其中是上传到哪里去呢？

“使用方式二需要额外操作以下几步”，意思是方式一不用下面几个步骤吗？那方式一是怎么传呢？

如果说方式一不需要”额外操作以下几个步骤“的话，是不需要设置脚本的，前面又说“选择上传方式并配置Xcode的编译执行脚本”。

“下载符号表提取工具依赖的Java运行环境（JRE或JDK版本需要>=1.6）”然后呢？下载了干什么用？

有一些疑问，文档里也没说。肿么整呢？

先把buglySymbolIOS.jar保存在用户主目录（Home）的bin目录下吧。

然后配置一下Xcode的脚本。

配置完修改脚本里面的App id等。

感觉有点模棱两可，可能需要补充一些其他知识才能明白吧。

3.1.2 手动配置

下载最新版Bugly iOS符号表工具，其中工具包中包括：
符号表工具JAR包（buglySymboliOS.jar）
Windows的脚本（buglySymboliOS.bat）
Shell脚本（buglySymboliOS.sh）
默认符号表配置文件（settings.txt）
符号表工具iOS版-使用指南
根据Crash的UUID定位dSYM文件

使用工具生成符号表文件（zip文件）

在页面上传符号表文件

这个符号表工具iOS版-使用指南还是需要仔细阅读的，里面有很多说明。

好吧，看完了我还是没明白怎么上传符号表，符号表到底是个什么东西。

3.1.3 符号表的使用

看了下网上开发者写的帖子，一目了然了。

3.1.3.1 安装jdk

java运行必要的环境IDE。

安装完后，打开终端验证一下，java -version显示jdk的版本

mengxiang:BuglyTest vhall$ java --version java 13.0.1 2019-10-15 Java(TM) SE Runtime Environment (build 13.0.1+9) Java HotSpot(TM) 64-Bit Server VM (build 13.0.1+9, mixed mode, sharing)

3.1.3.2 找到dSYM文件

在项目的Products->xxx.app下，show in Finder，里面找到xxx.app.dSYM。

如果Debug环境下没有dSYM文件，需要在Xcode->TARGET->Building Setting->Build Options下，将Debug Information Format改成DWARF with dSYM File。

XCode -> Build Settings -> Code Generation -> Generate Debug Symbols -> Yes，新版本的Xcode默认就是yes，这里不用管。

3.1.3.3 下载Bugly的符号表工具

这是Bugly提供的符号表文件分析工具。

在桌面创建一个文件夹，将buglySymboliOS.jar放入里面，然后将dSYM文件文件也放入里面，打开终端即可生成一个压缩文件，这个压缩文件就是要上传到App管理后台的文件。

例：我本地桌面创建了一个“符号表文件”的文件夹，我将buglySymboliOS.jar和BuglyTest.app.dSYM都放了进去，然后终端依次执行如下：

$ cd /Users/vhall/Desktop/符号表文件
ls
BuglyTest.app.dSYM	buglySymboliOS.jar
$ java -jar buglySymbolIOS.jar -i /Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM

Bugly Symtab Tool for iOS: 2.4.3
[SymtabTool-I] Extracting symtab file: BuglyTest
[SymtabTool-I] Begin to parse file: /Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM/Contents/Resources/DWARF/BuglyTest
[SymtabTool-I] Architecture: arm64
[SymtabTool-I] Successfully parsed the file!
[SymtabTool-I] Begin to parse file: /Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM/Contents/Resources/DWARF/BuglyTest
[SymtabTool-I] Architecture: arm64
[SymtabTool-I] Successfully parsed the file!
[SymtabTool-I] Begin to extract symbol table....
[SymtabTool-I] Successfully to extract symbol table!
[SymtabTool-I] Begin to create symtab file: /Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM/Contents/Resources/DWARF/buglySymbol&BuglyTest&arm64&0a1bcf066fae3249bf0bc68b96b0fa31.symbol
[SymtabTool-I] Successfully created symtab file!
[SymtabTool-I] Begin to zip symtab file: /Users/vhall/Desktop/符号表文件/buglySymbol_BuglyTest_arm64-0a1bc.zip
[SymtabTool-I] Successfully zipped symtab file!

简要步骤：

$ cd /Users/vhall/Desktop/符号表文件

$ java -jar buglySymbolIOS.jar -i /Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM

这里/Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM是BuglyTest.app.dSYM文件的路径。因为我直接cd到buglySymbolIOS.jar所在的文件夹下了，所以无需指定buglySymbolIOS.jar的路径。

3.1.3.4 上传生成了文件到管理后台

上传完后在奔溃分析->异常上报->符号表查看是否上传。

如果自己已经上传了但是任然出现未上传的情况，需要将工具包里的脚本文件添加到Xcode里，并修改Appid和AppKey并编译。

3.1.3.5 查看crash

略…

4、Bugly和友盟错误分析的对比

以下仅代表个人观点

• 友盟管理后台改版后感觉比较难用，经常找不到需要找的页面，Bugly就很好找，一目了然。

• 对于错误分析，友盟的分析工具比和Bugly的用起来都差不多，但是Bugly关于符号表的文档描述不是很清楚。

• 对于错误的统计及时性，我感觉Bugly比友盟及时。

二、Bugly的使用（精简版）

1、集成和使用

pod ‘Bugly’，如果Extension App中也需要统计，还需要在Extension App中pod ‘BuglyExtension’。

集成完后，注册，设置日志等，详情见官方文档。

2、日志分析

如果不使用符号表，直接用Bugly也是可以统计奔溃日志的，但是不能讲堆栈信息转成对应的类名等。需要将堆栈信息符号化，需要使用符号表。

2.1 生成符号表文件

下载Bugly官方文档中提供的工具，将App的dSYM文件和buglySymboliOS.jar放同一个文件夹

执行如下操作
$ cd /Users/vhall/Desktop/符号表文件

$ java -jar buglySymbolIOS.jar -i /Users/vhall/Desktop/符号表文件/BuglyTest.app.dSYM

生成一个压缩文件，这是需要上传到管理后台的文件。

2.2 上传符号表文件

2.2.1 手动上传

将生成的压缩文件直接传到管理后台即可。

2.2.2 手动执行脚本上传

下载工具包后解压

有一个脚本dSYMUpload.sh，需要填写里面的BUGLY_APP_ID，BUGLY_APP_KEY，BUNDLE_IDENTIFIER。

以下是执行脚本文件的过程已经报错

$ cd /Users/vhall/Desktop/BuglydSYMUploader //进入BuglydSYMUploader目录下
$ ls
buglySymboliOS.jar	dSYMUpload.sh
$ ./dSYMUpload.sh //执行脚本
-bash: ./dSYMUpload.sh: Permission denied //没权限执行
$ sudo ./dSYMUpload.sh //管理员身份执行
sudo: ./dSYMUpload.sh: command not found //没权限执行
$ sudo dSYMUpload.sh
sudo: dSYMUpload.sh: command not found
$ sudo
usage: sudo -h | -K | -k | -V
usage: sudo -v [-AknS] [-g group] [-h host] [-p prompt] [-u user]
usage: sudo -l [-AknS] [-g group] [-h host] [-p prompt] [-U user] [-u user] [command]
usage: sudo [-AbEHknPS] [-C num] [-g group] [-h host] [-p prompt] [-u user] [VAR=value] [-i|-s] [<command>]
usage: sudo -e [-AknS] [-C num] [-g group] [-h host] [-p prompt] [-u user] file ...
$
$ head -1 ./dSYMUpload.sh
#!/bin/sh
$ pwd
/Users/vhall/Desktop/BuglydSYMUploader
$ ls
buglySymboliOS.jar	dSYMUpload.sh
$ sudo /bin/sh dSYMUpload.sh //执行脚本，上面步骤可以直接跳过直接执行这里

//报错信息，appid，appkey什么的参数没填
Usage: dSYMUpload.sh <bugly_app_id> <bugly_app_key> <app_bundle_identifier> <app_version> <dSYM_src_dir> <bSYMBOL_dest_dir> [upload_dsym_only]

--------------------------------
Error: Bugly App ID not defined. Please set 'BUGLY_APP_ID'
--------------------------------

报错信息是App ID not defined，提示我们使用

dSYMUpload.sh <bugly_app_id> <bugly_app_key> <app_bundle_identifier> <app_version> <dSYM_src_dir> <bSYMBOL_dest_dir> 来上传

对应的参数是appId，appKey，identifier,版本号，dSYM文件路径，buglySymboliOS.jar的文件路径。

这样本地执行脚本上传太麻烦了，有点本末倒置，不建议这样用，Bugly的脚本是推荐在Xcode里配置让自动上传。这里手动执行脚本上传只是我自己本地做了个测试。

2.2.3 Xcode配置脚本上传

1、将脚本添加到Xcode，修改BUGLY_APP_ID，BUGLY_APP_KEY，BUNDLE_IDENTIFIER。

2、把工具包buglySymbolIOS.jar保存在用户主目录（Home）的bin目录下（没有bin文件夹,请自行创建）

打开终端默认就是在Home目录下，然后open .打开Home目录，创建bin文件夹，将buglySymbolIOS.jar拷贝进去

编译之后符号表就直接就上传到管理后台了。

2.3 查看奔溃日志

略…