腾讯bugly接入插件（CocosCreator）

下载: 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,修改内容如下

这时候就可以生成符号表上传了！如图上传成功！