Выбор сущности 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, пропускаются, пока вы её не выберете.