简介

HMS Core提供端、云开放能力,帮助开发者实现应用高效开发、快速增长、商业变现,使能开发者创新,为全球用户提供精品内容、服务及体验。
AppGallery Connect的创意、开发、分发、运营、分析服务,覆盖全终端全场景,提升开发、运营效率,助力用户和收入增长。

教程

AppGallery Connect 初始配置

  1. 打开AppGallery Connect网站。
  2. 点击我的项目->添加项目,根据提示创建项目。
  3. 点击添加应用,根据提示创建应用。
  4. 以上操作完成后,将自动跳转到对应应用信息页面。

Android工程 创建

  1. 启动Android Studio
  2. 选择菜单栏中的File->New->New Project,选择Empty Activity->Next
  3. 填写应用信息,注意应用名称包名应当与AppGallery Connect上创建应用的对应信息一致,点击Finish
  4. 等待创建完毕即可。

Android签名证书 创建

  1. 在对应工程内的菜单栏中选择**Build->Generare Signed Bundle / APK…**。
  2. 点击APK->Next以选择类别。
  3. 如果已有签名文件则点击Choose existing…**选择对应的签名文件,否则点击Create new…**创建一个新的签名文件。
  4. 签名文件创建/选择后,对话框中会显示对应签名文件的信息,然后点击Next
  5. 选择文件目录,选中release,勾选V1V2签名选项,点击Finish
  6. 将会在上一步对应目录中生成一个已签名的APK文件。

Android签名证书指纹 获取与配置

获取指纹

  1. 打开命令提示符cmd,进入JDKbin目录下。
  2. 使用keytool -list -v -keystore "xxx.jks"查看签名文件信息。
  3. 输入签名文件密钥库口令。
  4. 获取证书指纹SHA256

配置指纹

  1. 打开AppGallery Connect,找到项目设置->常规->应用部分。
  2. 将之前获取的证书指纹SHA256填入对应输入框中。
  3. 点击保存指纹。

AppGallery Connect 开通服务

  1. 打开AppGallery Connect,找到项目设置->API管理页面。
  2. 按照需求开启对应的API服务。

AppGallery Connect配置文件 添加

  1. 打开AppGallery Connect,找到项目设置->常规->应用部分。
  2. 下载agconnect-services.json配置文件。
  3. agconnect-services.json文件放置到Android工程的应用级根目录下。

Android工程Maven仓库 配置

  1. 打开项目级build.gradle文件并添加以下内容。
    build.gradle(Project)
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    buildscript {
    repositories {
    ...
    maven { url 'https://developer.huawei.com/repo/' }
    }
    dependencies {
    ...
    classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    }
    }
    ...
  2. 打开项目级settings.gradle文件并添加以下内容。
    settings.gradle
    1
    2
    3
    4
    5
    6
    7
    8
    dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
    ···
    maven { url 'https://developer.huawei.com/repo/' }
    }
    }
    ...

Android工程依赖 配置

  1. 将签名文件xxx.jks放置到应用级根目录下。
  2. 打开应用级build.gradle文件并添加以下内容。
    build.gradle(Module)
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    plugins {
    ...
    id 'com.huawei.agconnect'
    }

    android {
    ...
    signingConfigs {
    release {
    storeFile file('xxx.jks')
    keyAlias 'xxx'
    keyPassword 'xxx'
    storePassword 'xxx'
    v1SigningEnabled true
    v2SigningEnabled true
    }
    }
    ...
    buildTypes {
    release {
    signingConfig signingConfigs.release
    ···
    }
    debug {
    signingConfig signingConfigs.release
    debuggable true
    }
    }
    ...

    }

    dependencies {
    ...
    implementation 'com.huawei.hms:xxx:xxx'
    }
    ...

Android工程混淆 配置

如果项目使用了ProGuard,则需要打开proguard-rules.pro文件并添加以下内容。

proguard-rules.pro
1
2
3
4
5
6
7
8
9
-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.**{*;}

Android工程权限 配置

打开AndroidManifest.xml文件并添加对应权限。

AndroidManifest.xml
1
2
3
4
5
6
7
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.coolkk.codelabs.hmsaccounts">
···
<uses-permission android:name="android.permission.xxx" />
···
</manifest>

Android工程 同步

点击工具栏中的Gradle图标或悬浮栏中的Sync Now,进行相关配置的同步。

参考资料