Страница приветствия
Страница приветствия — собственная страница Aggrega в отдельной вкладке редактора, которая объясняет, что такое Aggrega, а затем перечисляет, что нужно расширению в этой рабочей области, отмечая каждое условие как Met или To do. Каждый шаг предлагает способ создать нужное и способ указать на то, что у вас уже есть, объясняет условие, а уже выполненный шаг ни о чём не спрашивает. Шаг с отметкой Met возвращается к To do, если его условие перестаёт выполняться. Уже выполненный шаг открывается свёрнутым, поэтому страница открывается на оставшейся работе. Каждый шаг также показывает своё текущее значение — корень рабочей области, компилятор, Release, реестры, — набранное крупнее и жирнее пояснений, с предваряющим Selected:, под заголовком, когда шаг свёрнут, и непосредственно над кнопками, когда развёрнут, а если вы ещё ничего не выбрали, говорит об этом словами — None selected., когда выбрать есть из чего, None available., когда выбирать вообще не из чего. Внизу находится флажок, определяющий, открывается ли страница при запуске, — тот же переключатель, что и на экране настроек, — под ним версии расширения и компилятора, которые у вас запущены, и последним — запущен ли языковой сервер и какую версию он сообщает. Значок домика в заголовке панели Commands в любой момент снова открывает страницу. Она не занимает места в представлении Aggrega.
Welcome to Aggrega! открывается в отдельной вкладке редактора. Она объясняет, что такое Aggrega, а затем перечисляет, что нужно расширению в открытой вами рабочей области:
- Рабочая область, которую распознаёт Aggrega, — обнаружение, описанное в разделе Предварительные условия.
- Компилятор, который может запустить этот редактор, — двоичный файл
aggrega, указанный вaggrega.server.binaryPath. - Release, с которым нужно работать, — сборка, предварительный просмотр и граф топологии работают каждый с одной сущностью Release.
- Реестр, из которого выполняется разрешение, — получение зависимостей и поиск в опубликованном каталоге выполняют разрешение по реестрам, указанным в вашей конфигурации.
Каждый шаг объясняет, для чего нужно условие и как редактор его выполняет, поэтому страница — это место, где можно прочитать о продукте, а не просто контрольный список.

Каждый шаг предлагает больше одного пути, и один из них всегда — «у меня это уже есть». Можно создать конфигурацию рабочей области или указать редактору папку, в которой она уже есть; использовать компилятор из вашего PATH, выбрать сборку, которая лежит у вас в другом месте, или загрузить её; создать черновик Release или выбрать один из своих; заполнить официальный хаб, указать собственный реестр или добавить реестр в уже имеющуюся конфигурацию. Здесь нет тупиков, которые выдают вам диалог выбора файла и оставляют шаг невыполненным.
Уже выполненный шаг отмечен галочкой и ни о чём не спрашивает. Страница считывает фактическое состояние, а не задаёт всем одни и те же вопросы, поэтому если вы создали конфигурацию из командной строки, а затем открыли редактор, все шаги будут уже отмечены.
Каждый шаг сворачивается, и страница открывается, показывая то, что ещё нужно. Стрелка в правом верхнем углу каждого шага разворачивает и сворачивает его. Шаг, условие которого уже выполнено, открывается свёрнутым, а невыполненный — с объяснением перед вами, так что читать приходится о работе, которая ещё осталась, а не о сделанной. Свёрнутый шаг сохраняет свой заголовок и все свои кнопки и скрывает только объяснение: когда вы знаете, для чего шаг нужен, вы можете выполнить его, не перечитывая.
Расположение определяется при создании страницы, а после этого им распоряжаетесь вы. Шаг, условие которого выполняется, пока вы его читаете, обновляет свою отметку и остаётся развёрнутым — он не сворачивается под вашим курсором, — а нажатая вами стрелка остаётся в том положении, в которое вы её установили, сколько бы раз страница вокруг неё ни обновлялась. Закрытие и повторное открытие страницы заново считывает условия, и расположение определяется заново. То же происходит со страницей, которая рисуется вместо открытой, когда редактор перезапускает расширения, — как это бывает при добавлении папки в окно, открытое на одной папке: прежняя страница закрывается, а новая рисуется в той же группе вкладок, независимо от того, настроена ли страница на открытие при запуске, так что в окне по-прежнему одна страница, и эта страница следует за рабочей областью, в которой вы находитесь.
Каждый шаг также показывает своё текущее значение, так что страница отвечает на вопрос какой именно, а не только есть ли: корень рабочей области, компилятор, Release и реестры, объявленные в конфигурации. Значение набрано крупнее и жирнее окружающего объяснения, потому что значение, набранное тем же начертанием, что и сплошной текст, приходится искать. Свёрнутый шаг показывает его под заголовком, так что вы можете подтвердить свой выбор, ничего не разворачивая; развёрнутый — в конце объяснения, непосредственно над кнопками, где оно читается последним перед действием. Выбранному значению предшествует Selected:, набранное мельче и светлее самого значения, чтобы метка указывала на значение, а не соперничала с ним.

Если вы ещё ничего не выбрали, шаг говорит об этом словами, а не оставляет пустую строку, которая выглядела бы как ошибка отрисовки страницы, — и различает два состояния, на которые читатель реагирует по-разному. None selected. означает, что выбрать есть из чего, но ничего не выбрано. None available. означает, что выбирать здесь вообще не из чего, поэтому нажатие на «I already have one» этого шага показало бы лишь пустой список, а вам нужен другой путь этого шага. Показать None available. могут только два шага, предлагающие список, — рабочая область и Release. Компилятор указывается по имени, а реестр регистрируется напрямую, поэтому ни у одного из этих шагов нет списка, который мог бы оказаться пустым. У шага реестра есть третье состояние, Not read yet., на случай, когда компилятор не удалось опросить: сообщить, что вы ничего не настроили, когда ответить было некому, значило бы сказать больше, чем знает страница.
Отметка шага следует за его условием в обоих направлениях. Рядом с отметкой каждый шаг словами указывает своё состояние — Met или To do, — потому что сама отметка — это глиф, а глиф сам по себе оставляет своё значение на догадку. Шаг показывает Met, когда его условие становится истинным, и снова To do, если условие позже перестаёт выполняться, — компилятор перестаёт отвечать, выбор Release снимается. Страница при каждом обновлении считывает фактическое состояние, а не запоминает то, что когда-то было истинным, поэтому она никогда не сообщает о том, что вы с тех пор утратили. Там, где утрата важна, о ней также сообщается там, куда вы уже смотрите: строка состояния показывает компилятор, который перестал отвечать, а строки Project folder, Aggrega workspace и Release в верхней части панели Commands называют текущий выбор.
Это обычная вкладка редактора, а не диалог, и сделано это намеренно: каждый шаг просит вас указать на что-то в вашей рабочей области, а диалог закрывал бы файлы, в которых находятся ответы. Она располагается в области редактора, а не в представлении Aggrega, поэтому не занимает места на боковой панели и может рассказать, что представляет собой продукт, — для чего в узкой колонке нет места. Это собственная вкладка Aggrega, которая открывается и закрывается по своим правилам и не предлагает перехода на собственную страницу приветствия редактора.
Это решение находится внизу страницы, по центру, а также в палитре команд. Оба места меняют одну и ту же настройку, aggrega.getStarted.show, записываемую в ваши собственные настройки — никогда не в репозиторий, поэтому ваш выбор не переходит к тем, кто ещё его откроет. Элемент управления внизу — флажок с надписью Show Aggrega welcome page on startup, установленный, пока страница открывается при запуске, — так что он показывает настройку в её текущем состоянии, а не предлагает вам действие, которое бы её изменило. Отключите её на экране настроек — флажок последует; нажмите флажок — последует экран настроек. Это один переключатель в двух местах, а не два переключателя. После нажатия флажок сохраняет фокус клавиатуры, поэтому клавиша Space поочерёдно устанавливает и снимает его.
Отключение лишь прекращает открытие страницы при запуске, а не делает её недоступной, и это не дверь в одну сторону: Aggrega: Get started в палитре команд снова включает настройку и открывает страницу, а Aggrega: Stop opening the welcome page on startup — собственный путь палитры к той же настройке.
На панели Commands рядом с шестерёнкой есть путь обратно к странице. Это значок домика в правом верхнем углу, и его всплывающая подсказка гласит Open the welcome page, — так что путь обратно к странице можно найти, взглянув на представление Aggrega, а не нужно знать, что ввести. Он открывает страницу и оставляет вашу настройку запуска ровно такой, какой вы её задали: повторный просмотр страницы не включает её снова. Это делает команда палитры, потому что снова включить настройку — это решение, а не беглый взгляд.
Внизу страницы показано, что у вас запущено. Там два показания версии: Extension — какую сборку этого расширения загрузил ваш редактор, и Compiler — что о себе сообщает двоичный файл aggrega, запущенный языковым сервером. Показание Extension записывается при сборке расширения, по состоянию его исходного кода в тот момент, в том же виде, в каком собственная сборка компилятора записывает свою версию, — поэтому окно разработки, установленная копия и копия, упакованная из изменённого дерева, каждая сообщают, чем они являются:
- только тег выпуска, например
0.2.0, означает, что сборка — ровно этот выпуск; - тег, за которым следуют число и коммит, например
0.2.0-3-g1a2b3c4, означает сборку из коммита1a2b3c4, через три коммита после этого выпуска, — а только коммит, например1a2b3c4, означает сборку из этого коммита, которому не предшествует ни один выпуск; - суффикс
-dirtyу любого из них означает, что сборка сделана из копии исходного кода с незафиксированными изменениями; devозначает, что сборка сделана там, где историю исходного кода прочитать не удалось.
Ни одно из показаний не записано в страницу — оба считываются при отрисовке страницы, поэтому сборка для разработки сообщает о себе как о таковой, а не показывает пустоту, а перезапуск на другом компиляторе меняет показание. Если показание получить невозможно — расширение собрано без записи о том, какая это сборка, спросить некого, потому что ничего не запущено, или запущенное не ответило, — метка остаётся и сообщает, что версия не была сообщена, поэтому отсутствующее показание никогда не принимается за то, которое вы не заметили.
Последняя строка страницы сообщает, запущен ли языковой сервер и какая это сборка. Она гласит Language server running, starting, not running или failed to start — теми же словами, что строка состояния и уведомления; failed to start означает, что последняя попытка запуска завершилась неудачей и с тех пор ничего не запускалось. Причину сообщает канал вывода Aggrega, а также уведомление, которое появляется, когда не удаётся первый запуск или перезапуск. Пока сервер работает, строка добавляет версию, которую запущенный сервер сообщил о себе, когда расширение к нему подключилось, записанную так же, как версию записывает показание Compiler. Показание Compiler над ней — это другой факт: это то, что сообщает при запросе двоичный файл, из которого был запущен сервер, и они различаются, когда файл по этому пути заменяется, а запущенный из него сервер продолжает работать, поэтому страница показывает оба. Языковой сервер, который не сообщает собственную версию, показывает там version not reported, а не заимствует версию двоичного файла. Строка и два показания над ней следуют за сервером, когда он запускается, останавливается, перезапускается или завершается сбоем, без повторного открытия страницы; шаги сохраняют свои отметки при перезапуске.