目录

集成SDK

针对Android Studio开发环境,华为提供了Maven仓集成方式的HMS Core SDK包。在开始开发前,您需要将HMS Core SDK集成到您的Android Studio开发环境中。

添加当前应用的AppGallery Connect配置文件

  1. 登录AppGallery Connect网站,点击“我的项目”。
  2. 在项目列表中找到您的项目,在项目中点击需要集成HMS Core SDK的应用。
  3. 在“项目设置 > 常规”页面的“应用”区域,点击“agconnect-services.json”下载配置文件。

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

    • 在获取agconnect-services.json文件前,请确保已经完成分析服务的开通(开通步骤参见开通华为分析服务)。
    • 如果您进行过任何修改动作,包括但不限于:设置数据存储的位置、开启或管理某些API等,您需要下载最新的“agconnect-services.json”,并替换Android应用模块App的根目录下已有的文件。

配置HMS Core SDK的Maven仓地址

Android Studio的代码库配置在Gradle插件7.0以下版本、7.0版本和7.1及以上版本有所不同。请根据您当前的Gradle插件版本,选择对应的配置过程。

Maven仓地址无法直接在浏览器中打开访问,只能在IDE中配置。如需添加多个Maven代码库,请将华为公司的Maven仓地址配置在最后。

添加编译依赖

  1. 打开应用级的“build.gradle”文件。

  2. 添加AGC插件配置。请根据实际情况选择:

    • 方式一:在文件头部声明下一行添加如下配置。
      apply plugin: 'com.huawei.agconnect'
    • 方式二:在plugins中添加如下配置。
      plugins {
          id 'com.android.application'
          // 添加如下配置
          id 'com.huawei.agconnect'
      }

  3. 在“dependencies”中添加如下编译依赖。

    implementation 'com.huawei.hms:hianalytics:{version}'
    implementation 'com.huawei.hms:dtm-api:{version}'

    {version}替换为实际的版本号,Analytics Kit版本号请参见版本更新说明,DTM Kit版本号请参见版本更新说明。

    例如:implementation 'com.huawei.hms:hianalytics:6.12.0.301'和implementation 'com.huawei.hms:dtm-api:6.6.0.308'。

(可选)集成DTM插件

集成DTM插件后,可在应用编译期间向目标类中动态注入埋点相关代码,从而提高程序运行时的性能。

若您集成的“com.huawei.hms:dtm-api:version”的版本号为5.2.0.300及以上版本,推荐您集成DTM插件。

该插件只支持Android Studio项目开发工具,不支持Eclipse。

当您集成DTM插件后,进行Fragment可视化埋点时无需执行步骤2。

  1. 在“project”级别的“build.gradle”文件中添加DTM插件依赖。

    buildscript {
        repositories {
            google()
            jcenter()
            // 配置Maven仓地址。
            maven {url 'https://developer.huawei.com/repo/'}
        }
        dependencies {
            ...
            // 增加DTM插件配置。
            classpath 'com.huawei.hms:dtm-plugin:6.1.0.300'}
    }
    
    allprojects {
        repositories {
            google()
            jcenter()
            // 配置Maven仓地址。
            maven {url 'https://developer.huawei.com/repo/'}
        }
    }

  2. 在应用级的“build.gradle”文件中添加DTM插件配置,请根据实际情况选择。

    • 方法一:在文件头部声明下一行添加如下配置。
      apply plugin: 'com.huawei.hms.dtm.plugin'
    • 方法二:在plugins中添加如下配置。
      plugins {
          id 'com.android.application'
          //添加如下配置
          id 'com.huawei.hms.dtm.plugin'
      }

  3. (可选)若您需要查看DTM插件编译日志,可在应用级的“build.gradle”中添加如下脚本。

    android {       }
    // 配置如下 
    dtmConfig{
     // 是否开启DTM插件编译日志,true开启,false关闭
        debug = true
    }

同步工程

在完成以上的配置后,点击工具栏中的gradle同步图标,完成“build.gradle”文件的同步,将相关依赖下载到本地。

如果出现错误,请检查网络连接是否正常,以及检查“build.gradle”文件是否正确。