Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Настройка расширения

Предварительные условия

  • 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:

Terminal window
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 сообщается, какой файл был найден и какую версию он сообщает.

Шаг компилятора на странице приветствия, отмеченный как невыполненный, с вариантами Use the compiler on my PATH, Point at a compiler I have и Download the compiler.

Если ничего не найдено, оно предлагает загрузить компилятор — на шаге компилятора на странице приветствия, где 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 запускать нечего, поэтому вместо этого выполняется проверка версии, о чём сообщает и сообщение. Компилятор заменяется только там, где это допустимо для загрузки; для компилятора, который вы сами куда-то поместили, команда сообщает об этом и вместо этого предлагает общую папку.