一、概述

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

二、开发者平台配置

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

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

2. 动态关闭bugly2上报。调用时会关闭崩溃上报，其他bugly2功能不影响；重新启动应用后再触发的崩溃会正常上报。

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

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