Cocos平台集成AGC常見問題總結

在Cocos應用中集成AGC性能管理SDK並發布的過程中，曾遇到過一些問題，特此作以下總結：

1. 第一次構建Android工程，可能會遇到沒有NDK的錯誤，具體報錯信息為：[NDK Root] is empty, please set [NDK Root] in Preferences.

原因：Cocos構建時未配置Android NDK路徑以及Android SDK路徑。

解決方案：需要進到Cocos的 文件->設置 目錄，選擇原生開發環境界面，在該界面配置Android SDK路徑以及NDK路徑，如下圖：

上述所需Android SDK和NDK路徑，可在Android Studio中的下圖中位置獲取：

在Android Studio中直接復制粘貼上述兩項配置進Cocos中，配置好以后回到構建界面，此時便可以愉快地進行構建操作了。

注意：部分情況下可能不存在默認NDK目錄，此時可通過Settings中如下圖位置處下載：

2. 打開工程的時候，窗口提示TypeError: Cannot read property 'xxx' of undefined。
   

原因：電腦中同一磁盤下有同名js腳本，不論是否在不同文件夾，可能都會出現此問題。

解決方案：將同名js腳本改名或者忽略該問題。

3. 構建無問題，但是編譯一直報Task :game:externalNativeBuildReleaseFeature錯誤。
   

原因：路徑包含特殊字符，或者路徑過長導致的，如上圖即為路徑過長導致。

解決方案：建議把項目文件夾放在根目錄下並且項目文件名不要包含一些特殊字符，然后刪除build文件夾重試。

除此之外，在驗證的過程中也發現了Cocos文檔的一些錯誤，特此提示廣大開發者：

1. Cocos的官方文檔中，限定了AGC性能管理功能使用手機，實際在華為的性能管理功能中，沒有限定在華為手機上使用，此處描述有誤。
   

2. Cocos官方文檔中，在“添加指定特性網絡請求的監控指標”章節，此處的描述與實際內容不符。
   

欲了解更多詳情，請參見：

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

性能管理開發指導文檔：https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-introduction

---

原文鏈接：https://editor.csdn.net/md?articleId=109021875
作者：鼓樓趙又廷