HarmonyOS鸿蒙Next应用接入

HarmonyOS鸿蒙Next应用接入

SDK描述

开发者接入华为云空间服务时需要集成HMS Core SDK。其中，HMS Core SDK中的其他SDK提供了登录及鉴权信息，Drive SDK提供管理用户华为云空间文件的能力。

版本适用的开发环境 获取方法

集成Drive SDK和其他HMS Core 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”文件拷贝到应用级根目录下。

配置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 {
        google()
        jcenter()
        maven { url 'https://developer.huawei.com/repo/' }
    }
    dependencies {
        ...
        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

7.0版本

1. 打开Android Studio项目级build.gradle文件。
2. 添加HUAWEI AGC插件以及Maven代码库。

buildscript {
    repositories {
        google()
        jcenter()
        maven { url 'https://developer.huawei.com/repo/' }
    }
    dependencies {
        ...
        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

7.1及以上版本

1. 打开Android Studio项目级build.gradle文件。
2. 在dependencies中增加Android Gradle插件配置。

buildscript {
    dependencies {
        ...
        classpath 'com.android.tools.build:gradle:7.1.1'
        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    }
}

1. 打开项目级settings.gradle文件，配置HMS Core SDK的Maven仓地址。

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        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'
}

1. 在dependencies中添加如下编译依赖。

dependencies {
    implementation 'com.huawei.hms:drive:5.2.0.300'
    implementation 'com.huawei.hms:hwid:5.3.0.305'
    implementation 'com.huawei.hms:push:5.3.0.304'
}

多语言设置

如果您的应用不需要设置只支持某些特定语言，则请忽略本步骤。应用将默认支持所有HMS Core SDK支持的语言。

如果您的应用需要设置只支持某些特定语言，则可通过本步骤配置。

1. 打开应用级的build.gradle文件。
2. 在android > defaultConfig中新增resConfigs，配置需要支持的语种，配置格式如下：

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

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

同步工程

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

配置混淆脚本

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

1. 打开Android工程的混淆配置文件proguard-rules.pro。
2. 加入排除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.**{*;}
-keep class com.huawei.cloud.services.drive.**{*;}
-keep class com.huawei.cloud.base.** {*;}
-keep class com.huawei.cloud.client.** {*;}
-keep class com.huawei.cloud.base.json.JsonError {*;}
-keep class com.huawei.cloud.base.json.JsonErrorContainer {*;}

如果开发者使用了AndResGuard，需要在应用级的build.gradle文件中加入AndResGuard允许清单。

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}