作为开发者,您可以在 mPaaS 控制台 实时发布 > 配置开关管理 中增加需要的开关配置项,并且按照平台、白名单、百分比、版本号、机型、Android 或 iOS 或 HarmonyOS NEXT 版本等信息针对性地下发配置。
前提条件
已在 Android 或 iOS 或 HarmonyOS NEXT 客户端添加开关配置服务的 SDK。
添加开关配置
添加开关配置时,既可以逐个添加配置,也可以通过导入 JSON 文件的方式一次添加多个开关配置。
开关配置列表展示了各个开关配置项的配置键、状态、创建时间、更新时间、创建人、修改人信息。新建的开关配置默认处于激活状态。
单个添加
进入 mPaaS 控制台,完成以下步骤:
在左侧导航栏,单击 实时发布 > 配置开关管理。
单击 添加配置,在 新建配置 页面中,输入配置键、备注、资源值,选择相应的平台和分类。资源值即配置键对应的配置值,一个配置键可以对应多个资源值,单击 添加 按钮可设置多个资源值。
添加高级规则(可选)。在资源值配置框中,单击 高级规则 右侧的 添加 按钮,可选择资源类型(版本号、osVersion、机型、城市)、操作类型,并设置相应的资源值。 每个资源值下面,都可以添加多条高级规则。
配置完毕后,单击 完成,新添加的开关配置将展示在配置列表中。
批量导入
在 配置开关管理 页面,单击配置列表上方的 更多操作 > 导入文件 菜单,导入 JSON 格式的开关配置文件。文件中可以包含多条开关配置。导入成功后,导入的配置将展示在配置列表中。
如配置文件中包含的开关配置信息已存在,则该条配置将无法导入。
在提供批量导入功能的同时,实时发布平台还提供配置导出功能。在 配置开关管理 页面,单击配置列表上方的 更多操作 > 配置导出 菜单。勾选要导出的配置项后,单击 配置导出 按钮,即可下载 JSON 配置文件到本地。
查询开关配置
在 配置开关管理 页面,输入配置键关键字查询开关配置。
修改开关配置
完成以下步骤,修改开关配置:
在 配置开关管理 页面,选择目标配置,单击配置键,打开编辑页面。
修改备注、资源值、平台、分类或高级规则后,单击 完成 即可。配置键一旦添加,不可修改。
使开关生/失效
新建的开关配置默认处于激活状态,若不需要某个配置,可单击 失效 使该配置项处于失效状态。同样,针对失效状态的配置项,单击 激活 可使其重新生效。
后续操作
当控制台发布了开关后,客户端可通过调用接口获取开关对应的键值。详情请参考实时发布开关配置管理 接入 HarmonyOS NEXT(beta)。