Налаштування
Шестерня у правому верхньому куті панелі Commands відкриває їх — це власна сторінка налаштувань редактора, відфільтрована за цим розширенням, і іншого інтерфейсу налаштувань немає. Усе, що наведено нижче, також доступне зі звичайного редактора Settings і з вашого файлу налаштувань.

Кожне з цих налаштувань належить вам, а не проєкту. Кожне описує ваше власне середовище або ваші звички читання — де розташований ваш бінарний файл, скільки чекати перед повторною валідацією, скільки перезапусків допускати, чи показувати значення, які можна прочитати через ваше плече, як ви хочете бачити відображення панелі, — тому кожне обмежене вашими користувацькими налаштуваннями, а під час роботи на віддаленому або контейнеризованому хості — вашими віддаленими налаштуваннями. Остання частина особливо важлива для шляху до бінарного файлу: компілятор працює на тому самому хості, що й розширення, тож шлях може відрізнятися на вашому ноутбуці та в контейнері, і кожен хост зберігає власне значення.
Цей наслідок навмисний: репозиторій не може закріпити жодне з цих налаштувань для того, хто його відкриває. Запис такого налаштування до .vscode/settings.json робочої області не має ефекту — редактор позначає його як незастосовне там і продовжує використовувати ваше значення. Якщо ви хочете, щоб вибір був записаний у самій робочій області, це роблять дві команди для сутності Release з розділу Вибір Release, і вони записують .aggrega/active-release або .aggrega-config.yaml, а не налаштування редактора.
| Налаштування | За замовчуванням | Призначення |
|---|---|---|
aggrega.getStarted.show | true | Чи відкривається сторінка привітання під час запуску. Це одне налаштування змінюють три елементи інтерфейсу, і вони залишаються узгодженими: прапорець унизу самої сторінки, Aggrega: Stop opening the welcome page on startup і Aggrega: Get started. Вимкнення припиняє відкриття сторінки, а не видаляє її; повторне ввімкнення за допомогою Aggrega: Get started також відкриває її. |
aggrega.server.binaryPath | aggrega | Шлях до двійкового файлу aggrega. Просте ім’я шукається в PATH; шлях, що починається з ~/ (~\ у Windows) або ${userHome}, зчитується з вашої домашньої папки на хості, де працює розширення; будь-який інший шлях використовується так, як записано. |
aggrega.server.debounceMs | 300 | Вікно усунення брязкоту для випереджальної валідації під час змін. |
aggrega.server.respawnAttempts | 5 | Скільки разів у межах наведеного нижче вікна мовний сервер запускається знову після того, як він зупинився без запиту, перш ніж розширення залишить його зупиненим і видасть сповіщення про те, що сервер перестав відповідати. Повторно запущений сервер, який зупинився до того, як відповів, враховується так само, як і той, що зупинився під час роботи. Див. Життєвий цикл. |
aggrega.server.respawnWindowSeconds | 180 | Ковзне вікно в секундах, у межах якого підраховуються ці перезапуски. |
aggrega.server.restartGraceSeconds | 5 | Пільгове вікно перед тим, як розширення автоматично перезапустить мовний сервер після зміни binaryPath. Рядок стану показує зворотний відлік; меню швидких дій пропонує Restart now і Cancel restart. |
aggrega.server.buildOnInspect | false | Запускати етап рендерингу артефактів під час інспектування графа, щоб рекомендації, які aggrega build видає під час рендерингу, також з’являлися як проблеми в редакторі. Він не додає жодної з перевірок, на яких збірка зупиняється. Інспектування при цьому коштує дорожче; на диск нічого не записується. |
aggrega.graph.showSensitiveValues | false | Показувати в графі топології значення, які сутність Feature оголошує чутливими, відображаючи облікові дані, передані за значенням, у відкритому вигляді; поки налаштування ввімкнене, запит графа запитує їх у мовного сервера. Якщо його вимкнено, мовний сервер не включає їх до графа, який надсилає, і вони знову видаляються перед відображенням графа. |
aggrega.operations.layout | buttons | Як панель Commands відображає свої групи — buttons розміщує всі операції в одному потоці кнопок із перенесенням, нічого не малюючи між групами, sections робить кожну групу розділом, який розгортається під власним заголовком. В обох випадках групи, операції та порядок однакові. |
aggrega.notifications.toastDebounceMode | time | Як часто сповіщення про те, що сутність Release не має lock-файлу, показується повторно для роботи, якої ви не запитували, наприклад для відкритого графа, перемальованого після збереження: time показує його знову, коли від закриття попереднього минуло toastThrottleSeconds, session показує його один раз до перезапуску мовного сервера. Build, Preview або відкритий вами граф, відхилені через відсутність lock-файлу, завжди показують сповіщення. |
aggrega.notifications.toastThrottleSeconds | 300 | Кількість секунд після закриття сповіщення про відсутній lock-файл, перш ніж воно буде показане знову для роботи, якої ви не запитували. Зчитується, лише коли toastDebounceMode має значення time. |