Cocos平台集成AGC性能管理（二）—— 性能管理SDK集成

在掌握了[如何将Cocos应用发布到华为AppGallery Connect](https://developer.huawei.com/consumer/cn/forum/topicview?fid=0101271690375130218&tid=0203359161844040878&pid=0303359161844040067)（下文简称AGC）后，便可以通过AGC集成性能管理来实现对Cocos应用性能数据的监控。目前性能管理SDK仅支持Android平台，接下来便以此为例体验下接入的过程

### Cocos Creator配置
1. 在Cocos服务面板接入所需的AGC相关服务，此次我们选择性能管理服务并启用。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930110918782.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

2. 点击启用后会跳转到关联界面，在接入相关服务前，需要先关联 App，点击“关联”按钮，在弹出框中选择创建。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930110934418.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

3.  在跳转到的Cocos控制台上，根据个人需要创建一个新游戏。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930110951198.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

4. 创建完成后，就可以回到Cocos Creator界面新建，刷新和选择进行应用的关联。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930111003188.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

### AGC配置
1. 登录AppGallery Connect，找到上一篇文章[Cocos平台集成AGC性能管理（一）—— Cocos应用发布](https://developer.huawei.com/consumer/cn/forum/topicview?fid=0101271690375130218&tid=0203359161844040878&pid=0303359161844040067)中创建的游戏App。

2. 点击“质量-性能管理”，点击右上角“开通服务”开通性能管理服务。
![在这里插入图片描述](https://img-blog.csdnimg.cn/2020093011114665.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

3. 开通服务后，回到项目设置界面，下载最新的工程配置json文件。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930111202768.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

4. 将刚刚下载的json文件，放到Cocos项目的Setting文件夹下。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930111213223.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

### 打包与运行
由于当前华为的性能管理服务，暂时没有JS的SDK，因此想要看到应用的性能数据，需要将应用打包并且安装到Android设备上运行。下面介绍应用的打包与运行相关的操作步骤：

1. 打包当前Cocos应用。在Cocos菜单面板，点击 项目-> 构建发布 –> 选择 HUAWEI AppGallery Connect，配置对应的包名。

**注意：配置的包名，需要和华为AGC控制台的包名保持一致，即和上一个步骤的json文件中的包名保持一致。否则会报编译错误。**
![在这里插入图片描述](https://img-blog.csdnimg.cn/202009301113431.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

2. 构建和编译成功以后，就可以在项目的 \build\jsb-link\publish\android 路径下看到对应的APK文件。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930111355408.png#pic_center)

3. 将该文件安装到Android设备上，可以直接在cmd中使用 adb install –r packageName.apk命令安装。

4. 打开应用，点击相关的按钮，看下是否有对应APMS的日志：有如下日志，表示性能管理服务集成功能啦，之后就可以去AGC界面上查看性能数据啦。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930111410268.png#pic_center)

### 查看应用性能数据
应用运行以后，可以在AGC界面上的“质量 -> 性能管理”页面下，查看应用的性能数据（应用运行后5分钟左右后可以查看）。关于具体每项性能数据的内容，可以参考官方文档：[查看应用性能数据](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-tracking-overview)。
![在这里插入图片描述](https://img-blog.csdnimg.cn/20200930111419690.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

### 性能管理服务功能扩展
华为的AGC性能管理服务，除了基础的应用性能监控功能，还提供了自定义跟踪参数的功能，可以很方便的监控特定场景下的性能情况，如应用登录场景、应用页面长时间无响应场景等。

1. 自定义跟踪参数：

```java
huawei.agc.apms.apmsService.startCustomTrace("traceID");
```

2.  设置自定义跟踪记录属性名称和属性值：

```java
huawei.agc.apms.apmsService.putCustomTraceProperty(traceID, pName, pValue);
```

3. 针对每个网络请求，创建网络请求指标实例，用于采集网络性能数据：

```java
let id = huawei.agc.apms.apmsService.initNetworkMeasure(url, "POST");
console.log("createNetworkMeasure, id = ", id);
```

欲了解更多详情，请参见：

Cocos集成AGC性能管理快速入门：[https://docs.cocos.com/creator/manual/zh/cocos-service/agc-apm.html](https://docs.cocos.com/creator/manual/zh/cocos-service/agc-apm.html)

AGC性能管理开发文档：[https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-introduction](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-introduction)

Cocos平台集成AGC性能管理（一）—— Cocos应用发布：[https://developer.huawei.com/consumer/cn/forum/topicview?fid=0101271690375130218&tid=0203359161844040878&pid=0303359161844040067](https://developer.huawei.com/consumer/cn/forum/topicview?fid=0101271690375130218&tid=0203359161844040878&pid=0303359161844040067)

---
原文链接：[https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203364307861000095&fid=0101271690375130218](https://developer.huawei.com/consumer/cn/forum/topicview?tid=0203364307861000095&fid=0101271690375130218)
作者：鼓楼赵又廷

ITPub博客

Cocos平台集成AGC性能管理（二）—— 性能管理SDK集成

最新文章