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

Языковой сервер

Состояние языкового сервера — индикатор в левой части строки состояния, рядом с индикатором Release, показывающий running, starting или красное not running. Это единственный элемент интерфейса, который присутствует, что бы ни делал компилятор, поэтому именно здесь вы узнаёте, что ничего не запущено, а не догадываетесь об этом по затихшим элементам, — а его подсказка сообщает, какая из двух причин имеет место: ни одна папка здесь не распознаётся Aggrega, или такая папка есть, но сервер к ней не подключён. Щелчок по нему предлагает Start, когда ничего не запущено, и Restart, когда что-то запущено, и выполняет выбранное. См. Когда языковой сервер не запущен.

Когда языковой сервер не запущен

Каждая команда, которую добавляет это расширение, существует с момента его запуска, независимо от того, запущен ли языковой сервер, и лишь две из них ждут сервера, прежде чем указатель команд их покажет: та, что названа ниже, и Aggrega: Attach a Feature to the connection at the cursor, которая показывается только в документе, который языковой сервер определяет как Aggregate или Release. Команда, появляющаяся только после подключения сервера, отсутствовала бы в указателе команд именно тогда, когда она нужнее всего, — когда ничего не запущено и вы ищете способ это запустить.

Индикатор слева в строке состояния — это место, где вы узнаёте, что происходит. Он показывает running, starting или красным not running, а его подсказка объясняет причину: ни одна папка в этом окне не распознаётся Aggrega, или такая папка есть, но сервер к ней не подключён. Щелчок по нему предлагает Start или Restart — в зависимости от ситуации — и выполняет это.

Строка состояния, сообщающая красным, что языковой сервер Aggrega не запущен, и меню, которое открывает её индикатор, с пунктом Start.

Этот индикатор существует потому, что команда, которая не может быть выполнена, ничего не объясняет: указатель команд опускает её, не говоря почему, и ни одна поверхность редактора не показывает подсказку для отключённого элемента управления. Индикатор — это место, где записана причина, и это же место, где вы на неё реагируете.

Неудачный запуск сообщает, что не так с путём к компилятору. Если aggrega.server.binaryPath ни на что не указывает, уведомление гласит Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Не удалось запустить языковой сервер Aggrega: компилятор по пути ⟨path⟩ не найден.); если он указывает на файл, который нельзя запустить, — … ⟨path⟩ is not an executable file. (… ⟨path⟩ не является исполняемым файлом.). ⟨path⟩ — это файл, который расширение пыталось запустить: настройка, начинающаяся с ~/ или ${userHome}, показывается развёрнутой относительно вашей домашней папки, так, как её искали. Оба далее предлагают задать для aggrega.server.binaryPath двоичный файл aggrega и содержат Open binary path setting, открывающую экран настроек на этой единственной настройке, и Show output. Если путь ни на что не указывает, уведомление также содержит Download the compiler и Choose another file перед этими двумя, потому что в этом случае заменять нечего: первая загружает компилятор, как описано в разделе Получение компилятора, а вторая запрашивает имеющийся у вас файл компилятора и указывает на него настройку. Файл, который существует, но не может быть запущен, вы положили туда сами, поэтому это уведомление не предлагает загрузку. Любая другая неудача запуска приводит полученную причину после того же начала, а затем называет запущенный компилятор и настройку, которая его указывает. Канал вывода Aggrega содержит тот же отчёт.

Validate сообщает, что сервер не запущен, и предлагает путь назад. При нажатии, когда языковой сервер не запущен, она отвечает Aggrega: the language server is not running. (Aggrega: языковой сервер не запущен.) — а если последний запуск не удался, далее приводится причина теми словами, которыми была сообщена эта неудача, — с Show output, Open binary path setting и собственной кнопкой Start индикатора в строке состояния.

Панели списков сообщают, что сервер не запущен, а не о сбое. Когда языковой сервер не запущен, панели Registries и Catalog выводят вместо своего списка The Aggrega language server is not running. (Языковой сервер Aggrega не запущен.) с собственной подсказкой индикатора, а нажатие на эту строку запускает сервер. Список панели Plugins получается запуском компилятора как команды, а не от языкового сервера, поэтому если эту команду не удалось запустить, её строка сообщает словами уведомления, что не так с путём, а нажатие на неё открывает настройку.

Aggrega: Open status bar menu не показывается в указателе команд, пока ни один языковой сервер не отвечает: всё, что она предлагает, — это действия над работающим языковым сервером, а ваш редактор не показывает команду, которая не может там выполниться. Она возвращается в тот момент, когда сервер начинает отвечать.

Команда, которая работает без сервера, остаётся в указателе команд, даже если она касается сервера. Aggrega: Toggle the artifact-rendering stage while inspecting записывает предпочтение, а сервер читает это предпочтение при запуске, — поэтому остановленный сервер — самый полезный момент, чтобы его задать, а не причина его скрывать.

Жизненный цикл

Расширение управляет полным жизненным циклом процесса языкового сервера. Когда оно останавливает языковой сервер — при закрытии редактора, при переходе языкового сервера в другую рабочую область Aggrega или когда не остаётся единственной рабочей области, к которой он мог бы подключиться, — оно сначала просит языковой сервер завершиться добровольно, что позволяет завершить выполняемую работу. Если по истечении этого льготного периода языковой сервер всё ещё работает, его просят ещё раз — на этот раз бросить эту работу, а не завершать её. Если он всё ещё не завершился, расширение прибегает к завершению на уровне ОС. Перезапуск — команда перезапуска, изменение aggrega.server.binaryPath или изменение конфигурации, внесённое самим расширением, — ни о чём не просит: он завершает процесс на уровне операционной системы и запускает новый. Каждый из этих шагов сообщается в канал вывода Aggrega, поэтому при медленном завершении видно, какой шаг занимает время и ответил ли языковой сервер вообще. Семантика одинакова на хостах POSIX и Windows.

Языковой сервер, остановившийся без запроса, запускается снова, но ограниченное число раз. Когда работающий сервер завершается, расширение запускает новый; если и он завершается — при запуске, до того как ответил на начальный запрос расширения, или уже во время работы, — он в свою очередь запускается снова, до aggrega.server.respawnAttempts перезапусков в пределах aggrega.server.respawnWindowSeconds секунд. Завершение после последнего из них оставляет сервер остановленным и выводит Aggrega language server has stopped responding. (Языковой сервер Aggrega перестал отвечать.) с указанием команды, которая запускает его снова, и после этого ничто не запускает его снова само по себе — так что сервер, падающий при каждом запуске, перезапускается именно столько раз и не больше. Канал вывода Aggrega описывает каждый шаг словами: что сервер неожиданно остановился и как он завершился, каждый перезапуск и сколько перезапусков допускает настройка, перезапуск, который не поднялся, и почему, и что сервер больше не запускается. Остановка или перезапуск, которые вы запросили, — команда перезапуска, изменение aggrega.server.binaryPath или изменение конфигурации, внесённое самим расширением, — не учитываются, а перезапуск начинает отсчёт заново с нуля. Первый запуск и запрошенный вами перезапуск при неудаче не повторяются: каждый заканчивается уведомлением о том, что языковой сервер не удалось запустить, с указанием причины.

Каждый языковой сервер заполняет панель Problems с нуля тем, что сообщает сам. Когда сервер запускается — первый, перезапущенный, как бы ни был запрошен перезапуск, запущенный снова после неожиданной остановки предыдущего, перенесённый в другую рабочую область Aggrega или запущенный там, где ни один не работал, — панель Problems очищается от всего, что сообщил предыдущий сервер, и каждый открытый файл YAML проверяется новым сервером, как только тот начинает отвечать. Сервер не может отозвать то, что сообщил, а запущенный после него не знает, что это было, поэтому оставшаяся находка была бы такой, за которой не стоит ни один работающий сервер, — после переноса это находка о рабочей области, которую вы покинули. Пока открытые файлы проверяются, находки исчезают и появляются снова. Находка, которую вычисляет только другой запрос, не появляется, пока этот запрос не выполнится снова: находки сборки возвращаются, когда рисуется граф или выполняется сборка или предварительная сборка, предупреждение о расхождении lock-файла — когда рисуется граф (и то и другое сразу, если открыта панель графа для этой сущности Release, поскольку она перерисовывается, когда сервер возвращается), а находки о соглашениях публикации — когда вы запускаете Lint. Сервер, который останавливается и не заменяется — исчерпав перезапуски или не имея рабочей области Aggrega для подключения, — оставляет панель Problems как есть.

Языковой сервер читает конфигурацию при запуске и сохраняет её до остановки. Командная строка читает её заново при каждом запуске, поэтому правка .aggrega-config.yaml или ~/.config/aggrega/config.yaml сразу меняет поведение терминала и ничего не меняет в уже работающем языковом сервере. Поэтому расширение следит за файлами конфигурации, которые, по сообщению работающего сервера, он прочитал, — за путями к файлам, которые Show config перечисляет среди файлов, внёсших вклад, — и когда один из них изменяется на диске, удаляется или появляется снова и, следовательно, больше не совпадает с тем, что прочитал сервер, оно выводит одно предупреждение с именем файла и пояснением, что языковой сервер читает конфигурацию при запуске, с кнопкой Restart server, которая выполняет Aggrega: Start or restart the language server. Несколько записей при одном сохранении вызывают одно предупреждение. Предупреждение не выводится снова для этого файла, пока оно на экране, а после того как вы его закроете, — пока файл снова не изменится; перезапуск начинает наблюдение заново с того, что прочитал перезапущенный сервер. Файл конфигурации, которого не было при запуске сервера, не был прочитан, поэтому за ним не следят и его создание ничего не вызывает; его прочитает следующий запуск. Какие файлы отслеживаются, записывается в канал вывода Aggrega при каждом запуске сервера.

Изменение конфигурации, которое расширение вносит само, применяется перезапуском языкового сервера без запроса. За добавлением или удалением реестра, начальным заполнением реестра со страницы приветствия, добавлением или удалением плагина, созданием конфигурации рабочей области со страницы приветствия и Aggrega: Set authoring_release in .aggrega-config.yaml… в случае, когда ей приходится создать файл, каждый раз следует перезапуск, который во время выполнения отображается как уведомление с именем файла, который сервер собирается прочитать, и ни одно из этих действий не вызывает предупреждения: это изменение вы запросили сами. Если при создании конфигурации рабочей области языковой сервер запускается сам — ни один не работал или он работал для другой папки, — этот запуск читает новый файл, и второго перезапуска не следует. Как только языковой сервер, запущенный после изменения, прочитал его, собственное завершающее сообщение операции дополняется одним предложением о том, что изменение теперь действует, вместо второго уведомления; если перезапуск не удался или не было работающего языкового сервера, чтобы прочитать изменение, это предложение опускается, поскольку изменение тогда есть в файле, но ещё не действует. Установка authoring_release завершается открытием файла, а не предложением, поэтому ничего не добавляет.