优维低代码：应用级配置

优维低代码技术专栏，是一个全新的、技术为主的专栏，由优维技术委员会成员执笔，基于优维7年低代码技术研发及运维成果，主要介绍低代码相关的技术原理及架构逻辑，目的是给广大运维人提供一个技术交流与学习的平台。

连载第三十三期

《高级指引：应用级配置》

▽

除了全局特性开关，有时我们希望支持按应用进行个性化配置。

# 配置

# 默认配置

首先，我们可以在 storyboard.app 中配置 defaultConfig 作为该应用的默认配置，例如：

app:
  id: "your-app"
  homepage: "/your-app"
  defaultConfig:
    pageSize: 50

# 个性化配置

在生产环境中，当前可以通过修改 CMDB 中小产品_已安装小产品（_INSTALLED_MICRO_APP）模型的相关实例的 userConfig 字段实现个性化配置。未来会支持在平台界面中进行个性化配置。

在个人开发环境中，可以在项目根目录中添加文件 dev.config.js 设置个性化配置。例如：

module.exports = {
  appConfig: {
    "your-app": {
      pageSize: 20,
    },
  },
};

# 使用

在运行时，storyboard.app 即 MicroApp 会多一个字段 config，它是应用的默认配置与个性化配置合并后的结果。

在 Storyboard 中，可以使用参数注入来引用应用配置，例如：

brick: "your-brick"
properties:
  pageSize: "${APP.config.pageSize}"

在构件中，则可以使用 Runtime 接口来获取应用配置，例如：

import { getRuntime } from "@next-core/brick-kit";


function YourBrick() {
  const pageSize = getRuntime().getCurrentApp().config.pageSize;
  // ...
}