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