设置扩展
前提条件
- 桌面版 Visual Studio Code 1.85 或更高版本。该扩展通过启动
aggrega程序工作,不提供可在浏览器中替代运行的版本,因此它无法在完全运行于 Web 浏览器中的编辑器(例如 vscode.dev 和 github.dev)中运行。 - 位于你工作区所在机器上的
aggrega编译器。扩展运行aggrega.server.binaryPath设置所指定的编译器:以~/(Windows 上为~\)或${userHome}开头的路径从你在该机器上的主文件夹开始读取,其他路径按原样使用,而纯名称(默认为aggrega)则在PATH上查找。如果找不到,扩展会提出为你下载一个,之后可通过 Aggrega: Select Compiler Version 更改版本;参见获取编译器。 - 一个 Aggrega 识别为工作区根目录的文件夹,位于你打开的文件夹或其上层。Aggrega 读取项目根目录下的一个文件——
.aggrega-config.yaml,其中带有workspace:块——并从打开的文件夹向上逐级查找它。用workspace:块标记根目录是显式的选择,也是首选做法;从未声明过该块的项目仍可通过其他标记被识别,Aggrega 自身的配置参考介绍了这些标记,以及在较大项目中配置能够实现的其他所有功能。
这些都不需要你手动安排:参见欢迎页。
安装扩展
扩展的标识符是 aggrega-ai.aggrega,它在两个地方上架:
- Visual Studio Marketplace,Visual Studio Code 从这里安装扩展;
- Open VSX,供从 Open VSX 安装扩展的编辑器使用。
在编辑器中打开“扩展”视图,搜索 Aggrega,然后安装标识符为 aggrega-ai.aggrega 的条目。
在终端中,将标识符传给 Visual Studio Code 的命令行程序:
code --install-extension aggrega-ai.aggrega扩展以 Visual Studio Code 运行时所用的显示语言显示其自身的文本(命令、设置、视图和消息),前提是已翻译为该语言,否则显示英文;你通过 Configure Display Language 更改的显示语言会在编辑器重启后生效。编译器报告的内容,包括其诊断信息和导入的问题,会按编译器的措辞呈现给你,与在终端中一样。
获取编译器
扩展运行 aggrega.server.binaryPath 所指定的编译器,并在提出获取编译器之前先查找一个。 设置中以 ~/(Windows 上为 ~\)或 ${userHome} 开头的路径,从你在工作区所在机器上的主文件夹开始读取,因此在 Linux 和 macOS 上,~/.local/bin/aggrega 指的是安装脚本放在那里的文件;其他路径按原样使用。纯名称(默认为 aggrega)会在你的 PATH 上查找,Aggrega 输出通道会说明找到的是哪个文件以及它报告的版本。

如果找不到,它会提出下载一个——在欢迎页的编译器步骤中,其中 Download the compiler 与 Use the compiler on my PATH 和 Point at a compiler I have 并列;以及在语言服务器因该路径上没有任何文件而无法启动时发出的通知中。下载过程:
- 提供此扩展支持的最新已发布版本,为你工作区所在机器的操作系统和处理器构建——对于在远程机器、容器或 WSL 上打开的窗口,即为该机器。Releases 附带适用于 64 位 x86 和 64 位 ARM 上的 Linux 和 macOS,以及 64 位 x86 上的 Windows 的二进制文件;在其他任何机器上,下载会被拒绝,并指明该机器;
- 建议使用 Aggrega 安装脚本所用的文件夹——Linux 和 macOS 上为
~/.local/bin,Windows 上为%LOCALAPPDATA%\Programs\aggrega——编译器在其中保存为aggrega,Windows 上为aggrega.exe,你也可以更改该文件夹;版本显示在该询问的标题中; - 在下载任何内容之前请你确认版本和文件,然后显示可以中止的进度;
- 根据该版本的
SHA256SUMS校验文件,删除不匹配的下载并指明它,将文件设为可执行,并用aggrega version -o json运行一次。只有全部通过这三项的文件才会被放置到位,也只有到那时,才会在你自己的设置中将aggrega.server.binaryPath设为该文件。
下载通过编辑器用于扩展的代理进行,该代理由编辑器的 http.proxy 和 http.proxyStrictSSL 设置配置。如果无法读取版本列表或某个文件——你处于离线状态、GitHub 正在限制来自你地址的请求,或请求被拒绝——则不会下载任何内容,设置保持不变,并用一句话说明原因。
它只替换它有权替换的编译器:位于该共享文件夹中的编译器,或它自己下载的编译器——它会在那台机器上用自己的存储记住这一点,而不是记在设置中。如果要求它下载并覆盖你放在其他任何位置的编译器,它会说明自己从不替换这类编译器,并改为提供共享文件夹。
它从不自行升级。 对于它可以替换的编译器,它会在窗口打开时读取版本列表,并针对每个版本提示一次有更新的版本可用;对于你自己为它指定的编译器,它不会询问任何事。
Aggrega: Select Compiler Version 更改你运行的版本,并保持该版本直到你再次更改。 它列出此扩展支持的版本,最新的在前,并标记正在使用的版本。在下载任何内容之前,它会警告:该编译器是这台机器上每个工作区都使用的编译器,因此版本会对所有工作区更改;并且锁文件由其他版本写入的 Release 可能需要重新运行 Pull;你通过 Download and switch 确认。新版本会下载到当前版本旁边,并像任何下载一样接受校验,语言服务器会在其上启动,只有在此之后它才会替换先前的版本。如果它无法启动语言服务器,它会被删除,先前的版本保留,语言服务器会再次在先前的版本上启动。在没有打开 Aggrega 工作区的窗口中,没有可启动的语言服务器,因此由版本检查代替,消息中也会说明这一点。它只在下载可以替换编译器的地方替换编译器;对于你自己放在某处的编译器,它会说明这一点,并改为提供共享文件夹。