版本解析
目录制品——Components、Features、Recipes、FeatureRecipes、Plugins
和 Aggregates——都带有 metadata.version,并且一个目录可以同时保存同一制品的
多个版本。当某处引用一个制品时,该引用会选择使用哪个版本。本页介绍这一选择
的工作方式。
引用版本
引用是制品的类型 URI,可选择固定到某个版本。接受以下三种 形式:
| 形式 | 示例 | 选择结果 |
|---|---|---|
| 精确 | core/datastore/mariadb:1.2.0 | 恰好该版本 |
| 范围(脱字符) | core/datastore/mariadb:^1.2.0 | 满足 >= 1.2.0 且 < 2.0.0 的最高版本 |
| 无版本 | core/datastore/mariadb | 可用的最高版本 |
脱字符形式遵循 npm、Cargo 和 Go modules 中常见的主版本兼容约定。在所有形式中,解析都会选择满足该引用的 最高版本,并优先选择稳定版本而非预发布版本。精确 引用是退出自动选择、固定某一版本的方式。
确定性
选择只在锁定依赖时运行一次。lockfile 记录该引用所选择的 版本——范围引用按其解析到的版本记录, 而从不记录为范围——以及基于该版本自身文档计算的内容指纹, 之后的每次构建都会根据该记录复现完全相同的 制品——因此目录中新增更新的版本,永远不会悄无声息地 改变已锁定的构建。重新锁定是一项显式操作。
无论目录位于何处,都适用同一规则:本地目录 检出和注册表会将同一引用解析为同一版本。对于每个读取目录的命令, 规则也相同。写入 lockfile 的 pull、读取它的构建、validate、编辑器以及面向助手的 工具,都会从同一个目录中选择相同的版本,无论其目录中保存了某个 名称的多少个版本;构建对 lockfile 的检查会将 它所选择的版本与 pull 记录的版本进行比较。
库依赖
可复用的 schema 库和映射库(SchemaLibrary、MappingLibrary)的解析方式 不同:它们使用最小版本选择——即满足整个工作区所有约束的 最低版本——这同样与 Go modules 一致。这 使库的升级成为有意的操作,而非自动发生。
没有版本满足引用时
如果引用固定的版本或范围没有任何可用版本能够满足——
例如只存在 1.x 版本时引用 :^2.0.0——解析会停止并报错,
错误中按原样写出该引用,即制品与约束一并给出,而不会
悄无声息地回退到其他版本。对同一 Release 执行 pull 和 validate,
会以相同的措辞拒绝它。解析 Release 的依赖时,对于完全不存在的
制品,也会以同样的措辞报告,因为无论哪种情况,该引用
都没有匹配到任何内容——因此请同时查看错误所指引用的两个部分。