公司最近开发了一个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