跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

版本解析

目录制品——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 的依赖时,对于完全不存在的 制品,也会以同样的措辞报告,因为无论哪种情况,该引用 都没有匹配到任何内容——因此请同时查看错误所指引用的两个部分。