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
作者：鼓楼赵又廷