【FAQ】整合分析服務的常見問題及解決方案

HMSCore發表於2023-02-23

常見問題一：如何驗證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 最新技術資訊~

相關文章