简介

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

您将建立什么

在本次Codelab中，您将建立一个能够集成崩溃服务的应用，并使用自定义用户标识，自定义日志，自定义键值对来自定义您的崩溃报告，最终通过手工制造一个崩溃事件进行上报，来全面了解崩溃报告信息。

您将会学到什么

开发环境及技能要求

运行终端要求

集成AGC能力，需要完成以下准备工作：

  1. 创建AGC应用
  2. 创建Android Studio工程
  3. 添加应用包名
  4. 配置Maven仓地址及AGC gradle插件
  5. 同步工程
具体操作，请按照《AppGallery Connect集成准备》中详细说明来完成。
  1. 登录AppGallery Connect，点击"我的项目"。
  2. 在项目列表中找到您的项目，在项目下的应用列表中选择您需要启用崩溃服务的应用。
  3. 点击"质量 > 崩溃"，进入崩溃服务页面。

添加当前应用的AppGallery Connect配置文件

  1. 登录 AppGallery Connect 网站，选择"我的项目"。
  2. 在项目列表中找到您的项目，在项目的应用列表中选择您需要集成崩溃服务的应用。
  3. 点击"项目设置"中"应用"栏下的"agconnect-services.json"。
  4. 将"agconnect-services.json"文件拷贝到应用级根目录下。

添加编译依赖

  1. 打开应用级的build.gradle文件，添加如下代码集成Crash SDK和Analytics SDK。 
    dependencies { 
            //配置如下地址 
    implementation 'com.huawei.agconnect:agconnect-crash:1.6.2.300' 
    implementation 'com.huawei.hms:hianalytics:6.3.2.300' 
}
  2. 点击界面上的"Sync Now"同步已经完成的配置。

本次Codelab中您可以在Android Studio工程中创建一个布局页面，参照下图进行UI设计，新增两个Button。一个描述为"makeCrash"，点击后可触发崩溃事件；一个描述为"CustomReport"，点击后可触发自定义报告。

具体页面布局代码如下：

<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 
    android:gravity="center" 
    android:orientation="vertical"> 
 
    <LinearLayout 
        android:layout_width="300dp" 
        android:layout_height="wrap_content" 
        android:gravity="center" 
        android:orientation="vertical"> 
 
        <Button 
            android:id="@+id/btn_crash" 
            android:layout_width="match_parent" 
            android:layout_height="wrap_content" 
            android:textAllCaps="false" 
            android:text="makeCrash" /> 
 
        <Button 
            android:id="@+id/btn_CustomReport" 
            android:layout_width="match_parent" 
            android:layout_height="wrap_content" 
            android:textAllCaps="false" 
            android:text="CustomReport" /> 
 
    </LinearLayout> 
</LinearLayout>
  1. 点击"makeCrash"按钮触发调用AGConnectCrash.testIt方法可以制造一次崩溃。 
    Button btn_crash = findViewById(R.id.btn_crash); 
btn_crash.setOnClickListener(new View.OnClickListener() { 
    @Override 
    public void onClick(View view) { 
        AGConnectCrash.getInstance().testIt(MainActivity.this); 
     } 
});
  2. 点击"CustomReport"按钮触发调用AGConnectCrash.setUserId自定义用户标识，调用AGConnectCrash.log自定义日志，调用AGConnectCrash.setCustomKey自定义键值对。 
    Button btn_CustomReport = findViewById(R.id.btn_CustomReport); 
btn_CustomReport.setOnClickListener(new View.OnClickListener() { 
    @Override 
    public void onClick(View v) { 
        AGConnectCrash.getInstance().setUserId("testuser"); 
        AGConnectCrash.getInstance().log(Log.DEBUG,"set debug log."); 
        AGConnectCrash.getInstance().log(Log.INFO,"set info log."); 
        AGConnectCrash.getInstance().log(Log.WARN,"set warning log."); 
        AGConnectCrash.getInstance().log(Log.ERROR,"set error log."); 
        AGConnectCrash.getInstance().setCustomKey("stringKey", "Hello world"); 
        AGConnectCrash.getInstance().setCustomKey("booleanKey", false); 
        AGConnectCrash.getInstance().setCustomKey("doubleKey", 1.1); 
        AGConnectCrash.getInstance().setCustomKey("floatKey", 1.1f); 
        AGConnectCrash.getInstance().setCustomKey("intKey", 0); 
        AGConnectCrash.getInstance().setCustomKey("longKey", 11L); 
    } 
});
  3. 打包并运行应用程序，先点击"CustomReport" 按钮产生自定义崩溃报告，再点击"makeCrash"按钮触发崩溃上报自定义报告。
  1. 登录AppGallery Connect网站，点击"我的项目"图标，进入您的应用。
  2. 崩溃服务页面中，点击"统计"页签，查看您应用的崩溃统计信息。
  3. 点击"按用户搜索"，可以查看自定义的用户标识。
  4. 点击崩溃问题，可以进入问题详情页面，继续点击"日志"查看自定义的日志信息。
  5. 点击"状态"查看自定义的键值对。

祝贺您，您已经成功地构建了您的第一个集成AGC崩溃服务的应用程序，并学到了如何通过自定义报告功能自定义崩溃信息，同时学会了在AGC崩溃服务页面查看自定义崩溃报告。您也可以根据您的需求自定义其他形式的崩溃报告，然后在AGC上查看。

AGC崩溃服务的相关API介绍请参见API索引。

本Codelab中所用demo源码下载地址如下：源码下载。

Code copied