Настройка расширения
Предварительные условия
- Visual Studio Code 1.85 или новее, в настольной версии. Расширение работает, запуская программу
aggrega, и не предоставляет версии, которую мог бы выполнить вместо неё браузер, поэтому оно не работает в редакторах, целиком выполняющихся в веб-браузере, таких как 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 содержат двоичные файлы для Linux и macOS на 64-битных x86 и 64-битных ARM и для Windows на 64-битных x86; на любой другой машине загрузка отклоняется с указанием этой машины;
- предлагает папку, которую используют установочные скрипты Aggrega, —
~/.local/binв Linux и macOS,%LOCALAPPDATA%\Programs\aggregaв Windows, — где компилятор сохраняется какaggregaилиaggrega.exeв Windows, и позволяет её изменить; версия указана в заголовке вопроса; - просит вас подтвердить версию и файл, прежде чем что-либо будет загружено, а затем показывает ход загрузки, который можно остановить;
- проверяет файл по
SHA256SUMSвыпуска, удаляя несовпадающую загрузку и сообщая об этом, делает файл исполняемым и один раз запускает его сaggrega version -o json. На место помещается только файл, прошедший все три проверки, и только после этогоaggrega.server.binaryPathустанавливается на него в ваших собственных настройках.
Загрузка идёт через прокси, который редактор использует для расширений, как его настраивают параметры http.proxy и http.proxyStrictSSL. Если список выпусков или файл прочитать не удаётся — вы не в сети, GitHub ограничивает запросы с вашего адреса или запрос отклонён, — ничего не загружается, настройка остаётся прежней, и одно предложение объясняет причину.
Оно заменяет только тот компилятор, который вправе заменить: находящийся в этой общей папке или загруженный им самим, что оно запоминает на этой машине в собственном хранилище, а не в настройке. Если его просят загрузить компилятор поверх того, который вы поместили в любое другое место, оно сообщает, что никогда такой не заменяет, и вместо этого предлагает общую папку.
Оно никогда не обновляется само. Для компилятора, который оно может заменить, оно читает список выпусков при открытии окна и сообщает — по одному разу для каждой версии, — что доступен более новый выпуск; о компиляторе, на который вы указали сами, оно ничего не спрашивает.
Aggrega: Select Compiler Version меняет версию, которую вы запускаете, и сохраняет её, пока вы снова её не измените. Команда перечисляет выпуски, с которыми работает это расширение, начиная с новейшего, и отмечает используемый. Прежде чем что-либо загружать, она предупреждает, что этот компилятор используют все рабочие области на этой машине, поэтому версия меняется для всех них, и что для сущности Release, файл блокировки которой записала другая версия, может потребоваться снова выполнить Pull; вы подтверждаете кнопкой Download and switch. Новая версия загружается рядом с текущей и проверяется, как и любая загрузка, на ней запускается языковой сервер, и только после этого она заменяет прежнюю. Если языковой сервер на ней не запускается, она удаляется, прежняя остаётся, и языковой сервер снова запускается на ней. В окне без открытой рабочей области Aggrega запускать нечего, поэтому вместо этого выполняется проверка версии, о чём сообщает и сообщение. Компилятор заменяется только там, где это допустимо для загрузки; для компилятора, который вы сами куда-то поместили, команда сообщает об этом и вместо этого предлагает общую папку.