Cocos Store:腾讯 Bugly 接入插件小助手
继开搞了四五款插件并成功上线 Cocos Store 后,今天我给大家介绍的这款腾讯 Bugly 插件小助手可以说是集万千宠爱于一身,千呼万唤始出来。我经常使用这个 SDK 来帮助自己排查 bug,相信大家也不例外。希望还不了解 Bugly 插件的小伙伴看完今天的介绍后,移步到 Cocos Store 去下载!
Bugly 是腾讯提供的服务, 是为基于 Cocos 引擎的 App(iOS/Android)封装的 Bugly 原生 SDK 的接口。方便调用 Bugly 原生 SDK,可用于 SDK 初始化、设置自定义用户信息、错误等,并自动捕获上报 App 脚本(Lua、JavaScript)错误和原生代码(如 Objective-C、Java、C/C++ 等)引发的崩溃信息,提供实时、多维度的异常问题分析服务。
按照 Bugly 官方提供的接入文档,需要修改工程的多处文件,具体可以参考 Bugly 官方文档。
比如修改 Android.mk、AndroidManifest.xml、拷贝各种 so 库,这部分涉及到了 Android 编程,对于从没有接触安卓编程的小伙伴将会是一脸懵逼。
如果需要修改 Classes/AppDelegate.cpp、增加 Bugly 初始化等 c++ 代码,除非你是从 Cocos2d-x 过渡来的小伙伴,并且对 C++ 部分代码非常熟悉还说得过去,但是做为 Creator 的萌新们就没那么幸运了!
虽然说 Creator 是火遍大江南北的游戏开发利器,好多人都在寻找那种一键接入的插件,对!就是那种一键 XXX 的,而 Bugly 插件就能满足以上你所有的需求,最重要的是全免费,是不是很棒棒!
1、使用前你需要去 Bugly 官网申请账号,然后添加一个产品应用(插件目前仅支持安卓)
2、在我的产品中即可看到刚才创建的产品应用,点击设置,里面提供了接入 Bugly 必须的参数
3、下载插件后打开插件,如图:
4、由于界面比较简洁,下边让我来具体解释一下填写的参数
App ID : 腾讯 Bugly 服务后台提供
App Key : 腾讯 Bugly 服务后台提供
App Package : 游戏包名,该参数只读,不允许手动填写,插件会 自动读取 项目的配置,所以你不得不先构建项目
App Version : 游戏版本
App Channal : 游戏渠道
自动上传符号表 : 生成符号表文件后是否自动上传生成的符号表文件
添加 Bugly 按钮 : 该操作需要 App ID 参数,修改 Android 工程,如果没有构建项目,插件会在日志窗口自动提示,
上传符号表 : 生成符号表并根据用户选择确定是否上传符号表文件到 Bugly 后台
符号表是内存地址与函数名、文件名、行号的映射表。
符号表元素如下所示:
<起始地址> <结束地址> <函数> [<文件名:行号>]
为了能快速并准确地定位用户 APP 发生 Crash 的代码位置,Bugly 使用符号表对 APP 发生 Crash 的程序堆栈进行解析和还原。
举一个例子,这个是没有上传符号表的 Crash 堆栈信息:
这个是上传符号表之后解析的 Crash 堆栈信息:
通过对比,我们发现符号表的作用其实就是为了快速定位代码出错的位置
要查看符号表文件的具体信息可以在这里查看:
生成符号表需要 Java 环境。请确保已经安装 Java,并且 JRE 或 JDK 版本需要为 v1.6 及以上 ,该插件仅仅是调用了 Bugly 提供的上传符号表工具,具体的文档请参考 Bugly Android 符号表配置。
插件中使用的 Bugly 版本是 v1.4.3
使用 Creator 版本建议 v1.6 及以上
如果你想要了解更多插件的工作原理,请参考下列链接
美中不足的是该插件目前只适用 Android,后续会尽快支持 IOS
欢迎提出使用建议(文末留言或者插件商店用户评论区)
期待更多更好的插件上线 Cocos Store
强烈建议官方来一场自研插件 PK 赛
Bugly官方文档
https://bugly.qq.com/docs/user-guide/instruction-manual-plugin-cocos/?v=20170912151050
Bugly官网
https://bugly.qq.com/v2/
Bugly Android符号表配置
https://bugly.qq.com/docs/user-guide/symbol-configuration-android/?v=20170912151050#_2
插件工作原理
http://forum.cocos.com/t/creator1-7-bugly/5292320
Bugly下载地址
http://store.cocos.com/stuff/show/178915.html