公司最近開發了一個Android版手遊應用，想了解一下上線以來玩家充值情況，就讓我接入華為分析的Android SDK。今天我就來給大家分享一下如何將Analytics Kit新增到安卓應用中去。本文是基於Android平臺，關於iOS應用接入華為分析服務SDK的方法，可以參考：接入華為分析的iOS SDK。我接入的版本是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服務開通。

整合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

原作者：小魚