txBugly

来自于:AC模块工作室立即使用

setUserValue allUserValues setTag currentTag reportException reportError sdkVersion deviceId

概述

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

使用此模块之前必须先配置 config 文件,配置方法如下:

  1. <feature name="txBugly">
  2. <param name="appId_iOS" value="" />
  3. <param name="appId_Android" value="" />
  4. <param name="channel" value= "6718"/>
  5. <param name="version" value="" />
  6. <param name="deviceIdentifier" value="" />
  7. <param name="blockMonitorEnable" value="false" />
  8. <param name="blockMonitorTimeout" value="1" />
  9. <param name="symbolicateInProcessEnable" value="true" />
  10. <param name="unexpectedTerminatingDetectionEnable" value="false" />
  11. <param name="viewControllerTrackingEnable" value="true" />
  12. <param name="consolelogEnable" value="true" />
  13. <param name="crashAbortTimeout" value="5" />
  14. <param name="exception" value="" />
  15. <param name="debug" value="" />
  16. <param name="reportDelay" value="" />
  17. </feature>
  • 字段描述:

    appId_iOS、appId_Android:注册Bugly分配的应用唯一标识,参考腾讯Bugly管理后台

    channel:设置自定义渠道标识

    version:设置自定义版本号

    deviceIdentifier:(可选项)设置自定义设备唯一标识

    blockMonitorEnable:(可选项)(仅ios有效)卡顿监控开关;默认为false

    blockMonitorTimeout:(可选项)(仅ios有效)卡顿监控判断间隔,单位为秒;默认:1

    symbolicateInProcessEnable:(可选项)(仅ios有效)进程内还原开关;默认为true
    unexpectedTerminatingDetectionEnable:(可选项)(仅ios有效)非正常退出事件记录开关;默认为false

    viewControllerTrackingEnable:(可选项)(仅ios有效)页面信息记录开关,默认开启;默认为true

    consolelogEnable:(可选项)(仅ios有效)控制台日志上报开关,默认开启;默认为true

    crashAbortTimeout:(可选项)(仅ios有效)崩溃退出超时,如果监听到崩溃后,App一直没有退出,则到达超时时间后会自动abort进程退出,当赋值为0时,则不会自动abort进程退出,单位为秒;默认:5

    exception:(可选项)(仅ios有效)需上报记录,设置后会随异常上报一起上报;默认:’’

    debug:(可选项)(仅android有效)调试模式,设置为“true”时:输出详细的Bugly SDK的Log,每一条Crash都会被立即上报,自定义日志将会在Logcat中输出;默认:’false’

    reportDelay:(可选项)(仅android有效)bugly联网延时,Bugly会在启动10s后联网同步数据。若您有特别需求,可以修改这个时间;

注意:本模块 iOS 平台上最低适配系统版本为 iOS 8.0

模块接口

setUserValue

设置关键数据,随崩溃信息上报

setUserValue({params})

params

key:

  • 类型:字符串类型
  • 描述:关键数据的key

value:

  • 类型:字符串类型
  • 描述:关键数据的value

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.setUserValue({
  3. key:'',
  4. value:''
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

allUserValues

获取关键数据

allUserValues(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:设置的关键数据
  • 内部字段:
  1. {
  2. 'key':'value',
  3. 'key':'value'
  4. }

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.allUserValues(function(ret){
  3. console.log(JSON.stringify(ret))
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setTag

设置标签

setTag({params})

params

tag:

  • 类型:数字类型
  • 描述:标签

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.setTag({
  3. tag:0,
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

currentTag

获取当前设置标签

currentTag(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. tag:0 //数字类型;设置的标签
  3. }

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.currentTag(function(ret){
  3. console.log(JSON.stringify(ret))
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

reportException

上报自定义异常

reportException({params})

params

name:

  • 类型:字符类型
  • 描述:(仅ios支持)异常名字

reason:

  • 类型:字符类型
  • 描述:异常原因

userInfo:

  • 类型:json对象类型
  • 描述:(可选项)(仅ios支持)异常信息
  • 示例:
  1. {
  2. version:'1.0',
  3. id:'0'
  4. }

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.reportException({
  3. name:'',
  4. reason:''
  5. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

reportError

上报错误(仅ios支持)

reportError({params})

params

domain:

  • 类型:字符类型
  • 描述:错误域

code:

  • 类型:数字类型
  • 描述:错误码

userInfo:

  • 类型:json对象类型
  • 描述:(可选项)异常信息
  • 示例:
  1. {
  2. version:'1.0',
  3. id:'0'
  4. }

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.reportError({
  3. domain:'',
  4. code:0
  5. });

可用性

iOS系统

可提供的1.0.0及更高版本

sdkVersion

获取 SDK 版本信息

sdkVersion(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. sdkVersion:'' //字符类型;SDK版本信息
  3. }

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.sdkVersion(function(ret){
  3. console.log(JSON.stringify(ret))
  4. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

deviceId

获取设备ID(仅ios支持)

deviceId(callback(ret))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. deviceId:'' //字符类型;设备ID
  3. }

示例代码

  1. var txBugly = api.require('txBugly');
  2. txBugly.deviceId(function(ret){
  3. console.log(JSON.stringify(ret))
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本