【FAQ】集成分析服务的常见问题及解决方案

常见问题一：如何验证 Analytics 是否上报/接入成功？以及关键日志含义是什么？

1. 在初始化 Analytics SDK 前添加 SDK 日志开关如下：

HiAnalyticsTools.enableLog ();

2.初始化 SDK 代码如下：

HiAnalyticsInstance instance = HiAnalytics.getInstance (this);

3.运行应用通过过滤日志检查是否有成功上报的关键日志.。

未上报/接入成功：

日志中会出现错误码部分日志可能是红色提示，请参见SDK错误码、集成调测类问题查看是否有相关解决方案。

成功上报关键日志如下：

HiAnalyticsSDK: SendMission=> events PostRequest sendevent TYPE : oper, TAG : _openness_config_tag, resultCode: 200 ,reqID:xxx

开启应用调试每上报一次会出现如下日志：

HiAnalyticsSDK: DeviceToolsKit=> debugMode enabled.

应用调试不支持上报某事件会出现如下提示：

HiAnalyticsSDK: ReportRingback=> do not enable APIEvt in debug model

常见问题二：初始化 SDK 时报错“client token request miss client id”怎么办？

【报错信息】

HiAnalyticsSDK: TokenAssignment=> SE-003|get token exception on the AGC! java.lang.IllegalArgumentException: client token request miss client id, please check whether the 'agconnect-services.json' is configured correctly

【问题根因】

在“项目设置”页面中，“应用”栏下的“agconnect-services.json”配置文件右侧的“不包含密钥”开关被打开了，配置文件中去除了 Client 密钥、API Key 等密钥，但未自行调用 AGC SDK 的接口手动配置密钥信息。

【解决方案】

在下载“agconnect-services.json”文件前，若打开了“不包含密钥”开关。需由自行调用 AGC SDK 的接口手动配置密钥信息，请参见设置配置文件参数。

常见问题三：初始化 SDK 时报错“CE-001”“SE-001”怎么办？

【报错信息】

HiAnalyticsSDK: jsonParses=> CE-001|Cannot find productId from agconnect-services.json

HiAnalyticsSDK: InitTask=> SE-001|_openness_config_tag instance config init failed!. param error config params is error

【问题根因】

集成 SDK 配置参数不对，可能有如下原因：

1. agconnect-services.json 文件位置不对。

2. agconnect-services.json 文件不全尤其是 productId。

3. 应用 build.gradle 未添加 apply plugin: ‘com.huawei.agconnect’或未在 plugins 中添加 id 'com.huawei.agconnect'。

注意：com.huawei.agconnect 配置需要放到 com.android.application 下面，最好是下一行，否则也会报错。

【解决方案】

1. 将 agconnect-services.json 文件放置制定位置。

2. 重新在 AGC 上下载 agconnect-services.json 文件并替换。

3. 添加 com.huawei.agconnect 配置或放置指定位置下。

可参考官网检查配置，请参见集成SDK。

了解更多详情>>

访问华为开发者联盟官网

获取开发指导文档

华为移动服务开源仓库地址：GitHub、Gitee

关注我们，第一时间了解 HMS Core 最新技术资讯~