13 KiB
性能管理(AGC)
业务介绍
华为AppGallery Connect(简称AGC)的性能管理(APM,App Performance Management)服务提供分钟级应用性能监控能力,您可以在AGC查看和分析APM收集到的应用性能数据,实时全面掌握应用在线的性能表现,帮助您快速修复应用的性能问题,持续提升应用的用户体验。
主要功能
主要功能 |
功能描述 |
---|---|
自动收集有关应用程序启动,应用程序屏幕渲染和HTTP/HTTPS网络请求的性能数据。 | APM SDK自动收集有关应用程序启动,应用程序屏幕渲染和HTTP / HTTPS网络请求的关键性能数据。 1.应用启动:冷启动和暖启动模式下的应用启动时间。 2. 应用程序屏幕渲染:应用程序屏幕渲染期间慢帧和冻结帧的数量。 3. HTTP / HTTPS网络请求:诸如响应持续时间,成功率和响应大小之类的指标。 |
支持查看和分析应用性能数据,快速发现应用性能瓶颈。 | APM通过多个维度(版本号、国家/地区、设备型号、一级区域、系统版本、运营商和网络等)向您展示应用的性能表现,帮助您快速了解应用在哪些方面可优化改进。 |
支持创建自定义跟踪记录,监控应用在特定场景下的性能。 | 借助APM SDK,您可以: 1.创建自定义跟踪记录来监控应用在自定义场景(如用户登录和场景加载)下的性能。 为自定义跟踪记录添加指标(如登录次数)和属性(如登录是否成功)。 |
Unity项目设置
1. 集成AGC SDK
集成APM SDK前,请确认您的应用已集成AGC SDK和AGC插件,详细步骤请参考AppGallery Connect服务使用入门。
注意:
-
拷贝
agconnect-services.json
文件到Assets/Plugins/Android/
目录中 -
在
Assets/Plugins/Android/
目录中打开launcherTemplate.gradle
。在
apply plugin: 'com.android.application'
下面添加以下信息:apply plugin: 'com.android.application’ apply plugin: 'com.huawei.agconnect'
构建依赖关系:
dependencies { implementation 'com.huawei.agconnect:agconnect-core:1.4.2.302' }
-
在
Assets/Plugins/Android/
目录中打开baseProjectTemplate.gradle
文件添加以下配置:
allprojects { repositories { google() jcenter() maven {url 'https://developer.huawei.com/repo/'} } } buildscript { repositories { google() jcenter() maven {url 'https://developer.huawei.com/repo/'} } } buildscript { dependencies { classpath 'com.huawei.agconnect:agcp:1.4.2.301' } }
2. 集成APM SDK
步骤请参考 集成APM SDK
集成APM SDK后,APM SDK将自动采集应用的启动性能数据、屏幕性能数据。
将APM SDK依赖项添加到launcherTemplate.gradle
文件中(通常在app目录中)。
dependencies {
// ...
// Add APM SDK library dependency
implementation 'com.huawei.agconnect:agconnect-apms:1.5.2.305'
implementation 'com.huawei.agconnect:agconnect-apms-game:1.5.2.303'
}
3. 集成APM插件
步骤请参考 集成APM插件
APM插件利用检测(instrumentation)技术,实现HTTP/HTTPS网络请求性能数据的无侵入采集。请按如下步骤将APM插件添加到您的应用:
-
将APM插件添加到
launcherTemplate.gradle
文件中。apply plugin: 'com.android.application' // Apply the AGC plugin apply plugin: 'com.huawei.agconnect' agcp { enableAPMS true } dependencies { // .. }
-
将APM插件添加到
baseProjectTemplate.gradle
文件中。buildscript { repositories { // Add the maven repository maven { url 'https://developer.huawei.com/repo/' } } dependencies { // ... // To benefit from the latest APM feaures, update your Android Gradle Plugin dependency to at least v3.3.2 classpath 'com.android.tools.build:gradle:3.3.2' // Add the dependency for the APM plugin } }
4.集成APM Game SDK(可选)
将APM Game SDK依赖项添加到launcherTemplate.gradle
文件中(通常在app目录中)。
dependencies {
// ...
// Add APM SDK library dependency
implementation 'com.huawei.agconnect:agconnect-apms:1.5.2.305'
implementation 'com.huawei.agconnect:agconnect-apms-game:1.5.2.303'
}
SDK集成开发
查看性能监控数据
请参考查看性能监控数据
可选:使用APM
(注意:目前此功能只能应用于主程序集,若用户代码在自定义程序集中则无法解析)
4、查看调试日志
可选:使用APM Game SDK
在游戏开始时的初始化方法中,调用APMS的startGamePlugin()方法来启用该SDK。
void Start()
{
// In order to start APMS Game Plugin, you need to call this method
GameAPM.getInstance().start();
// Your own business code
// ...
}
void OnDestroy() {
// In order to start APMS Game Plugin, you need to call this method
GameAPM.getInstance().stop();
// Your own business code
// ...
}
为了能够快速发现场景加载时间是否超过正常范围,可以调用APMS的 startLoadingScene(GameAttribue gameAttribute) 和 stopLoadingScene(String scene) 来记录场景加载时间。
public void scenceLoadToGame()
{
// start record the loading scene time
String scene = GameAPM.getInstance().startLoadingScene(new GameAttribute("Game", LoadingState.NOT_LOADING));
SceneManager.LoadScene("Game");
// Other code
// ...
// stop record the loading scene time
GameAPM.getInstance().stopLoadingScene(scene);
}
前提条件
- 您的应用已启用APM服务。
- 您的应用已集成APM Game SDK,并在设备上运行。
查看游戏场景分析
- 登录AppGallery Connect网站,点击“我的项目”。
- 在项目列表中找到您的项目,在项目下的应用列表中选择需要查看的应用。
- 选择“质量 > 性能管理”,进入“应用性能管理”页面。
- 点击“体验分析->游戏场景分析",进入游戏场景分析页面。
更多详细信息,请参阅本文档的附录。
设置场景
-
新建一个场景
-
右键单击并选择UI,然后选择button:
-
将Component添加到button并开发脚本:
-
编辑脚本:
双击脚本文件,然后您将在VS code中打开它
-
定义接口
void Start() { } // Update is called once per frame void Update() { } public void CustomTraceMeasureTest(CustomTrace customTrace) { UnityEngine.Debug.Log("CustomTraceMeasureTest start"); customTrace.putMeasure("ProcessingTimes", 0); for (int i = 0; i < 100; i++) { customTrace.incrementMeasure("ProcessingTimes", 1); } long value = customTrace.getMeasure("ProcessingTimes"); Debug.Log("Measurename: ProcessingTimes, value: "+ value); UnityEngine.Debug.Log("CustomTraceMeasureTest success"); }
创建函数
-
绑定脚本中的按钮和界面
演示项目
如何使用演示项目?
-
步骤1:从以下位置创建repo:https://github.com/Unity-Technologies/unity-hms_sdk/tree/apm 并checkout到“apm”分支。
-
步骤2:从远程项目中替换
agconnect-services.json
文件并配置gradle文件,请参阅第2部分,步骤1至步骤3。 -
步骤3:打开Unity Hub,添加HuaweiServiceDemo项目(Unity版本2019.3)。
-
步骤4:将平台切换到Android并打开性能测试场景:
Assets / HuaweiHmsDemo / HmsPerformanceSampleTest
如果有以下的编译错误:
Microsoft (R) Visual C# Compiler version 2.9.1.65535 (9d34608e)
Copyright (C) Microsoft Corporation. All rights reserved.
error CS0009: Metadata file '/Users/yanmeng/Desktop/unity_agc_new/unity-hms_sdk/hmsDemo/Library/ScriptAssemblies/Unity.Timeline.Editor.dll' could not be opened -- Image is too small.
Assets/HuaweiHms/src/hms/Wrapper/fundation/HmsClass.cs(72,25): warning CS0693: Type parameter 'T' has the same name as the type parameter from outer type 'HmsClass<T>'
尝试重新打开项目,总是能解决此问题。
-
步骤5:在 Build Settings -> Android -> PlayerSettings-> Publish Settings 中设置Android build keystore。如下所示。 hhmm的密码为123456。
-
步骤6:构建android apk并在Android设备上运行。使用logcat检查测试用例是否成功执行。
附录
APM Game Plugin 数据安全说明
工作方式
- APM Game Plugin随应用打包,在用户启动应用时开始工作,并自动采集应用性能数据。当用户关闭应用时,Plugin会停止采集应用性能数据。
权限说明
- 无
收集数据
-
基础数据属性
-
应用基础属性:应用名称、应用版本名称、应用版本号、应用包名(应用ID)。
-
设备基础属性:设备厂商、设备架构、设备型号、屏幕大小、分辨率、屏幕类型(超大、大、中、小、未知)、屏幕刷新频率、CPU型号、CPU核数、内存大小、磁盘大小、用户CPU时长、系统CPU时长、最大堆内存、已用堆内存。
-
平台基础属性:操作系统名称、操作系统版本、ROM名称、ROM版本、APM SDK版本、AAID、AGC cpID、AGC productID、AGC ClientID、AGC AppID。
-
运行时基础属性:充电状态、电量大小、网络类型、屏幕方向、应用前后台状态、APM SDK会话ID、可用磁盘空间、应用内存使用量。
-
用户设置属性:默认时区设置、默认语言设置、DNS设置。
-
自定义跟踪记录属性:开发者设置的自定义属性。
-
-
指标数据
-
帧率数据:场景名称、加载状态、帧速率数量。
-
加载数据:场景名称、加载状态、加载时长。
-
-
数据安全保护
-
APM Game Plugin对采集数据进行本地加密,加密后的数据通过HTTPS安全协议传输至APM服务器。
-
华为严格遵循《一般数据保护条例》(GDPR) ,华为也致力于帮助开发者在遵循GDPR规定的前提下取得成功。GDPR规定了数据控制者和数据处理者的义务,使用该服务时,开发者扮演着“数据控制者”的角色,而华为是“数据处理者”。数据处于开发者的控制之下,华为只在“数据处理者”义务和权利范围内处理数据,而开发者有责任遵循GDPR规定,承担“数据控制者“的义务。
-