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

  公司最近開發了一個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

原作者：小魚