-
下载: plugin-bugly.zip (1.4 MB)
-
插件开源地址: https://github.com/tidys/CocosCreatorPlugins/tree/master/packages/plugin-bugly
1.Bugly是什么?
Bugly 是腾讯提供的服务, 是为基于 Cocos 引擎的App(iOS/Android)封装的 Bugly 原生(iOS/Android) SDK 的接口,方便调用 Bugly 原生 SDK,可用于SDK初始化、设置自定义用户信息、错误等,并自动捕获上报App的脚本(Lua、JavaScript)错误和原生代码(如Objective-C、Java、C/C++等)引发的崩溃信息,提供实时、多维度的异常问题分析服务。
2.使用该插件有什么好处?
按照Bugly官方提供的接入文档,需要修改工程的多处文件,具体可以参考bugly官方文档
比如需要修改Android.mk, AndroidManifest.xml,拷贝各种so库,这部分涉及到了Android编程,对于从没有接触安卓编程的小伙伴一脸懵逼啊
还要修改Classes/AppDelegate.cpp,增加Bugly初始化等c++代码,如果你是从cocos2dx过渡过来的小伙伴,肯定很熟悉C++部分代码,不然你就惨咯,这明摆着就是欺负Creator萌新们!
都说Creator是游戏开发利器,火遍了大江南北,难道就没有那种 一键接入 的插件吗?对!就是那种 一键XXX 的,我最喜欢了,没错,Bugly插件就是你要的,而且最重要的是免费呦,很符合国情滴
3.如何使用该插件?
- 使用前你需要去Bugly官网申请账号
然后添加一个产品应用(记得平台是安卓,因为插件目前仅仅支持安卓)
- 在 我的产品 中即可看到刚才创建的产品应用,点击 设置 ,里面提供了接入Bugly必须的参数
- 下载插件plugin-bugly.zip (1.4 MB)
然后打开插件,如图:
- 界面比较简洁,下边具体来解释一下填写的参数
App Id : 腾讯bugly服务后台提供
App Key : 腾讯bugly服务后台提供
App Package : 游戏包名,该参数只读,不允许手动填写,插件会 自动读取 项目的配置,所以你不得不先构建项目
App Version : 游戏版本
App Channal : 游戏渠道
自动上传符号表 : 生成符号表文件后是否自动上传生成的符号表文件
添加Bugly按钮 : 该操作需要App Id参数,修改android工程,如果没有构建项目,插件会在日志窗口自动提示,
上传符号表 : 生成符号表并根据用户选择确定是否上传符号表文件到Bugly后台
4.什么是符号表?为什么要配置符号表?
符号表是内存地址与函数名、文件名、行号的映射表。符号表元素如下所示:
为了能快速并准确地定位用户APP发生Crash的代码位置,Bugly使用符号表对APP发生Crash的程序堆栈进行解析和还原。
举一个例子
这个是没有上传符号表的Crash堆栈信息:
这个是上传符号表之后解析的Crash堆栈信息:
通过对比,我们发现符号表的作用其实就是为了快速定位代码出错的位置
要查看符号表文件的具体信息可以在这里查看:
5.上传符号表文件注意事项
生成符号表 需要java环境,请确保已经安装 java ,并且 JRE或JDK版本需要 >= 1.6 ,其实该插件仅仅是调用了Bugly提供的上传符号表工具,具体的文档参考这里Bugly Android符号表配置
6.美中不足
美中不足的是该插件目前只支出Android,后续会尽快支持IOS
7.最后的最后
- 插件中使用的是bugly版本是1.4.3
- creator建议1.6.x以上
- 如果你想要了解更多插件的工作原理,具体可以参考这篇帖子:
http://forum.cocos.com/t/creator1-7-bugly/52923
注意事项:
将插件放入项目的packages目录下,打开插件填入参数,然后点击按钮 添加Bugly
由于该插件只导入了armeabi-v7a,所以如果还使用了其他架构还需要手动将so文件拷 (BuglySDK/Android/libs目录下)贝到android项目路径jni目录下,如图:
由于1.6版本之后的安卓目录变动,so文件现在生成在app/build/目录下,所以需要手动更改插件panel/index.js,修改内容如下
这时候就可以生成符号表上传了!如图上传成功!