手把手教你接入華為分析的Android SDK

公司最近開發了一個Android版手遊應用，想了解一下上線以來玩家充值情況，就讓我接入華為分析的Android SDK。今天我就來給大家分享一下如何將Analytics Kit新增到安卓應用中去。本文是基於Android平臺，關於iOS應用接入華為分析服務SDK的方法，可以參考：[接入華為分析的iOS SDK](https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201279699683240256&fid=18)。我接入的版本是5.0.0.301。

當我們開始接SDK時，我們要注意以下兩個方面：

 1. 參考華為開發者聯盟最新的SDK接入文件，並注意你接入的SDK版本

 2. 不要遺漏文件中需要複製的程式碼細節

具體步驟包括：

 1. 配置AppGallery Connect

 2. 整合HMS Core SDK

 3. 接入Analytics

1 配置AppGallery Connect

請按照如下步驟為你的安卓應用配置AppGallery Connect。如果你的應用同時擁有Android和iOS版本，你可以將兩個應用放在同一個專案內，後續可以靈活切換，以對全量使用者做跨平臺、跨裝置的統一資料分析。

（一）開發前準備

 1. 為你的安卓應用準備好包名（向開發人員詢問）。

 2. 登入 [AppGallery Connect網站 並建立一個新專案。

專案建立好後，你會進入一個頁面，左側導航欄展示了AGC的多種功能選單。

 3. 點選“新增應用“按鈕，在專案下建立Android應用。

點選確定後會直接進入到“設定SDK”的引導頁面中，我建議大家先去檢查並確保已經完成高階分析服務的開通。

（二）開通華為分析服務

點選“API管理“，看到Analystics Kit已預設開啟。

回到左側導航欄，轉到“**華為分析**”，你將看到各種資料包告，包括使用者分析、行為分析、受眾分析等，點選任意選單即可開通分析服務。

然後進入“**專案接入設定**”頁面，設定資料儲存位置、時區、貨幣、設定使用者資料留存時間、設定自然周定義後，單擊“完成”，即完成Analytics Kit服務開通。

2 整合HMS Core SDK

點選“新增SDK”，即可回到引導頁面，按照步驟操作即可。

第一步：新增AppGallery Connect配置檔案

a)     下載配置檔案“agconnect-services.json”

b)     將“agconnect-services.json”檔案複製到應用級根目錄下

第二步：新增SDK

在Gradle檔案中設定AppGallery Connect的Gradle外掛以及AppGallery Connect SDK基礎包。

a) 設定專案級build.gradle

allprojects {  

    repositories {  

            //Add Maven  

            maven {url 'http://developer.huawei.com/repo/'}  

    }  

}  

...  

buildscript{  

    repositories {  

        //Add Maven  

        maven { url 'http://developer.huawei.com/repo/' }  

    }  

    dependencies {  

        // Add this line  

        classpath 'com.huawei.agconnect:agcp:1.1.1.300'  

    }  

}

b) 設定模組級build.gradle

dependencies {  

    // Add this line  

    implementation 'com.huawei.agconnect:agconnect-core:1.0.0.300'  

}  

...  

// Add to the bottom of the file  

apply plugin: 'com.huawei.agconnect'

 c)單擊“Sync now”或“Sync Project with Gradle Files”，開始構建工程。

接入Analytics

 1. 在你的應用中初始化Analytics SDK

 最後一步是在你的應用中新增初始化程式碼。透過 getInstance 介面SDK根據配置完成初始化。

 

 2. 透過 onEvent 介面記錄定義事件。

如果你不確定如何標記事件，請檢視事件說明

 3. 參考“API說明”，呼叫介面實現各類功能。

 另外，在開發過程中，推薦啟用除錯模式，藉助華為分析的應用除錯功能，可以實時檢視事件的上報情況，觀察上報結果並做調測。

開啟/停用除錯模式

 1. 開啟除錯模式：在Android裝置上執行如下命令列，開啟除錯模式。除錯模式開啟後會保持啟用狀態，所有事件將實時上報。

adb shell setprop debug.huawei.hms.analytics.app package_name

 2. 停用除錯模式：您可執行如下命令列，停用除錯模式：

adb shell setprop debug.huawei.hms.analytics.app .none.

資料成功上報後，華為分析的應用除錯介面會展示出資料，如下圖：

更詳細的開發指南參考華為開發者聯盟官網：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050040566

---

原文連結：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201296913629300024&fid=18