更新记录

1.1.1（2025-12-08）

~修改信息

1.1.0（2025-12-08）

初始版本上线~~

平台兼容性

uni-app(4.81)

BuglyPro uni-app 插件

基于腾讯 Bugly 专业版 SDK 的崩溃监控、性能监控插件，支持 Android 和 iOS。

功能

• 崩溃监控（Java/Native/ANR/OOM）
• 错误上报
• 启动监控
• 性能监控（FPS 卡顿）
• 用户数据设置

快速开始

1. 获取 AppID 和 AppKey

访问 Bugly 专业版官网 创建应用并获取凭证。

2. 初始化

在 App.vue 的 onLaunch 中初始化：

// #ifdef APP-PLUS
import * as BuglyPro from '@/uni_modules/BuglyPro'

const systemInfo = uni.getSystemInfoSync()
const platform = systemInfo.platform || plus?.os?.name || ''
const isAndroid = platform.toLowerCase() === 'android'
const isIOS = platform.toLowerCase() === 'ios'

if (isAndroid) {
  BuglyPro.sdkInit({
    appID: 'your-android-app-id',
    appKey: 'your-android-app-key',
    appVersion: plus?.runtime?.version || '1.0.0',
    buildNumber: (plus?.runtime?.versionCode || 1) + '',
    debugMode: false
  })
  BuglyPro.startSpan('AppLaunch', null)
} else if (isIOS) {
  BuglyPro.sdkInit({
    appID: 'your-ios-app-id',
    appKey: 'your-ios-app-key',
    buildNumber: (plus?.runtime?.versionCode || 1) + ''
  })
  BuglyPro.startSpan('AppLaunch', null)
}
// #endif

3. 报告启动完成

在首页加载完成后调用：

// #ifdef APP-PLUS
BuglyPro.reportAppFullLaunch()
BuglyPro.endSpan('AppLaunch')
// #endif

常用 API

错误上报

iOS 平台（category 必填）：

BuglyPro.testError({
  category: 5,  // 必填，枚举值：Cocoa=3, CSharp=4, JS=5, Lua=6
  errorType: 'NetworkError',
  errorMsg: '网络请求失败',
  stack: 'at Api.request(Api.js:123)'
})

Android 平台（category 选填）：

BuglyPro.testError({
  category: 8,  // 选填，枚举值：u3d c# : 4 | js : 8 | cocos2d lua : 6，默认 8
  errorType: 'NetworkError',
  errorMsg: '网络请求失败',
  stack: 'at Api.request(Api.js:123)'
})

category 参数说明：

• iOS 平台：必填参数
  • 3 - Cocoa
  • 4 - CSharp
  • 5 - JS（推荐用于 uni-app）
  • 6 - Lua
• Android 平台：选填参数，默认值为 8
  • 4 - u3d c#
  • 8 - js（推荐用于 uni-app，默认值）
  • 6 - cocos2d lua

用户数据

BuglyPro.putUserData('user_id', 'user123')

启动监控

BuglyPro.startSpan('ModuleInit', 'AppLaunch')  // 开始打点
BuglyPro.endSpan('ModuleInit')                  // 结束打点
BuglyPro.addTag('cold_start')                   // 添加标签

参数说明

Android 初始化参数：

• appID、appKey（必填）
• appVersion、buildNumber、userId、uniqueId（可选）
• debugMode（可选，生产环境设为 false）
• enableCrashProtect、enableAllThreadStackAnr、enableAllThreadStackCrash（可选）
• serverHostType（可选，'BuglyPro' 或 'BuglyOversea'）

iOS 初始化参数（仅支持）：

• appID、appKey（必填）
• buildNumber、userId、uniqueId（可选）

注意事项

1. iOS 和 Android 使用不同的 AppID 和 AppKey
2. iOS 只支持 5 个初始化参数
3. 生产环境 Android 请将 debugMode 设为 false
4. 建议在首页加载完成后调用 reportAppFullLaunch()

相关链接

• Bugly 专业版官网
• Android SDK 文档
• iOS SDK 文档

版本

• 1.1.0 - iOS 端完整实现
• 1.0.0 - Android 端初始版本