HarmonyOS鸿蒙Next集成华为AGC崩溃服务实用教程

HarmonyOS鸿蒙Next集成华为AGC崩溃服务实用教程

简介

AppGallery Connect（简称AGC）崩溃服务提供了轻量级崩溃分析服务，集成Crash SDK，可以实现零代码快速集成，您的应用能够在崩溃时自动收集崩溃报告，帮助您了解应用版本质量、对崩溃性问题进行快速跟踪定位、评估崩溃问题的影响范围等。

开通服务和集成SDK

  1. 登录AppGallery Connect，点击“我的项目”，在项目的应用列表中选择需要开通崩溃的应用。
  2. 在导航选择“质量 > 崩溃”。如果是首次使用崩溃服务，请点击“启动分析服务”开通服务。
  3. 选择常规页签下的“应用”区域，下载agconnect-services.plist配置文件。
  4. 打开命令行窗口，导航至Xcode项目所在的位置，创建Podfile文件。如果已经存在，可跳过本步骤。
cd project-directory 
pod init
  1. 编辑Podfile文件，增加pod依赖pod 'AGConnectCrash'。
target 'AGC-Crash-1' do 
  pod 'AGConnectCrash' 
end
  1. 执行pod install，然后打开xcworkspace文件查看该项目。
pod install

安装成功效果如下图。

界面设计

本次Codelab中您可以在您的iOS工程中创建一个布局页面，参照下图进行UI设计，新增一个按钮触发崩溃。

功能开发

  1. 在应用的AppDelegate类中引入AGConnectCore库，并在didFinishLaunchingWithOptions方法里调用AGCInstance.startUp进行初始化。
import AGConnectCore 

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { 
  AGCInstance.startUp() 
  return true 
}
  1. 调用制造崩溃的方法makeCrash。
@objc func makeCrash() { 
  AGCCrash.sharedInstance().testIt() 
}

打包测试

  1. 在Xcode上点击运行按钮，在手机或模拟器上运行应用。
  2. 崩溃收集功能在Xcode调试状态下不会开启，因此您在测试应用程序的崩溃收集功能时，需要先停止Xcode调试，再打开应用程序点击“Make Crash”。

崩溃收集功能在Xcode调试状态下不会开启，因此您在测试应用程序的崩溃收集功能时，需要先停止Xcode调试，再打开应用程序点击“Make Crash”。

  1. 在发生崩溃后，确保网络连接正常，重新打开应用，在AGC中查看对应的崩溃信息。

崩溃报告查看

  1. 登录AppGallery Connect，点击“我的项目”，在应用列表中选择您的应用。

  2. 在崩溃服务页面中，点击“统计”页签，查看您应用的崩溃统计信息。

  3. 确认有崩溃信息上报后，您可以点击“问题”页签，找到您应用的崩溃问题，如下“NSRangeException”即为本次测试崩溃时制造的崩溃问题。

  4. 点击崩溃问题，可以进入问题详情页面，在“堆栈”信息中，您可以大致了解发生崩溃的原因，以帮助您对崩溃进行分析。

恭喜您

祝贺您，您已经成功地构建了您的第一个集成AGC崩溃服务的应用程序，并学到了如何在AGC控制台对崩溃信息和自定义报告进行查看和分析。您也可以制造不同类型的崩溃，在AGC控制台上查看崩溃信息。

参考文档

https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-References/agconnectcrash


更多关于HarmonyOS鸿蒙Next集成华为AGC崩溃服务实用教程的实战教程也可以访问 https://www.itying.com/category-93-b0.html

2 回复

HarmonyOS鸿蒙Next集成华为AGC（AppGallery Connect）崩溃服务，主要目的是帮助开发者实时监控应用崩溃情况，提升应用稳定性。以下是集成步骤：

  1. 创建项目：在华为开发者联盟创建HarmonyOS应用项目，获取agconnect-services.json配置文件。

  2. 配置依赖：在工程的build.gradle文件中添加AGC崩溃服务的依赖：

    dependencies {
    implementation 'com.huawei.agconnect:agconnect-crash:1.x.x'
}

  3. 初始化服务：在应用启动时（如AbilityPackage的onInitialize方法中）初始化AGC崩溃服务：

    import com.huawei.agconnect.crash.AGConnectCrash;
public class MyApplication extends AbilityPackage {
    @Override
    public void onInitialize() {
        super.onInitialize();
        AGConnectCrash.getInstance().enableCrashCollection(true);
    }
}

  4. 测试崩溃：在代码中手动触发崩溃以测试服务是否正常工作：

    throw new RuntimeException("Test Crash");

  5. 查看报告：登录华为AppGallery Connect控制台，查看崩溃报告和分析数据。

通过以上步骤，开发者可以成功集成AGC崩溃服务，实时监控应用崩溃情况，提升应用稳定性。

更多关于HarmonyOS鸿蒙Next集成华为AGC崩溃服务实用教程的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


要在HarmonyOS鸿蒙Next中集成华为AGC（AppGallery Connect）崩溃服务，首先在AGC控制台创建项目并启用崩溃服务。然后在开发环境中，通过HPM（HarmonyOS Package Manager）安装@ohos/agconnect-crash依赖。在应用的entry模块的build.gradle中添加AGC SDK依赖，并在config.json中配置AGC服务。最后，在应用启动时初始化崩溃服务，即可实时监控和收集应用崩溃日志，提升应用稳定性。

回到顶部