当前位置：首页 > news >正文

Android Kotlin 项目完整集成 Bugly 异常监控指南

news 来源：原创 2025/5/2 5:47:13

Android Kotlin 项目集成 Bugly 异常监控完整指南

一、Bugly 简介

Bugly 是腾讯提供的专业移动应用异常监控平台，支持：

崩溃报告（Java/Native）
错误分析
性能监控
热更新功能（需额外配置）

二、集成步骤

1. 添加 Gradle 依赖

在 app/build.gradle 中添加：

dependencies {// 必需 - 异常上报核心库implementation 'com.tencent.bugly:crashreport:4.1.9'// 可选 - Native 异常上报implementation 'com.tencent.bugly:nativecrashreport:3.9.2'// 可选 - 热更新支持implementation 'com.tencent.bugly:tinker-support:1.4.3'
}

2. 配置 AndroidManifest.xml

<!-- 必需权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 可选权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_LOGS" />

3. 初始化 Bugly

创建 Application 类：

class App : Application() {override fun onCreate() {super.onCreate()initBugly()}private fun initBugly() {val strategy = CrashReport.UserStrategy(this).apply {appVersion = BuildConfig.VERSION_NAME     // 版本号appPackageName = BuildConfig.APPLICATION_ID // 包名uploadProcess = true // 上报进程信息}Bugly.init(this, "YOUR_APP_ID", BuildConfig.DEBUG, strategy)}
}

记得在 AndroidManifest.xml 中注册 Application：

<applicationandroid:name=".App"... >
</application>

三、高级配置

1. NDK 支持配置

android {defaultConfig {ndk {// 设置支持的 SO 库架构abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'}}
}

2. 混淆配置

在 proguard-rules.pro 中添加：

# Bugly 混淆规则
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}

四、使用示例

1. 手动上报异常

try {// 可能出错的代码
} catch (e: Exception) {CrashReport.postCatchedException(e)
}

2. 自定义日志

BuglyLog.v("TAG", "Verbose日志")
BuglyLog.d("TAG", "Debug日志")
BuglyLog.e("TAG", "Error日志")

3. 设置用户信息

// 设置用户ID
Bugly.setUserId("user123")// 设置用户标签
Bugly.setUserTag(1001)// 添加自定义数据
Bugly.putUserData(this, "VIP_LEVEL", "3")

五、测试验证

// 测试Java崩溃
fun testJavaCrash(view: View) {CrashReport.testJavaCrash()
}// 测试Native崩溃（需集成NDK）
fun testNativeCrash(view: View) {CrashReport.testNativeCrash()
}