集成HMS Core SDK

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

如果在AppGallery Connect中开通了相关服务则需要将“agconnect-services.json”文件添加到您的App中。

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

   

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

   

配置HMS Core SDK的Maven仓地址

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

• 7.0以下版本
  1. 打开Android Studio项目级“build.gradle”文件。

     

  2. 添加HUAWEI AGC插件以及Maven代码库。
     • 在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
     • 在“allprojects > repositories”中配置HMS Core SDK的Maven仓地址。
     • 如果App中添加了“agconnect-services.json”文件则需要在“buildscript > dependencies”中增加AGC插件配置。
     收起

     自动换行

     深色代码主题

     复制

     buildscript {
         repositories {
             google()
             jcenter()
             // 配置HMS Core SDK的Maven仓地址。
             maven {url 'https://developer.huawei.com/repo/'}
         }
         dependencies {
             ...
             // 增加AGC插件配置，请您参见AGC插件依赖关系选择合适的AGC插件版本。
             classpath 'com.huawei.agconnect:agcp:
     1.6.0.300'
         }
     }
     allprojects {
         repositories {
             google()
             jcenter()
             // 配置HMS Core SDK的Maven仓地址。
             maven {url 'https://developer.huawei.com/repo/'}
         }
     } 

• 7.0版本
  1. 打开Android Studio项目级“build.gradle”文件。

     

  2. 添加HUAWEI AGC插件以及Maven代码库。
     • 在“buildscript > repositories”中配置HMS Core SDK的Maven仓地址。
     • 在“buildscript > dependencies”中增加Android Gradle插件配置。
     • 如果App中添加了“agconnect-services.json”文件，则还需要在“buildscript > dependencies”中增加AGC插件。
     收起

     自动换行

     深色代码主题

     复制

     buildscript {
         repositories {
             google()
             jcenter()
             // 配置HMS Core SDK的Maven仓地址。
             maven {url 'https://developer.huawei.com/repo/'}
         }
         dependencies {
             ...
             // 增加Android Gradle插件版本号配置，{version}为实际的Gradle插件版本号，例如7.0.1。
             classpath 'com.android.tools.build:gradle:
     {version}'
             // 增加AGC插件配置，请您参见AGC插件依赖关系选择合适的AGC插件版本。
             classpath 'com.huawei.agconnect:agcp:
     1.6.0.300'
         }
     }

  3. 打开项目级“settings.gradle”文件，配置HMS Core SDK的Maven仓地址。
     收起

     自动换行

     深色代码主题

     复制

     dependencyResolutionManagement {
         ...
         repositories {
             google()
             jcenter() 
             // 配置HMS Core SDK的Maven仓地址。
             maven {url 'https://developer.huawei.com/repo/'}
         }
     }

• 7.1及以上版本
  1. 打开Android Studio项目级“build.gradle”文件。

     

  2. 在“buildscript > dependencies”中增加Android Gradle插件配置。
     如果App中添加了“agconnect-services.json”文件，则还需要在“buildscript > dependencies”中增加AGC插件。

     收起

     自动换行

     深色代码主题

     复制

     buildscript {
         dependencies {
             ...
             // 增加Android Gradle插件版本号配置，{version}为实际的Gradle插件版本号，例如7.1.1。
             classpath 'com.android.tools.build:gradle:
     {version}'
             // 增加AGC插件配置，请您参见AGC插件依赖关系选择合适的AGC插件版本。
             classpath 'com.huawei.agconnect:agcp:
     1.6.0.300'
         }
     }
     plugins {
         ...
     }

  3. 打开项目级“settings.gradle”文件，配置HMS Core SDK的Maven仓地址。
     收起

     自动换行

     深色代码主题

     复制

     pluginManagement {
         repositories {
             gradlePluginPortal()
             google()
             mavenCentral()
             // 配置HMS Core SDK的Maven仓地址。
             maven { url 'https://developer.huawei.com/repo/' }
         }
     }
     dependencyResolutionManagement {
         ...
         repositories {
             google()
             mavenCentral()
             // 配置HMS Core SDK的Maven仓地址。
             maven { url 'https://developer.huawei.com/repo/' }
         }
     }

添加编译依赖

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

   

2. 添加AGC插件配置。请根据实际情况选择：
   • 方式一：在文件头部声明下一行添加如下配置。
     收起

     自动换行

     深色代码主题

     复制

     apply plugin: 'com.huawei.agconnect'

   • 方式二：在plugins中添加如下配置。
     收起

     自动换行

     深色代码主题

     复制

     plugins {
         id 'com.android.application'
         // 添加如下配置
         id 'com.huawei.agconnect'
     }

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

   自动换行

   深色代码主题

   复制

   dependencies {
       implementation 'com.huawei.hms:keyring-credential:
   {version}'
   }

   说明

   {version}替换为实际的版本号，具体版本号请参见版本更新说明。例如：

   implementation 'com.huawei.hms:keyring-credential:6.3.0.301'

多语言设置

• 如果您的应用不需要设置只支持某些特定语言，则请忽略本步骤。应用将默认支持所有HMS Core SDK支持的语言。
• 如果您的应用需要设置只支持某些特定语言，则可通过本步骤配置。
  1. 打开应用级的“build.gradle”文件。

     

  2. 在“android > defaultConfig”中新增“resConfigs”，配置需要支持的语种，配置格式如下：
     收起

     自动换行

     深色代码主题

     复制

     android {
         defaultConfig {
             ...
             resConfigs "en", "zh-rCN", "需要支持的其他语言"
         }
     }        

  HMS Core SDK支持的语言列表请参见HMS Core SDK支持的语言。

同步工程

重新打开修改完的“build.gradle”文件，右上方出现“Sync Now”链接。点击“Sync Now”等待同步完成。