公司最近开发了一个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版本，你可以将两个应用放在同一个项目内，后续可以灵活切换，以对全量用户做跨平台、跨设备的统一数据分析。

在这里插入图片描述

<figcaption></figcaption>

（一）开发前准备

1. 为你的安卓应用准备好包名（向开发人员询问）。
2. 登录 AppGallery Connect 网站 并创建一个新项目。

在这里插入图片描述

<figcaption></figcaption>

项目创建好后，你会进入一个页面，左侧导航栏展示了AGC的多种功能菜单。

在这里插入图片描述

<figcaption></figcaption>

1. 点击“添加应用“按钮，在项目下创建Android应用。

在这里插入图片描述

<figcaption></figcaption>

点击确定后会直接进入到“设置SDK”的引导页面中，我建议大家先去检查并确保已经完成高级分析服务的开通。

（二）开通华为分析服务

点击“API管理“，看到Analystics Kit已默认开启。

在这里插入图片描述

<figcaption></figcaption>

回到左侧导航栏，转到“华为分析”，你将看到各种数据报告，包括用户分析、行为分析、受众分析等，点击任意菜单即可开通分析服务。
然后进入“项目接入设置”页面，设置数据存储位置、时区、货币、设置用户数据留存时间、设置自然周定义后，单击“完成”，即完成Analytics Kit服务开通。

在这里插入图片描述

<figcaption></figcaption>

集成HMS Core SDK

点击“添加SDK”，即可回到引导页面，按照步骤操作即可。

在这里插入图片描述

<figcaption></figcaption>

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

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

b) 将“agconnect-services.json”文件拷贝到应用级根目录下

在这里插入图片描述

<figcaption></figcaption>

第二步：添加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.
   
   

   数据成功上报后，华为分析的应用调试界面会展示出数据，如下图：

在这里插入图片描述