Die Willkommensseite
Willkommensseite – Aggregas eigene Seite in einem eigenen Editor-Tab, die erklärt, was Aggrega ist, und dann auflistet, was die Erweiterung in diesem Workspace benötigt, wobei jede Bedingung mit Met oder To do markiert ist. Jeder Schritt bietet einen Weg, das Benötigte zu erstellen, und einen Weg, auf etwas Vorhandenes zu verweisen, erklärt die Bedingung, und ein bereits erfüllter Schritt fragt Sie nichts. Ein mit Met markierter Schritt fällt auf To do zurück, wenn seine Bedingung entfällt. Ein bereits erfüllter Schritt öffnet sich eingeklappt, sodass die Seite mit der verbleibenden Arbeit öffnet. Jeder Schritt zeigt außerdem, wo er gerade steht – die Workspace-Wurzel, den Compiler, das Release, die Registries –, größer und kräftiger gesetzt als die Erläuterung, eingeleitet mit Selected:, unter dem Titel, wenn der Schritt eingeklappt ist, und direkt über den Schaltflächen, wenn er aufgeklappt ist, und sagt es in Worten, wo Sie noch nichts gewählt haben – None selected., wo es etwas zu wählen gibt, None available., wo es überhaupt nichts zur Auswahl gibt. Ihr Ende trägt das Kontrollkästchen, das entscheidet, ob sie beim Start geöffnet wird – derselbe Schalter, den der Einstellungsbildschirm enthält –, darunter die Versionen der Erweiterung und des Compilers, die Sie ausführen, und zuletzt, ob der Language Server läuft und welche Version er meldet. Ein Haus-Symbol in der Titelleiste des Commands-Panels öffnet sie jederzeit erneut. Sie kostet die Aggrega-Ansicht keinen Platz.
Welcome to Aggrega! öffnet sich in einem eigenen Editor-Tab. Die Seite erklärt, was Aggrega ist, und listet dann auf, was die Erweiterung in dem geöffneten Workspace benötigt:
- Ein Workspace, den Aggrega erkennt – die unter Voraussetzungen beschriebene Erkennung.
- Ein Compiler, den dieser Editor ausführen kann – die Binärdatei
aggrega, die inaggrega.server.binaryPathgenannt ist. - Ein Release, auf das gehandelt wird – Build, Vorschau und der Topologiegraph wirken jeweils auf ein Release.
- Eine Registry, aus der aufgelöst wird – das Abrufen von Abhängigkeiten und die Suche im veröffentlichten Katalog lösen gegen die Registries auf, die Ihre Konfiguration nennt.
Jeder Schritt erklärt, wozu die Bedingung dient und wie der Editor sie erreicht, sodass die Seite ein Ort ist, an dem man über das Produkt lesen kann, statt nur eine Checkliste.

Jeder Schritt bietet mehr als einen Weg, und einer davon ist immer „Das habe ich schon“. Sie können eine Workspace-Konfiguration erstellen oder den Editor auf einen Ordner verweisen, der bereits eine enthält; den Compiler in Ihrem PATH verwenden, einen Build auswählen, den Sie an anderer Stelle haben, oder einen herunterladen; ein Release entwerfen oder eines Ihrer eigenen wählen; den offiziellen Hub eintragen, Ihre eigene Registry nennen oder eine zu einer bereits vorhandenen Konfiguration hinzufügen. Nichts hier ist eine Sackgasse, die Ihnen einen Dateidialog vorlegt und den Schritt weiterhin unerledigt lässt.
Ein Schritt, den Sie bereits erfüllt haben, ist abgehakt und fragt Sie nichts. Die Seite liest, was zutrifft, statt allen dieselben Fragen zu stellen; wenn Sie Ihre Konfiguration also auf der Kommandozeile erstellt und dann den Editor geöffnet haben, erscheint jeder Schritt bereits abgehakt.
Jeder Schritt lässt sich einklappen, und die Seite öffnet sich mit dem, was noch fehlt. Ein Pfeil oben rechts in jedem Schritt klappt ihn auf und zu. Ein Schritt, dessen Bedingung bereits erfüllt ist, öffnet sich eingeklappt, und einer, der es nicht ist, öffnet sich mit seiner Erklärung vor Ihnen – so geht es beim Lesen um die Arbeit, die noch vor Ihnen liegt, statt um die, die Sie erledigt haben. Ein eingeklappter Schritt behält seinen Titel und jede seiner Schaltflächen und verbirgt nur die Erklärung: Sobald Sie wissen, wozu ein Schritt dient, können Sie ihn weiterhin nutzen, ohne ihn erneut zu lesen.
Die Anordnung wird beim Erstellen der Seite festgelegt und gehört danach Ihnen. Ein Schritt, der erfüllt wird, während Sie ihn lesen, aktualisiert seine Markierung und bleibt offen – er klappt nicht unter Ihrem Cursor weg –, und ein Pfeil, den Sie betätigen, bleibt, wo Sie ihn hingesetzt haben, wie oft die Seite um ihn herum auch aktualisiert wird. Das Schließen und erneute Öffnen der Seite liest die Bedingungen neu und ordnet sie von Grund auf neu an. Ebenso die Seite, die anstelle einer geöffneten gezeichnet wird, wenn Ihr Editor seine Erweiterungen neu startet – wie er es tut, wenn einem auf einen Ordner geöffneten Fenster ein Ordner hinzugefügt wird: Die bisherige Seite wird geschlossen und eine neue in derselben Tab-Gruppe gezeichnet, unabhängig davon, ob die Seite beim Start geöffnet werden soll, sodass das Fenster weiterhin eine Seite enthält und diese Seite dem Workspace folgt, in dem Sie sich befinden.
Jeder Schritt zeigt außerdem, wo er gerade steht, sodass die Seite beantwortet, welcher, und nicht nur, ob: die Workspace-Wurzel, den Compiler, das Release und die Registries, die die Konfiguration deklariert. Der Wert ist größer und kräftiger gesetzt als die Erklärung um ihn herum, denn einen Wert in derselben Stärke wie eine Textwand muss man suchen. Ein eingeklappter Schritt zeigt ihn unter dem Titel, sodass Sie Ihre Auswahl bestätigen können, ohne etwas aufzuklappen; ein aufgeklappter zeigt ihn am Ende der Erklärung, direkt über den Schaltflächen, wo er das Letzte ist, was Sie vor dem Handeln lesen. Ein gewählter Wert wird mit Selected: eingeleitet, kleiner und leichter gesetzt als der Wert selbst, sodass die Beschriftung auf den Wert verweist, statt mit ihm zu konkurrieren.

Wo Sie noch nichts gewählt haben, sagt der Schritt das in Worten, statt eine leere Zeile zu lassen, die so wirken würde, als sei die Seite nicht richtig gezeichnet worden – und er unterscheidet zwei Zustände, auf die ein Leser unterschiedlich reagiert. None selected. bedeutet, dass es etwas zu wählen gibt und Sie nichts davon gewählt haben. None available. bedeutet, dass es hier überhaupt nichts zur Auswahl gibt; ein Klick auf „Ich habe schon eines“ des Schritts könnte Ihnen also nur eine leere Liste zeigen, und was Sie brauchen, ist sein anderer Weg. Nur die beiden Schritte, die eine Liste anbieten, können None available. anzeigen – der Workspace und das Release. Ein Compiler wird benannt und eine Registry direkt registriert, sodass keiner dieser beiden Schritte eine Liste hat, die leer sein könnte. Der Registry-Schritt hat eine dritte Anzeige, Not read yet., für den Fall, dass der Compiler nicht befragt werden konnte: Ihnen mitzuteilen, dass Sie keine konfiguriert haben, wenn nichts antworten konnte, würde mehr behaupten, als die Seite weiß.
Die Markierung eines Schritts folgt seiner Bedingung in beide Richtungen. Jeder Schritt zeigt seinen Stand in Worten neben der Markierung – Met oder To do –, denn die Markierung selbst ist ein Glyph, und ein Glyph allein lässt seine Bedeutung erraten. Ein Schritt zeigt Met, wenn seine Bedingung zutrifft, und wieder To do, wenn die Bedingung später entfällt – ein Compiler, der nicht mehr antwortet, ein Release, dessen Auswahl aufgehoben wird. Die Seite liest bei jeder Aktualisierung, was zutrifft, statt sich zu merken, was einmal zutraf, und meldet daher nie etwas, das Sie inzwischen verloren haben. Wo ein Wegfall von Bedeutung ist, wird er auch dort gemeldet, wo Sie bereits hinsehen: Die Statusleiste zeigt einen Compiler, der nicht mehr antwortet, und die Zeilen Project folder, Aggrega workspace und Release oben im Commands-Panel nennen die aktuelle Auswahl.
Es ist absichtlich ein gewöhnlicher Editor-Tab und kein Dialog: Jeder Schritt fordert Sie auf, auf etwas in Ihrem eigenen Workspace zu verweisen, und ein Dialog würde die Dateien verdecken, die die Antworten enthalten. Die Seite liegt im Editorbereich statt in der Aggrega-Ansicht, sodass sie keinen Platz in der Seitenleiste kostet und sagen kann, was das Produkt ist – wofür eine schmale Spalte keinen Raum hat. Sie ist Aggregas eigener Tab, wird nach eigenen Regeln erreicht und geschlossen und bietet keinen Weg zur Willkommensseite des Editors.
Die Seite trägt diese Entscheidung zentriert an ihrem Ende, und auch die Command Palette trägt sie. Beide ändern die eine Einstellung aggrega.getStarted.show, die in Ihre eigenen Einstellungen geschrieben wird – nie in das Repository, sodass Ihre Wahl nicht zu anderen gelangt, die es öffnen. Das Steuerelement am Ende ist ein Kontrollkästchen mit der Beschriftung Show Aggrega welcome page on startup, das angehakt ist, solange die Seite beim Start geöffnet wird – es zeigt also die Einstellung, wie sie ist, statt Ihnen die Handlung anzubieten, die sie ändern würde. Schalten Sie sie im Einstellungsbildschirm aus, folgt das Kontrollkästchen; betätigen Sie das Kontrollkästchen, folgt der Einstellungsbildschirm. Es ist ein Schalter an zwei Stellen, nicht zwei Schalter. Das Kontrollkästchen behält den Tastaturfokus, wenn es betätigt wird, sodass die Leertaste es abwechselnd an- und abhakt.
Das Ausschalten verhindert, dass die Seite beim Start geöffnet wird, macht sie aber nicht unerreichbar, und es ist keine Einbahnstraße: Aggrega: Get started in der Command Palette schaltet sie wieder ein und öffnet sie, und Aggrega: Stop opening the welcome page on startup ist der eigene Weg der Palette zu derselben Einstellung.
Das Commands-Panel bietet neben dem Zahnrad einen Weg zurück zur Seite. Es ist das Haus-Symbol oben rechts, und sein Tooltip lautet Open the welcome page – so finden Sie den Weg zurück zur Seite, indem Sie auf die Aggrega-Ansicht schauen, statt wissen zu müssen, was Sie eintippen müssen. Es öffnet die Seite und lässt Ihre Starteinstellung genau so, wie Sie sie gesetzt haben: Ein erneuter Blick auf die Seite schaltet sie nicht wieder ein. Das tut der Befehl in der Palette, denn das Wiedereinschalten ist eine Entscheidung und kein Blick.
Die Seite meldet an ihrem Ende, was Sie ausführen. Dort stehen zwei Versionsangaben: Extension, welchen Build dieser Erweiterung Ihr Editor geladen hat, und Compiler, was die vom Language Server ausgeführte Binärdatei aggrega über sich selbst sagt. Die Extension-Angabe wird beim Bauen der Erweiterung aus dem Zustand ihres Quellcodes zu diesem Zeitpunkt festgehalten, in derselben Form, die der Build des Compilers für seine Version verwendet – so sagen ein Entwicklungsfenster, eine installierte Kopie und eine aus einem bearbeiteten Baum gepackte Kopie jeweils, welche sie sind:
- ein Release-Tag allein, etwa
0.2.0, bedeutet, dass der Build genau dieses Release ist; - ein Tag, gefolgt von einer Anzahl und einem Commit, etwa
0.2.0-3-g1a2b3c4, bedeutet einen Build aus Commit1a2b3c4, drei Commits nach diesem Release – und ein Commit allein, etwa1a2b3c4, bedeutet einen Build aus diesem Commit, dem kein Release vorausgeht; - ein Suffix
-dirtyan einer dieser Angaben bedeutet, dass der Build aus einer Kopie des Quellcodes mit nicht committeten Änderungen erstellt wurde; devbedeutet, dass der Build an einem Ort erstellt wurde, an dem die Historie des Quellcodes nicht gelesen werden konnte.
Keine der beiden Angaben ist fest in die Seite geschrieben – beide werden gelesen, wenn die Seite gezeichnet wird, sodass sich ein Entwicklungs-Build als solcher zu erkennen gibt, statt nichts anzuzeigen, und ein Neustart mit einem anderen Compiler die Angabe ändert. Wo eine Angabe nicht ermittelt werden kann – die Erweiterung wurde gebaut, ohne festzuhalten, welcher Build sie ist, es läuft nichts, das man fragen könnte, oder was läuft, hat nicht geantwortet –, bleibt die Beschriftung stehen und sagt, dass die Version nicht gemeldet wurde, sodass eine fehlende Angabe nie mit einer verwechselt wird, die Sie übersehen haben.
Die letzte Zeile der Seite sagt, ob der Language Server läuft und welcher Build er ist. Sie lautet Language server running, starting, not running oder failed to start, mit denselben Worten, die Statusleiste und Benachrichtigungen verwenden; failed to start bedeutet, dass der letzte Startversuch fehlgeschlagen ist und seitdem keiner gelaufen ist. Der Aggrega-Ausgabekanal nennt den Grund, ebenso die Benachrichtigung, die ausgegeben wird, wenn der erste Start oder ein Neustart fehlschlägt. Solange der Server läuft, ergänzt die Zeile die Version, die der laufende Server beim Verbinden der Erweiterung über sich gemeldet hat, so geschrieben, wie die Compiler-Angabe eine Version schreibt. Die Compiler-Angabe darüber ist eine andere Tatsache: Sie ist das, was die Binärdatei, aus der der Server gestartet wurde, auf Nachfrage sagt, und die beiden unterscheiden sich, wenn die Datei unter diesem Pfad ersetzt wird, während der daraus gestartete Server weiterläuft; deshalb zeigt die Seite beide. Ein Language Server, der keine eigene Version meldet, zeigt dort version not reported, statt die der Binärdatei zu übernehmen. Die Zeile und die beiden Angaben darüber folgen dem Server, während er startet, stoppt, neu startet oder fehlschlägt, ohne dass die Seite erneut geöffnet wird; die Schritte behalten ihre Markierungen über einen Neustart hinweg.