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

公司最近開發(fā)了一個(gè)Android版手游應(yīng)用，想了解一下上線以來玩家充值情況，就讓我接入華為分析的Android SDK。今天我就來給大家分享一下如何將Analytics Kit添加到安卓應(yīng)用中去。本文是基于Android平臺(tái)，關(guān)于iOS應(yīng)用接入華為分析服務(wù)SDK的方法，可以參考：接入華為分析的iOS SDK。我接入的版本是5.0.0.301。

當(dāng)我們開始接SDK時(shí)，我們要注意以下兩個(gè)方面：

1.參考華為開發(fā)者聯(lián)盟最新的SDK接入文檔，并注意你接入的SDK版本

2.不要遺漏文檔中需要復(fù)制的代碼細(xì)節(jié)

具體步驟包括：

配置AppGallery Connect

集成HMS Core SDK

接入Analytics

配置AppGallery Connect

請(qǐng)按照如下步驟為你的安卓應(yīng)用配置AppGallery Connect。如果你的應(yīng)用同時(shí)擁有Android和iOS版本，你可以將兩個(gè)應(yīng)用放在同一個(gè)項(xiàng)目內(nèi)，后續(xù)可以靈活切換，以對(duì)全量用戶做跨平臺(tái)、跨設(shè)備的統(tǒng)一數(shù)據(jù)分析。

（一）開發(fā)前準(zhǔn)備

1.為你的安卓應(yīng)用準(zhǔn)備好包名（向開發(fā)人員詢問）。

2.登錄AppGallery Connect網(wǎng)站并創(chuàng)建一個(gè)新項(xiàng)目。

項(xiàng)目創(chuàng)建好后，你會(huì)進(jìn)入一個(gè)頁面，左側(cè)導(dǎo)航欄展示了AGC的多種功能菜單。

3.點(diǎn)擊“添加應(yīng)用“按鈕，在項(xiàng)目下創(chuàng)建Android應(yīng)用。

點(diǎn)擊確定后會(huì)直接進(jìn)入到“設(shè)置SDK”的引導(dǎo)頁面中，我建議大家先去檢查并確保已經(jīng)完成高級(jí)分析服務(wù)的開通。

（二）開通華為分析服務(wù)

點(diǎn)擊“API管理“，看到Analystics Kit已默認(rèn)開啟。

回到左側(cè)導(dǎo)航欄，轉(zhuǎn)到“華為分析”，你將看到各種數(shù)據(jù)報(bào)告，包括用戶分析、行為分析、受眾分析等，點(diǎn)擊任意菜單即可開通分析服務(wù)。

然后進(jìn)入“項(xiàng)目接入設(shè)置”頁面，設(shè)置數(shù)據(jù)存儲(chǔ)位置、時(shí)區(qū)、貨幣、設(shè)置用戶數(shù)據(jù)留存時(shí)間、設(shè)置自然周定義后，單擊“完成”，即完成Analytics Kit服務(wù)開通。

集成HMS Core SDK

點(diǎn)擊“添加SDK”，即可回到引導(dǎo)頁面，按照步驟操作即可。

第一步：添加AppGallery Connect配置文件

a)下載配置文件“agconnect-services.json”

b)將“agconnect-services.json”文件拷貝到應(yīng)用級(jí)根目錄下

第二步：添加SDK

在Gradle文件中設(shè)置AppGallery Connect的Gradle插件以及AppGallery Connect SDK基礎(chǔ)包。

a)設(shè)置項(xiàng)目級(jí)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)設(shè)置模塊級(jí)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”，開始構(gòu)建工程。

接入Analytics

1.在你的應(yīng)用中初始化Analytics SDK

最后一步是在你的應(yīng)用中添加初始化代碼。通過getInstance接口SDK根據(jù)配置完成初始化。

2.通過onEvent接口記錄定義事件。

如果你不確定如何標(biāo)記事件，請(qǐng)查看事件說明。

3.參考“API說明”，調(diào)用接口實(shí)現(xiàn)各類功能。

另外，在開發(fā)過程中，推薦啟用調(diào)試模式，借助華為分析的應(yīng)用調(diào)試功能，可以實(shí)時(shí)查看事件的上報(bào)情況，觀察上報(bào)結(jié)果并做調(diào)測(cè)。

開啟/停用調(diào)試模式

1.開啟調(diào)試模式：在Android設(shè)備上執(zhí)行如下命令行，開啟調(diào)試模式。調(diào)試模式打開后會(huì)保持啟用狀態(tài)，所有事件將實(shí)時(shí)上報(bào)。

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

2.停用調(diào)試模式：您可執(zhí)行如下命令行，停用調(diào)試模式：

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

數(shù)據(jù)成功上報(bào)后，華為分析的應(yīng)用調(diào)試界面會(huì)展示出數(shù)據(jù)，如下圖：

接入過程遇到問題可以上Stack Overflow提問，有華為研發(fā)專家一對(duì)一在線回答問題?？靵砗腿蜷_發(fā)者一起交流吧！

https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest