Налаштування розширення
Передумови
- 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 немає мовного сервера, який можна запустити, тож замість нього виконується перевірка версії, про що повідомляє й повідомлення. Компілятор замінюється лише там, де це дозволено для завантаження; щодо компілятора, який ви самі десь розмістили, команда повідомляє про це й натомість пропонує спільну теку.