快速集成华为 AGConnect 远程配置服务 - Android

华为 AppGallery Connect 提供了一个远程配置的服务。通过远程配置,应用即可无需升级,也可以在云端灵活修改应用的行为和外观,从而快速响应用户的需求。今天就来教大家如何接入 AppGallery Connect 的远程配置服务。

1、在 AGC 上开通远程配置并创建配置项:

我的项目 下选择你的开发项目,在增长下面,找到远程配置服务,点击开通:

没有 Android 项目的话,可以先自己创建一个。

开通后我们就可以进行配置项的设置了。

新建配置项时我们可以看到两个页签,配置项管理和配置条件管理。在配置项管理中,我们可以创建需要通过远程配置做修改的应用设置项。

1. 首先单击“添加配置项”,添加新的配置项内容。配置项可以配置多个条件值,即不同条件下,设置不同值,而这个配置条件值我们后面会在配置条件管理中进行讲解。

2. 单击“保存配置项”保存当前配置。

3. 单击“发布”使当前配置和条件生效,若单击“取消”将舍弃对配置和条件的更改。

4. 在“配置项管理”页签下,可以查看所有配置项列表。

5. 点击配置项右上角的“操作”:您可以查看、修改、删除配置项,还可以通过复制方式快速添加配置项

在配置条件管理中,我们就可以对配置下发对象做条件管理,让配置只下发到特定的用户群。一共有9个不同的配置条件,具体每个条件的说明可以参考官方文档

2、在 Android 项目里集成 SDK

a) 集成 SDK

1、在项目级的 gradle 文件中添加华为 Maven,即配置下面标红的内容

buildscript {
    repositories {
        google()
        jcenter()
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.0.1'
        classpath 'com.huawei.agconnect:agcp:1.5.2.300'
    }
}
 
allprojects {
    repositories {
        google()
        jcenter()
        maven {url 'https://developer.huawei.com/repo/'}
    }
}
 
task clean(type: Delete) {
    delete rootProject.buildDir
}

2、打开应用级的 build.gradle 文件,配置好云存储的 SDK 和华为认证服务的 SDK,配置下面标红的内容即可。  注意别落了上面的 agcp 插件

apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
android {…..}
 
dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
 
    implementation 'com.huawei.agconnect:agconnect-remoteconfig:1.5.2.300'
}

b) 下载 json 文件,并且配置默认存储实例

1、在 AGC 界面上,选择 我的项目 -> 项目设置–> 常规 下面,下载 agconnect-services.json 文件到你的 Android 项目的 app 路径下。

3、功能开发:

远程配置的功能其实很简单,最主要的就是通过 SDK 设置本地默认值与获取云端最新的配置项内容。

1、设置本地默认设置

首先在工程的 res/xml 中增加一个远程配置默认值的 xml 文件,其中键值对为<value key="testkey">testvalue</value>,例如文件 remote_config.xml。

文件创建完后在代码中调用 applyDefault 接口将文件传入来设置本地默认配置。

config.applyDefault(R.xml.remote_config);

或者直接在代码中创建一个 map 类型的数据,将 map 传入 applyDefault 也可以成功设置本地默认配置。

2、获取数据后立刻生效

应用通过 SDK 获取云端配置项后可以选择立刻生效还是下次启动后生效,首先是立刻生效

config.fetch().addOnSuccessListener(new OnSuccessListener<ConfigValues>() {
    @Override
    public void onSuccess(ConfigValues configValues) {
        config.apply(configValues);
        //使用配置值
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
    }
});

首先调用 fetch 接口获取云端的配置项,在获取成功的回调中我们可以直接调用 apply 接口将配置项立刻设置到应用中。

3、获取数据后下次启动生效

除了立刻生效外,我们可以选择下次启动再生效

ConfigValues last = config.loadLastFetched();
config.apply(last);
config.fetch().addOnSuccessListener(new OnSuccessListener<ConfigValues>() {
    @Override
    public void onSuccess(ConfigValues configValues) {
       
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
    }
});

我们只需要调用 loadLastFetched 接口接口获取到上次通过 fetch 接口下载下来的配置项数据,然后通过 apply 接口设置这些数据到应用中。

4、获取参数值

在我们获取了配置项后,如果我们需要将配置项一个个的取出来进行操作就需要调用 sdk 提供的一系列接口来获取这个值,不同的接口可以获取到不同类型的参数

Boolean

Boolean value = config.getValueAsBoolean("key");

Double

Double value = config.getValueAsDouble("key");

Long

Long value = config.getValueAsLong("key");

String

String value = config.getValueAsString("key");

Byte

byte[] value = config.getValueAsByteArray("key");

5、获取全部

我们还可以一次性获取全部的参数值

Map<String,Object> map = config.getMergedAll();

通过 getMergedAll 方法,我们就可以一次性获取全部的本地默认值和云端参数值了。

6、重置参数值

最后,SDK 还给我们提供了重置参数的功能

config.clearAll();

通过 clearAll 方法,所有设置的默认值以及云端的参数值都将被重置。

云存储服务开发指南:

https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-remoteconfig-introduction-0000001055149778

posted @ 2022-02-28 17:27  华为开发者论坛  阅读(753)  评论(0编辑  收藏  举报