文档开发者中心
我的

Unity平台 | 零代码快速集成AGC崩溃服务

Unity环境准备:

官方文档:

https://docs.unity.cn/cn/Packages-cn/com.unity.hms@1.3/manual/crash.html

1、  下载Unity Hub,安装Unity

https://unity.cn/releases。

2、  Android环境配置,可参考如下截图:

在Edit-Preferences-External Tools-Android配置JDK,SDK安装路径(用默认路径即可)

在Edit-Project Settings-Player-Publish Setting中启用Android的自定义清单和gradle

 

3、  导入HuaweiServices的Package包:

在unity asset Store中下载huaweiservice的package包:

https://assetstore.unity.com/packages/add-ons/services/huawei-hms-agc-services-176968#content

 

下载到本地以后,在Unity中点击assets – Import package

然后,然后选择需要的包(如果不知道哪个包,建议全选),点击Import即可

 

AGC环境配置

1、  配置华为AGC上的参数:回到AGC控制台:找到之前创建的App:

https://developer.huawei.com/consumer/cn/service/josp/agc/index.html

3、  选择:我的项目-> 质量 – 崩溃 点击开通,开通崩溃服务

4、  服务开通以后,回到项目设置界面,下载最新的json文件。

5、  将刚下载好json文件,放到Unity项目Assets / Plugins / Android目录下

如果没有相关路径,需要配置build选项:

设置Android环境:

1.      配置包名:注意需要和AG官网的包名保持一致:

2.         配置项目级gradle,此处对应Assets\Plugins\Android路径下的baseProjectTmeplate.gradle文件,添加如下内容

    allprojects {
        buildscript {
            repositories {
             maven { url 'https://developer.huawei.com/repo/' }
            }
 
        dependencies {
            classpath 'com.android.tools.build:gradle:3.6.0'
                                                classpath 'com.huawei.agconnect:agcp:1.4.2.300'
        }
        }
        repositories {
 
            maven { url 'https://developer.huawei.com/repo/' }
        }
    }


3.      配置应用级gradle,此处对应Assets\Plugins\Android路径下的LauncherTmeplate.gradle文件,添加如下内容:

apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect' 
   
dependencies {
    implementation 'com.huawei.hms:hianalytics:5.0.5.300'
implementation 'com.huawei.agconnect:agconnect-crash:1.4.2.300'
}

 

集成Crash功能

1. 点击GameObject- UI –Button,创建一个按钮:点击按钮,然后在右侧选择 Add Component, 创建并且添加一个Script文件testcrash,并且添加如下方法:

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using HuaweiService;
using HuaweiService.crash;

public class testcrash : MonoBehaviour
{
    // Start is called before the first frame update
    void Start()
    {
        
    }
 
    // Update is called once per frame
    void Update()
    {
        
    }
 
    public void CrashCollectON()
       {   
            AGConnectCrash.getInstance().enableCrashCollection(true);
        }
    public void CrashCollectOFF()
        {
            AGConnectCrash.getInstance().enableCrashCollection(false);
        }
 
    public void SetTestIt()
        {
            Application.ForceCrash(0);
        }
 
    public void SetUserId()
        {
           AGConnectCrash.getInstance().setUserId("TestUser");
        }
        
    public void SetCustomKey()
        {
          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);
        }
 
    public void SetDefaultlog()
        {
            AGConnectCrash.getInstance().log("set default log");
 
        }
    public void Setlog()
        {
            AGConnectCrash.getInstance().log(3, "set debug log");
            AGConnectCrash.getInstance().log(4, "set info log");
            AGConnectCrash.getInstance().log(5, "set warning log");
            AGConnectCrash.getInstance().log(6, "set error log");
        }
 
}

   

继续创建其他按钮,关联对应的方法。如下:                                                                              

 

按钮/方法

 
 

事件

 
 

CrashCollectON

 
 

开启崩溃信息上报

 
 

CrashCollectOFF

 
 

关闭崩溃信息上报

 
 

SetTestIt

 
 

制造一个崩溃事件

 
 

SetCustomKey

 
 

自定义键值对

 
 

SetDefaultlog

 
 

默认日志级别

 
 

Setlog

 
 

自定义日志级别

 
 

SetUser

 
 

自定义用户标识

 

 

2. 打包成Android,并且查看对应的创建是否成功

测试接口并查看崩溃报告

1、  打开应用,依次点击CrashCollectON,SetUser,Setlog,SetDefaultlog,SetTestIt后重新打开应用

2、  登录AGC网站,选择:我的项目-> 质量 – 崩溃 查看崩溃报告

崩溃概览:

堆栈详情:

自定义日志:

自定义键值对:

自定义用户标识:

Mapping文件生成和上传

1、  开启混淆配置

 

创建proguard-unity.txt和proguard-user.txt文件,添加如下内容排查混淆:

-keepattributes *Annotation*
-keepattributes SourceFile,LineNumberTable
-keep public com.crashlytics.** { *; }

 

生成APK包时会自动生成对应的mapping文件,之后在AGC页面上传即可。

如果需要使用Android Studio 项目 gradle 自动上传工程,也可以导出工程按照如下操作:

 

2、  配置混淆mapping上传开关

配置应用级gradle,此处对应Assets\Plugins\Android路径下的LauncherTmeplate.gradle文件,添加如下内容:

apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
 
agcp{ 
    mappingUpload = true 
    debug = true
    appVersion = '0.1' 
}
dependencies {
implementation 'com.huawei.hms:hianalytics:5.0.5.300'
implementation 'com.huawei.agconnect:agconnect-crash:1.4.2.300'
}

 

3、  导出unity工程,便于Android Studio打开

 

未上传时:

4、  生成mapping文件并自动上传

执行gradle clean assembleRelease 或者直接通过Android Studio 安装应用,成功生成mapping文件:

上传成功:

AGC页面查看:

混淆报告还原

未上传混淆的mapping文件时崩溃报告如下:

 

 

上传mapping文件还原后:

 

欲了解更多详情,请参考:

崩溃Demo:https://github.com/AppGalleryConnect/agc-demos/tree/main/Android/agc-crash-demo-java


点赞
收藏
回复
分享
举报
浏览1006 编辑于2021-01-20 08:26未知归属地
全部评论
最多点赞
最新发布
最早发布
暂无评论
暂无评论
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

目录 收起
AGC环境配置
设置Android环境:
集成Crash功能
测试接口并查看崩溃报告
Mapping文件生成和上传
混淆报告还原
AGC应用质量提升实验室
01

零代码快速集成AGC崩溃服务-HarmonyOS平台

02

零代码快速集成AGC崩溃服务-xamarin框架-iOS

03

零代码快速集成AGC崩溃服务-xamarin框架-Android

04

快速集成华为AGC性能管理服务-iOS

05

Unity平台 | 零代码快速集成AGC崩溃服务

06

真机调试设备不够?华为AGConnect云调试帮你忙

07

Unity平台 | 快速集成华为性能管理服务

08

React Native | 零代码快速集成AGC崩溃服务

09

Cocos平台 | 零代码快速集成AGC崩溃服务

10

Cordova平台 | 零代码快速集成AGC崩溃服务

11

iOS | 零代码快速集成AGC崩溃服务

12

Android | 零代码快速集成AGC崩溃服务

13

Android ANR全解析&华为AGC性能管理解决ANR案例集

14

Android平台零代码快速集成AGC性能管理服务

了解社区公约,与您携手共创和谐专业的开发者社区。