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)
作者：鼓樓趙又廷

Cocos平臺整合AGC效能管理（二）—— 效能管理SDK整合

相關文章