选择你要处理的 Release
所选 Release——一个状态栏指示器以及 Commands 面板顶部的一行 Release,两者都指明编辑器正在处理的那一个 Release。所有作用于 Release 的操作——验证、拓扑图、构建、预览构建和拉取——都作用于它。当你选择另一个 Release 时,已打开的图面板保留其绘制时所依据的 Release,再次显示图时会绘制新选择的那个。图、构建、预览构建和拉取会读取该 Release 构建时所依据的目录文件夹:如果你的工作区配置在 workspace.releases 下为它指定了一些,则使用它自己的,否则使用工作区的——与在终端中 aggrega build --release 读取的相同,因此一个窗口可以针对每个 Release 自己的目录构建工作区中的每个 Release,无需传递任何标志。Catalog 面板、检查、Catalog 行的检查、悬停、补全、Go to Definition、Find References 和 Find Implementations 也按所选 Release 的视角作答:如果你的工作区配置为每个 Release 指定了目录文件夹,则每个功能都会读取工作区所含的文档(仅另一个 Release 读取的文件夹中的文档除外),以及所选 Release 构建时所依据的目录文件夹——因此由多个变体(每个 Release 一个)声明的名称会解析为所选 Release 的那个。未选择 Release 时,它们按工作区自身的视角作答。参见选择 Release。
选择 Release
扩展所做的大部分工作都以某个 Release 为范围:读取哪些 catalog 目录、解析哪些组件、应用哪些 lockfile 锁定,以及文档会得到哪些检查结果。因此,扩展一次只针对一个选定的 Release 工作,并在状态栏中火箭图标旁显示是哪一个。
你选择的 Release 会被该编辑器窗口记住。语言服务器连接时,会将记住的选择与工作区仍提供的内容进行核对,若仍存在则恢复;若已不存在,编辑器会告知你,并回退到你的工作区所隐含的选择——当你在此窗口中尚未做出任何选择时,选择也从这里开始。该答复按优先级依次来自:
.aggrega-config.yaml中的build.authoring_release,即整个团队共享的已提交设置。.aggrega/active-release,一个不提交的本地标记文件。- 工作区中唯一的 Release(当恰好只有一个时)。
点击任一指示器即可选择另一个 Release(或从命令面板运行 Aggrega: Select Release…)。更改立即生效——无需重启,每个打开的 YAML 文件都会针对你刚选择的 Release 重新检查,Catalog 面板也会为其重新读取列表;语言服务器连接时采用某个 Release 时也是如此。记住的选择仅限于该编辑器窗口:选择不会向你的工作区写入任何内容。如果选择器打开时焦点位于 Commands 面板——其 Release 行或其任何控件上——那么无论你选择了 Release 还是取消了选择器,选择器关闭时焦点都会回到该控件;若从其他任何地方打开,选择器关闭后焦点不会落在该面板上。

提供的 Releases 是语言服务器所锚定的文件夹内的那些,以相对于该文件夹的名称命名,因为这是它接受的形式。当某个 Release 无法提供时,编辑器会说明有多少个以及它们位于何处,而不是默默地略去它们。语言服务器不会通过指向该文件夹之外的链接读取任何 Release,因此编辑器文件树通过指向外部的链接——指向外部目录或外部 Release 文件的链接——显示的 Release 不会被提供。唯一的例外是指向工作区配置以 build.authoring_release 或 workspace.releases 的键所指定的 Release 文件的链接:该 Release 会通过其链接读取并提供。打开选择器时会以单独的通知说明这一点,按相对于该文件夹的路径列出每个位于语言服务器原本会读取之处的此类链接:先列出指向目录的链接,再列出指向文件的链接。名称以 .yaml 或 .yml 结尾的链接无论其指向的文件包含什么都会被列出,因为不会为查明这一点而读取该文件。
当你希望将选择记录在工作区本身中——使全新的检出从它开始——有两个命令可以做到,而且都不会改变你当前正在处理的内容:
- Aggrega: Set the selected Release as this workspace’s default 让语言服务器将当前选定的 Release 写入
.aggrega/active-release。该文件仅属于你的检出,因此适合存放个人默认值。如果.aggrega或该标记文件是指向 Aggrega 工作区之外的链接,则不会写入任何内容,通知中会以编译器自己的话说明原因。 - Aggrega: Set authoring_release in .aggrega-config.yaml… 会打开配置文件,以便你设置
build.authoring_release。该设置会被提交并共享,其优先级高于标记文件。如果语言服务器报告该配置文件是指向 Aggrega 工作区之外的链接,则不会打开该文件,并会有一条错误说明它指向工作区之外,因此 Aggrega 不会使用它;欢迎页面上用于创建工作区配置的控件,在发现已存在的此类文件时也会这样做。
如果工作区不提供任何 Release——没有配置、没有标记,也没有恰好一个可回退的文件——指示器会如实说明,并说明两种情况中的哪一种成立。当存在可供选择的 Releases 而你未处于其中任何一个时,它显示 Release: none selected(Release:未选择);当 Aggrega 工作区根本没有提供任何 Release 时,它显示 Release: none available(Release:无可用项)。后者不是你能通过选择来解决的状态,因此其工具提示会列出摆脱它的方法——在另一个 Aggrega 工作区中工作,或创建一个 Release——而不是把你引向一个只会返回空结果的列表。当尚无任何东西读取过工作区时,工具提示会如实说明,而不是报告一个没有人统计过的数量。每一种显示都附带所查找的内容,完整说明会写入 Aggrega 输出通道。在该状态下验证仍会运行:你会得到文档自身即可给出的检查结果——它能否解析,以及其自身结构是否可接受——而需要 Release 的检查会被跳过,直到你选择一个为止。