10/28/2024 17:13:23
Bugly2 渠道说明
二、开发者平台配置
2.1 创建应用
在 Bugly2 平台注册一个产品。在【我的产品列表】中,有【创建产品】入口,并填写对应信息。
2.2 其他步骤
创建产品完成后,获取应用的 APP ID 和 APP KEY。
三、 Android工程配置
3.1 权限配置
【必选】权限列表
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
[info] 注意
READ_PHONE_STATE
为敏感权限,主要用于设备获取标识
3.2 App ID 配置
在工程文件 assets/MSDKConfig.ini 中添加配置
[Bugly2 调试配置]
MSDK_DEBUG = 1
MSDK_DEBUG_CHANNEL = Bugly2
[Bugly2 渠道配置]
BUGLY2_APP_ID_ANDROID = {BUGLY2_APP_ID_ANDROID}
BUGLY2_APP_KEY_ANDROID = {BUGLY2_APP_KEY_ANDROID}
[info]
1.将
{BUGLY2_APP_ID_ANDROID}
改成游戏在 Bulgy2 平台的ID。
2.{MSDK_DEBUG}
1 表示打开调试模式,0 表示关闭调试模式。
3.{MSDK_DEBUG_CHANNEL}
此开关设置为 Bugly2,表示开启 Bugly2 调试,仅当{MSDK_DEBUG}
为1时,此开关生效,在同一配置文件中。
3.3 【可选】App 版本号配置
MSDK 默认读取业务的 versionName 和 versionCode 作为 Bugly2 的 App 版本号,如果业务需要自定义版本号,需要在工程文件 assets/MSDKConfig.ini 中添加配置
[Bugly2 渠道配置]
BUGLY2_APP_VERSION = {YOUR_BUGLY2_APP_VERSION}
[info]
1.将
{YOUR_BUGLY2_APP_VERSION}
改成游戏自定义的 App 版本号
2.MSDK 将忽略 AndroidManifest.xml 中游戏自定义的BUGLY2_APP_VERSION
配置
四、 iOS工程配置
4.1 MSDK 环境配置
在工程中找到 MSDKAppSetting.bundle/MSDKConfig.ini 文件,增加如下配置
[Bugly2 渠道配置]
BUGLY2_APP_ID_IOS = {BUGLY2_APP_ID_IOS}
BUGLY2_APP_KEY_IOS = {BUGLY2_APP_KEY_IOS}
4.2 系统库依赖
+ SystemConfiguration.framework
+ Security.framework
+ libz.dylib 或 libz.tbd
+ libc++.dylib 或 libc++.tbd
五、功能说明
5.1 异常上报功能
示例代码详见 异常上报模块,对应其中的 Bugly2 渠道。
[info] Bugly2 的自定义日志打印接口存在 Android/iOS 逻辑不一致问题,Bugly2 Android 不支持 silent 级别的日志上报,但 iOS 支持。使用时需要注意。
1)上报信息介绍
①上报 crash 进程的堆栈,包括出错堆栈、系统日志等;
②上报当前手机的基本信息,包括设备名称(厂商,型号)、系统版本、磁盘可用占比、SD卡可用占比、内存可用占比等;
③上报用户的 openid,如下图的“用户 ID”所示。默认上报的用户 ID 是 MSDK openid,也支持设置自定义用户 ID。
④用户自定义上报信息
A.可以自定义应用在 crash 时上报的日志,如下图所示,在“日志”选择“自定义日志”查看:
B.可以设置关键数据键值对,随崩溃信息上报。Android的如下图所示,在“附件”的valueMapOther.txt中查看:
iOS的在user_datas.log查看:
C.可以设置崩溃时额外日志/二进制数据上报。Android的额外日志和二进制数据分别在“附件”的user_datas.log和userExtraByteData中:
iOS的额外日志在“附件”的crash_attach.log,由于Bugly2平台设计,ios 没有二进制文件userExtraByteData
5.2 动态关闭bugly2上报
- 有些场景下,应用不需要崩溃上报,如:有些应用在杀进程时触发的上报不想上报到bugly2;此时可以调用该接口关闭崩溃上报,其他bugly2功能不影响;重新启动应用后再触发的崩溃会正常上报
动态关闭bugly2上报。调用时会关闭崩溃上报,其他bugly2功能不影响;重新启动应用后再触发的崩溃会正常上报。
bugly2 iOS 海外版不支持动态关闭上报。
具体接口调用可参照 “异常上报模块” 的 " 2.7 动态关闭Crash上报 (当前仅Bugly、Bugly2渠道支持) " 部分。
All rights reserved.