手把手教你接入華爲分析的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

原做者：小魚