Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Выбор сущности 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 запоминается этим окном редактора. Когда языковой сервер подключается, запомненный выбор сверяется с тем, что рабочая область ещё предлагает, и восстанавливается, если он ещё доступен; если его больше нет, редактор сообщает вам об этом и возвращается к тому, что подразумевает ваша рабочая область, — именно отсюда начинается выбор, если вы ничего не выбрали в этом окне. Этот ответ берётся, в порядке приоритета, из:

  1. build.authoring_release в .aggrega-config.yaml — зафиксированной в репозитории настройки, общей для всей команды.
  2. .aggrega/active-release — локального файла-маркера, который не фиксируется в репозитории.
  3. Единственной сущности Release в рабочей области, если она ровно одна.

Щёлкните любой из индикаторов, чтобы выбрать другую сущность Release (или выполните Aggrega: Select Release… из палитры команд). Изменение вступает в силу немедленно — ничего не перезапускается, каждый открытый файл YAML заново проверяется относительно только что выбранной сущности Release, а панель Catalog заново читает для неё свой список; то же происходит, когда сущность Release принимается при подключении языкового сервера. Запоминание локально для окна редактора: выбор ничего не записывает в вашу рабочую область. Если при открытии средства выбора фокус находился на панели Commands — на её строке Release или на любом из её элементов управления, — он возвращается к этому элементу при закрытии средства выбора, выбрали ли вы сущность Release или закрыли его; при открытии из любого другого места средство выбора оставляет панель без фокуса.

Средство выбора Release, показывающее четыре Releases рабочего пространства по их путям, в то время как строка 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, пропускаются, пока вы её не выберете.