Вибір сутності Release, з якою ви працюєте
Вибраний Release — індикатор у рядку стану й рядок Release у верхній частині панелі Commands, кожен з яких називає ту єдину сутність Release, з якою працює редактор. Усе, що діє на Release, — перевірка, граф топології, збирання, попереднє збирання й отримання залежностей — діє на неї. Уже відкрита панель графа зберігає Release, за яким її намальовано, коли ви вибираєте інший, а повторний показ графа малює щойно вибраний. Граф, збирання, попереднє збирання й отримання залежностей читають каталогові директорії, з якими збирається цей Release: його власні, якщо конфігурація робочої області зазначає їх для нього в workspace.releases, а інакше — директорії робочої області; це ті самі директорії, які читає aggrega build --release у терміналі, тож одне вікно збирає кожен Release робочої області з його власним каталогом без передавання будь-якого прапорця. Панель Catalog, інспекція, перевірка в рядку Catalog, наведення, автодоповнення, Go to Definition, Find References і Find Implementations також відповідають у термінах вибраного Release: якщо конфігурація робочої області зазначає каталогові директорії для кожного Release, кожна з цих функцій читає документи робочої області, крім тих, що містяться в директорії, яку читає лише інший Release, і каталогові директорії, з якими збирається вибраний Release, — тож ім’я, оголошене кількома варіантами, по одному на Release, розв’язується у варіант вибраного Release. Коли Release не вибрано, вони відповідають у термінах самої робочої області. Див. Вибір Release.
Вибір Release
Більшість того, що робить розширення, прив’язано до сутності Release: які директорії каталогу читаються, які компоненти розв’язуються, які закріплення lockfile застосовуються і які зауваження отримує документ. Тому розширення працює з однією вибраною сутністю Release за раз і показує, з якою саме, у рядку стану поруч зі значком ракети.
Вибрану вами сутність Release запам’ятовує це вікно редактора. Коли мовний сервер підключається, запам’ятований вибір звіряється з тим, що робочий простір досі пропонує, і відновлюється, якщо він досі там є; якщо його вже немає, редактор повідомляє вам про це й повертається до того, що випливає з вашого робочого простору, — саме звідси починається вибір, якщо ви нічого не вибрали в цьому вікні. Ця відповідь береться, у порядку пріоритету, з:
build.authoring_releaseу.aggrega-config.yaml— зафіксованого в репозиторії налаштування, спільного для всієї команди..aggrega/active-release— локального файлу-маркера, який не фіксується в репозиторії.- Єдиної сутності Release у робочому просторі, якщо вона рівно одна.
Клацніть будь-який з індикаторів, щоб вибрати іншу сутність Release (або виконайте Aggrega: Select Release… з палітри команд). Зміна набуває чинності негайно — нічого не перезапускається, кожен відкритий файл YAML повторно перевіряється відносно щойно вибраної сутності Release, а панель Catalog знову читає для неї свій список; те саме відбувається, коли сутність Release приймається під час підключення мовного сервера. Запам’ятовування локальне для вікна редактора: вибір нічого не записує у ваш робочий простір. Якщо під час відкриття засобу вибору фокус був на панелі Commands — на її рядку Release або на будь-якому з її елементів керування, — він повертається до цього елемента після закриття засобу вибору, незалежно від того, чи вибрали ви сутність Release, чи закрили його; якщо відкрити його з будь-якого іншого місця, засіб вибору залишає панель без фокуса.

Пропоновані сутності Releases — це ті, що розташовані всередині теки, до якої прив’язався мовний сервер, і названі відносно неї, бо саме таку форму він приймає. Якщо сутність Release не можна запропонувати, редактор повідомляє, скільки їх і де вони розташовані, а не пропускає їх мовчки. Мовний сервер не читає жодної сутності Release через посилання за межі цієї теки, тож сутність Release, яку дерево файлів вашого редактора показує через посилання, що веде назовні, — посилання на директорію ззовні або на файл Release ззовні, — не пропонується. Єдиний виняток — посилання на файл Release, який конфігурація робочого простору називає як build.authoring_release або як ключ workspace.releases: таку сутність Release читають через її посилання й пропонують. Під час відкриття засобу вибору про це повідомляє окреме сповіщення, що називає за шляхом відносно цієї теки кожне таке посилання, розташоване там, де мовний сервер інакше читав би: спершу посилання на директорії, потім посилання на файли. Посилання, назва якого закінчується на .yaml або .yml, називається незалежно від того, що містить файл, до якого воно веде, бо цей файл не читають, щоб це з’ясувати.
Якщо ви хочете, щоб вибір було записано в самому робочому просторі — щоб новий checkout починався з нього, — це роблять дві команди, і жодна з них не змінює того, над чим ви працюєте просто зараз:
- Aggrega: Set the selected Release as this workspace’s default доручає мовному серверу записати поточну вибрану сутність Release у
.aggrega/active-release. Цей файл локальний для вашого checkout, тож це слушне місце для особистого типового значення. Якщо.aggregaабо маркер — це посилання, що веде за межі робочого простору Aggrega, нічого не записується, а сповіщення наводить причину словами самого компілятора. - Aggrega: Set authoring_release in .aggrega-config.yaml… відкриває файл конфігурації, щоб ви могли задати
build.authoring_release. Це налаштування фіксується в репозиторії та є спільним, і воно має перевагу над файлом-маркером. Якщо мовний сервер повідомляє, що файл конфігурації — це посилання, що веде за межі робочого простору Aggrega, файл не відкривається, а помилка повідомляє, що він веде за межі робочого простору, тож Aggrega його не використовує; елемент керування на сторінці привітання, що створює конфігурацію робочого простору, робить те саме з файлом, який знаходить уже наявним.
Якщо робочий простір не пропонує жодної сутності Release — нічого не налаштовано, немає маркера й немає рівно одного файлу, до якого можна повернутися, — індикатор повідомляє про це й указує, яке з двох положень правдиве. Він показує Release: none selected (Release: не вибрано), коли є сутності Releases для вибору, але ви не перебуваєте на жодній із них, і Release: none available (Release: немає доступних), коли робочий простір Aggrega не запропонував жодної. Друге — не той стан, який можна розв’язати вибором, тож його підказка називає шляхи виходу з нього — працювати в іншому робочому просторі Aggrega або створити сутність Release, — а не скеровує вас до списку, який може повернутися лише порожнім. Якщо робочий простір ще ніщо не прочитало, підказка повідомляє про це, а не показує число, якого ніхто не рахував. Кожне з цих показань містить те, що шукали, а повний звіт записується в канал виводу Aggrega. Валідація в цьому стані все одно виконується: ви отримуєте зауваження, на які документ відповідає сам, — чи він розбирається і чи допустима його власна структура, — а перевірки, яким потрібна сутність Release, пропускаються, доки ви її не виберете.