10/28/2024 17:13:23

Bugly2 渠道说明

一、概述

一、概述

腾讯 Bugly2,是 Bugly 的升级版本,为移动开发者提供专业的异常上报和运营统计,帮助开发者快速发现并解决异常,同时掌握产品运营动态,及时跟进用户反馈。

注意:因为Bugly2、Bugly与Firebase都有crash监控功能,存在不兼容的问题,不要同时接入
二、开发者平台配置

二、开发者平台配置

2.1 创建应用

Bugly2 平台注册一个产品。在【我的产品列表】中,有【创建产品】入口,并填写对应信息。

2.2 其他步骤

创建产品完成后,获取应用的 APP ID 和 APP KEY。

三、 Android工程配置

三、 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工程配置

四、 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上报

  1. 有些场景下,应用不需要崩溃上报,如:有些应用在杀进程时触发的上报不想上报到bugly2;此时可以调用该接口关闭崩溃上报,其他bugly2功能不影响;重新启动应用后再触发的崩溃会正常上报
  2. 动态关闭bugly2上报。调用时会关闭崩溃上报,其他bugly2功能不影响;重新启动应用后再触发的崩溃会正常上报。

  3. bugly2 iOS 海外版不支持动态关闭上报。

  4. 具体接口调用可参照 “异常上报模块” 的 " 2.7 动态关闭Crash上报 (当前仅Bugly、Bugly2渠道支持) " 部分。



Copyright © 2024 MSDK.
All rights reserved.

results matching ""

    No results matching ""