腾讯 Bugly 免费接入教程：实时崩溃监控 + 卡顿分析提升应用稳定性

AI Insight 专栏作者

2025-06-24

6.8k 阅读

76 评论

? 腾讯 Bugly 免费接入教程：实时崩溃监控 + 卡顿分析提升应用稳定性

在移动应用开发中，稳定性是用户留存的关键。腾讯 Bugly 作为一款免费的质量监控工具，能帮你实时捕捉崩溃、分析卡顿，让应用更稳定。

? 一、注册与创建应用

先到 Bugly 官网注册账号，登录后点击「创建应用」。填写应用名称、选择平台（如 Android/iOS）、输入包名等信息，完成后会生成 AppID 和 AppKey，这是接入的关键凭证。

? 二、Android 平台接入步骤

1. 添加依赖

在项目的 build.gradle 中添加：

gradle

dependencies {
    implementation 'com.tencent.bugly:crashreport:latest.release' // 崩溃监控
    implementation 'com.tencent.bugly:nativecrashreport:latest.release' // 原生崩溃监控
}

同步后，SDK 就集成到项目里了。

2. 权限配置

在 AndroidManifest.xml 中加入必要权限：

xml

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

确保应用能联网上报数据。

3. 初始化 SDK

在 Application 类的 onCreate 方法中初始化：

java

CrashReport.initCrashReport(getApplicationContext(), "你的 AppID", false);

第三个参数设为 true 时，测试阶段会输出详细日志，发布时记得改为 false。

4. 多渠道打包处理

若需区分渠道，可在 build.gradle 中配置 productFlavors，并在初始化时设置渠道号：

java

UserStrategy strategy = new UserStrategy(context);
strategy.setAppChannel("渠道名");
CrashReport.initCrashReport(context, "AppID", false, strategy);

? 三、iOS 平台接入步骤

1. 使用 CocoaPods 集成

在 Podfile 中添加：

ruby

pod 'Bugly'

执行 pod install 后，用 .xcworkspace 文件打开项目。

2. 初始化 SDK

在 AppDelegate 的 didFinishLaunchingWithOptions 方法中：

objective-c

#import 

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [Bugly startWithAppId:@"你的 AppID"];
    return YES;
}

3. 符号化配置

上传 .dSYM 文件到 Bugly 控制台，才能解析崩溃堆栈。在 Xcode 中，生成 .dSYM 后，通过控制台的「符号表管理」上传。

? 四、实时崩溃监控

接入后，应用崩溃时会自动上报。登录 Bugly 控制台，进入「崩溃分析」页面，能看到崩溃趋势、Top 崩溃列表。点击具体崩溃，可查看堆栈信息、设备型号、操作系统版本等，快速定位问题。

1. 自定义崩溃上报

若想手动上报异常，可调用：

java

// Android
CrashReport.postCatchedException(exception);

// iOS
[Bugly reportError:error];

2. 崩溃报警设置

在控制台的「设置」-「报警规则」中，可设置崩溃率阈值。当崩溃率超过阈值时，会通过邮件或微信通知你。

? 五、卡顿分析

1. 开启卡顿监控

在初始化时配置：

java

// Android
UserStrategy strategy = new UserStrategy(context);
strategy.setEnableBlockMonitor(true); // 开启卡顿监控
CrashReport.initCrashReport(context, "AppID", false, strategy);

// iOS
[Bugly setEnableBlockMonitor:YES];