目录

应用接入

方式一:集成HMS Core SDK

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

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

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

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

[h2]配置HMS Core SDK的Maven仓地址

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

7.0以下版本

7.0版本

7.1及以上版本

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

[h2]添加编译依赖

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

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

    dependencies {
        implementation 'com.huawei.hms:hwid:{version}'
        implementation 'com.huawei.hms:push:{version}'
    }

    {version}替换为实际的Kit依赖版本:com.huawei.hms:hwid:6.7.0.300,com.huawei.hms:push:6.7.0.300。

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

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

[h2]多语言设置

[h2]同步工程

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

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

[h2]配置混淆脚本

您编译APK前需要配置混淆配置文件,避免混淆HMS Core SDK导致功能异常。

  1. 在应用级根目录下打开混淆配置文件“proguard-rules.pro”,加入排除HMS Core SDK的混淆配置脚本。

    -ignorewarnings
    -keepattributes *Annotation*
    -keepattributes Exceptions
    -keepattributes InnerClasses
    -keepattributes Signature
    -keepattributes SourceFile,LineNumberTable
    -keep class com.huawei.hianalytics.**{*;}
    -keep class com.huawei.updatesdk.**{*;}
    -keep class com.huawei.hms.**{*;}

  2. 如果您使用了AndResGuard插件,需要在应用级的“build.gradle”文件中加入AndResGuard允许清单。如果您未使用AndResGuard插件,则请忽略本步骤。

    whiteList = [
        "R.string.hms*",
        "R.string.connect_server_fail_prompt_toast",
        "R.string.getting_message_fail_prompt_toast",
        "R.string.no_available_network_prompt_toast",
        "R.string.third_app_*",
        "R.string.upsdk_*",
        "R.layout.hms*",
        "R.layout.upsdk_*",
        "R.drawable.upsdk*",
        "R.color.upsdk*",
        "R.dimen.upsdk*",
        "R.style.upsdk*", 
        "R.string.agc*"
    ]

  3. (可选)当您启用R8资源缩减(项目级“build.gradle”文件中“shrinkResources”属性为“true”)和严格引用检查(“res/raw/keep.xml”文件中的“shrinkMode”为“strict”)时,请您配置“keep.xml”文件手动保留layout资源,确保应用正常通过华为应用市场上架审核。

    <?xml version="1.0" encoding="utf-8"?>
    <resources xmlns:tools="http://schemas.android.com/tools"
        tools:keep="@layout/hms_download_progress,@drawable/screen_off,@layout/upsdk*"
        tools:shrinkMode="strict" />

方式二:使用WEB应用接入方式

针对WEB应用开发,华为提供了WEB应用接入方式。在开始开发前,您需要先通过华为帐号开放服务实现快速登录授权功能,凭借用户授权凭证,应用可快速调用华为云空间服务提供的公开API。

[h2]创建服务器应用

开发者在接入Drive服务之前,需要先创建服务器应用,详情请参见《华为帐号服务开发指南》WEB应用接入开发准备章节。

[h2]打开Drive应用开关

  1. 登录AppGallery Connect网站,点击“我的项目”。
  2. 在项目列表中找到您的项目,在项目中选择需要接入Drive的应用,点击"API管理"。
  3. 在“项目设置”页面的“API管理”区域,点击Drive Kit右侧开关,确保开关处于打开状态。

[h2]签署开通华为云空间隐私通知和用户协议

引导用户访问https://cloud.huawei.com/,首次访问的用户需要签署协议才可以使用华为云空间服务。

[h2]应用接入获取鉴权凭证Access Token

应用接入Drive应使用鉴权凭证Access Token,具体获取方式请参见《华为帐号服务开发指南》WEB应用接入开发指南章节。

申请授权码code请求时scope设置应添加华为云空间服务相应的Scope,请参见Scope列表。