0
点赞
收藏
分享

微信扫一扫

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

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

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

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

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

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


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

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

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

快速集成华为AGConnect远程配置服务-Android_配置项_02

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路径下。

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

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​​

举报

相关推荐

0 条评论