手把手教你接入华为分析的Android SDK
<p> 公司最近开发了一个Android版手游应用，想了解一下上线以来玩家充值情况，就让我接入<strong>华为分析的Android SDK</strong>。今天我就来给大家分享一下如何将Analytics Kit添加到安卓应用中去。本文是基于Android平台，关于iOS应用接入华为分析服务SDK的方法，可以参考：接入华为分析的iOS SDK。我接入的版本是<strong>5.0.0.301</strong>。</p><p> 当我们开始接SDK时，我们要注意以下两个方面：</p>
<ol>
<li>参考华为开发者联盟最新的SDK接入文档，并注意你接入的SDK版本</li>
<li>不要遗漏文档中需要复制的代码细节</li>
</ol>
<p> 具体步骤包括：</p>
<ol>
<li>配置AppGallery Connect</li>
<li>集成HMS Core SDK</li>
<li>接入Analytics</li>
</ol>
<h1 id="1-配置appgallery-connect">1 配置AppGallery Connect</h1>
<p> 请按照如下步骤为你的安卓应用配置AppGallery Connect。如果你的应用同时拥有Android和iOS版本，你可以将两个应用放在同一个项目内，后续可以灵活切换，以对全量用户做跨平台、跨设备的统一数据分析。</p>
<p><img src="https://img-blog.csdnimg.cn/202007170950066.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"></p>
<h2 id="一开发前准备">（一）开发前准备</h2>
<ol>
<li>为你的安卓应用准备好包名（向开发人员询问）。</li>
<li>登录 AppGallery Connect 网站 并创建一个新项目。</li>
</ol>
<p><img src="https://img-blog.csdnimg.cn/20200717095136713.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"></p>
<p> 项目创建好后，你会进入一个页面，左侧导航栏展示了AGC的多种功能菜单。</p>
<p><img src="https://img-blog.csdnimg.cn/2020071709535026.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"><br>
3. 点击“添加应用“按钮，在项目下创建Android应用。</p>
<p><img src="https://img-blog.csdnimg.cn/20200717095446748.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"><br>
点击确定后会直接进入到“设置SDK”的引导页面中，我建议大家先去检查并确保已经完成高级分析服务的开通。</p>
<h2 id="二开通华为分析服务">（二）开通华为分析服务</h2>
<p> 点击“API管理“，看到Analystics Kit已默认开启。</p>
<p><img src="https://img-blog.csdnimg.cn/20200717095547289.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"></p>
<p> 回到左侧导航栏，转到“<strong>华为分析</strong>”，你将看到各种数据报告，包括用户分析、行为分析、受众分析等，点击任意菜单即可开通分析服务。<br>
然后进入“<strong>项目接入设置</strong>”页面，设置数据存储位置、时区、货币、设置用户数据留存时间、设置自然周定义后，单击“完成”，即完成Analytics Kit服务开通。</p>
<p><img src="https://img-blog.csdnimg.cn/20200717095647510.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"></p>
<h1 id="集成hms-core-sdk">集成HMS Core SDK</h1>
<p> 点击“添加SDK”，即可回到引导页面，按照步骤操作即可。</p>
<p><img src="https://img-blog.csdnimg.cn/20200717095751802.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"></p>
<h2 id="第一步添加appgallery-connect配置文件">第一步：添加AppGallery Connect配置文件</h2>
<h3 id="a-----下载配置文件agconnect-servicesjson">a) 下载配置文件“agconnect-services.json”</h3>
<h3 id="b-----将agconnect-servicesjson文件拷贝到应用级根目录下">b) 将“agconnect-services.json”文件拷贝到应用级根目录下</h3>
<p><img src="https://img-blog.csdnimg.cn/20200717095910926.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"></p>
<h2 id="第二步添加sdk">第二步：添加SDK</h2>
<p> 在Gradle文件中设置AppGallery Connect的Gradle插件以及AppGallery Connect SDK基础包。</p>
<h3 id="a-设置项目级buildgradle">a) 设置项目级build.gradle</h3>
<pre><code>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'
}
}
</code></pre>
<h3 id="b-设置模块级buildgradle">b) 设置模块级build.gradle</h3>
<pre><code>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'
</code></pre>
<h3 id="c单击sync-now或sync-project-with-gradle-files开始构建工程">c)单击“Sync now”或“Sync Project with Gradle Files”，开始构建工程。</h3>
<p>接入Analytics</p>
<ol>
<li>
<p><strong>在你的应用中初始化Analytics SDK</strong><br>
最后一步是在你的应用中添加初始化代码。通过 getInstance 接口SDK根据配置完成初始化。</p>
</li>
<li>
<p><strong>通过 onEvent 接口记录定义事件。</strong><br>
如果你不确定如何标记事件，请查看事件说明。</p>
</li>
<li>
<p><strong>参考“API说明”，调用接口实现各类功能。</strong><br>
另外，在开发过程中，推荐启用调试模式，借助华为分析的应用调试功能，可以实时查看事件的上报情况，观察上报结果并做调测。</p>
</li>
</ol>
<p>开启/停用调试模式</p>
<ol>
<li><strong>开启调试模式</strong>：在Android设备上执行如下命令行，开启调试模式。调试模式打开后会保持启用状态，所有事件将实时上报。</li>
</ol>
<pre><code>adb shell setprop debug.huawei.hms.analytics.app package_name
</code></pre>
<ol start="2">
<li><strong>停用调试模式</strong>：您可执行如下命令行，停用调试模式：</li>
</ol>
<pre><code>adb shell setprop debug.huawei.hms.analytics.app .none.
</code></pre>
<p> 数据成功上报后，华为分析的应用调试界面会展示出数据，如下图：</p>
<p><img src="https://img-blog.csdnimg.cn/20200717111242373.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70"><br>
<strong>更详细的开发指南参考华为开发者联盟官网</strong>：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050040566</p>
<hr>
<p>原文链接：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201296913629300024&fid=18</p>
<p>原作者：小鱼</p><br><br>
来源：https://www.cnblogs.com/developer-huawei/p/13329577.html
頁:
[1]