优维低代码实践连载第24期

《打包发布》

▽

一、为什么需要打包

通常，我们可以通过点击【构建并推送】，把微应用推送到开发环境。这样的一键推送非常方便，但同时也存在缺点：

• 缺乏可控性，可能会将非期望的变更推送过去；

• 无法区分开发和生产环境，如果加入测试环节，我们还需要区分测试环境；

• 缺少版本管理，对测试不友好。

因此，除了【构建并推送】，Visual Builder 还支持将微应用进行打包，形成具有版本号的制品，以适应高阶的测试和生产需求。

二、如何进行打包

2.1 功能入口

独立打包

也叫standalone模式，打出来的制品名称格式为 xxx-standalone-NA，它的特点是：

• 将微应用的配置（storyboard）以及所依赖的一切前端构件、框架代码都打包进制品中，因此它可以独立安装部署；

• 各微应用之间互相独立，互不干扰；

• 运行环境需要enterprise发行版6.11或以上。

普通打包

区别于standalone模式，打出来的制品名称格式为 xxx-NA，它的特点是：

• 仅将微应用的配置（storyboard）打包进制品中，微应用的运行依赖于运行环境中所部署的框架代码和构件；

• 各微应用共用一套框架代码和构件，互相耦合；

• 运行环境无版本要求（enterprise发行版6.11以上也可以兼容运行）。

2.2 修改统计

在这里，你可以看到在上一次打包发布以后，都有哪些用户修改过编排。

你应该和这些用户沟通，确保他们的修改是处于完成状态、可被发布的。

2.3 版本对比

提供了类似于git diff的方式来查看本次修改的内容，帮助用户进行变更检查。

2.4 静态检查

通过静态语法分析，为编排提供一些修改建议。包括但不限于：

• 不符合最佳实践的编排方式

• 多余的编排配置

• 合理化建议

您可以根据问题列表来对编排进行改进，但这些问题并不会影响微应用的实际功能。

2.5 性能检查（可选功能）

我们会统计您的微应用各个页面的加载耗时，并将高于设定阈值（默认2.5s）的页面列出。

性能检查是一个可选功能，默认不会开启。

2.6 函数检查

如果您在编排里使用了函数，那么打包时将进行对函数进行单元测试，提供测试结果和覆盖率。

2.7 依赖检查

微应用的运行，依赖于框架代码以及构件，因此，我们需要维护正确的依赖信息，才能将微应用运行所需要的依赖打进制品包内。

依赖信息说明

• 依赖组件

依赖的组件名称，包括各类构件（xxx-NB）、框架代码（brick_next）等。

• 依赖来源

直接依赖，即直接添加的依赖。间接依赖，指那些不是直接添加，而是通过依赖的依赖而来的。例如：某个微应用的运行依赖构件 agile-NB ，而 agile-NB 又依赖框架代码 brick_next 的特定版本，那么 brick_next 就是一个间接依赖。（微应用 -> agile-NB -> brick_next）

• 版本限制

限制某个依赖组件的版本范围。版本限制的写法参考了semver的规范，常用写法有：^1.1.0 表示 ≥1.1.0 且＜2.0.0，* 表示任意版本均可。可以通过【新增依赖】和【编辑依赖】来设置版本限制。

在普通打包的情况下，微应用的部署会检查运行环境的框架代码、构件等组件是否满足依赖里的版本限制，不满足的话将会安装失败。

• 实际版本

仅独立打包有效，表示依赖组件被打包到制品内的实际版本。如果缺少实际版本信息，那么打包时依赖组件将不会被打进制品内。【新增依赖】、【编辑依赖】和【更新依赖】时都会检查并分析组件之间的依赖关系，获取满足版本限制的最新版本，以此作为实际版本。

依赖分析提示

此步骤中，Visual Builder会检查编排内容，分析出需要哪些依赖并给出报错（红色）和警告（黄色）提示，包括：缺少依赖声明、缺少实际版本、未使用的依赖。

在提示信息最后都有快速操作按钮，用户点击按钮可以自动补充更新依赖信息。

• 缺少依赖声明：Visual Builder分析出编排里使用了前端组件但未纳入依赖，打包时将不会纳入这些组件。

• 缺少实际版本：依赖里的某个组件未获取实际版本，打包时将不会纳入这些组件。

• 未使用的依赖：Visual Builder分析出编排里未使用前端组件但却纳入依赖，去掉这些依赖可以减少打包的制品体积。

新增依赖

• 首先填入依赖组件的名称。

• 接着选择某个版本作为实际版本，又或者留空，让后台自动分析。

• 最后一列是依赖组件的版本限制。对于独立打包，通常情况下，我们设置版本限制为“*”即可（表示满足任意版本均可）。

对于独立打包来说，Visual Builder会依据上面的选择，获取用户指定的版本，或者获取满足依赖限制的最新版本作为实际版本。

对于普通打包来说，依赖组件不会打进制品，版本限制仅用作安装时的依赖检查。所以我们可能需要设置适当的版本限制，以保证构件的版本足够新，能够包含微应用所需要的特性。

编辑依赖

仅修改组件的版本限制。如果需要修改组件的实际版本，请点击更新按钮。

Visual Builder会判断当前实际版本是否满足版本限制，不满足时会重新分析组件之间的依赖并获取最新版本作为实际版本。

更新依赖

• 更新到指定版本：指定某个版本来作为实际版本。

• 更新到最新版本：Visual Builder自动分析组件之间的依赖关系，重新获取组件的最新版本作为实际版本。

2.8 版本信息

选择此次打包是新特性还是问题修复，您也可以手动填写版本。

正如2.7中所说，Visual Builder参考了 semver 语义化版本规范，采用了三段式的版本号。拿 3.1.2 作为例子：

• 第一位为MAJOR，主版本号，表示大版本升级，不同大版本之间可能是不兼容的。

• 第二位为MINOR，次版本号，表示小版本升级，不同次版本之间必须是兼容的。通常次版本号代表新特性的增加。

• 第三位为PATCH，修订号，表示bug的修复。修订号不会影响到特性，仅仅是修复已知bug。

因此，选择新特性，MINOR会自动进位，例如：3.1.2 -> 3.2.0。选择问题修复，PATCH会自动进位，例如：3.1.2 -> 3.1.3。

2.9 确认变更

填写好版本信息以后，点击完成，有可能会弹出以下提示：

正如2.2中所说，您应该和这些用户沟通，确保他们的修改是处于完成状态、可被发布的。

确认后将进行打包，稍等片刻，您就可以在发布历史中看到您的打包记录。