华为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方法,所有设置的默认值以及云端的参数值都将被重置。
云存储服务开发指南: