Der Language Server
Status des Language Servers – eine Anzeige links in der Statusleiste, neben der Release-Anzeige, die running, starting oder rot not running lautet. Sie ist die eine Oberfläche, die unabhängig davon vorhanden ist, was der Compiler tut; dort erfahren Sie also, dass nichts läuft, statt es aus Oberflächen schließen zu müssen, die verstummt sind – und ihr Tooltip sagt, welcher der beiden Gründe zutrifft: Kein Ordner hier ist einer, den Aggrega erkennt, oder es gibt einen, und der Server ist nicht mit ihm verbunden. Ein Klick darauf bietet Start an, wenn nichts läuft, und Restart, wenn etwas läuft, und führt das Gewählte aus. Siehe Wenn der Language Server nicht läuft.
Wenn der Language Server nicht läuft
Jeder Befehl, den diese Erweiterung beisteuert, existiert ab dem Moment ihres Starts, ob ein Language Server läuft oder nicht, und nur zwei davon warten auf einen Server, bevor der Befehlsindex sie aufführt: der unten genannte und Aggrega: Attach a Feature to the connection at the cursor, der nur in einem Dokument aufgeführt wird, das der Language Server als Aggregate oder als Release meldet. Ein Befehl, der erst entstünde, nachdem sich ein Server verbunden hat, würde genau in dem Fenster im Befehlsindex fehlen, das ihn am dringendsten braucht — dem, in dem nichts läuft und Sie nach dem Weg suchen, es zu starten.
Am Indikator links in der Statusleiste erfahren Sie, was vor sich geht. Er zeigt running, starting oder not running in Rot, und sein Tooltip sagt, warum: Kein Ordner in diesem Fenster ist einer, den Aggrega erkennt, oder es gibt einen und der Server ist nicht mit ihm verbunden. Ein Klick darauf bietet Start oder Restart an — je nachdem, was zutrifft — und führt es aus.

Dieser Indikator existiert, weil ein Befehl, der nicht ausgeführt werden kann, nichts erklärt: Der Befehlsindex lässt ihn weg, statt den Grund zu nennen, und keine Oberfläche des Editors zeigt einen Tooltip auf einem deaktivierten Bedienelement. Am Indikator steht der Grund, und dort handeln Sie auch danach.
Ein fehlgeschlagener Start sagt, was mit dem Pfad des Compilers nicht stimmt. Wo aggrega.server.binaryPath auf nichts verweist, lautet die Benachrichtigung Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Der Aggrega-Language-Server konnte nicht gestartet werden: Der Compiler unter ⟨path⟩ wurde nicht gefunden.); wo er auf eine Datei verweist, die nicht ausgeführt werden kann, lautet sie … ⟨path⟩ is not an executable file. (… ⟨path⟩ ist keine ausführbare Datei.) ⟨path⟩ ist die Datei, die die Erweiterung zu starten versucht hat: Eine Einstellung, die mit ~/ oder ${userHome} beginnt, wird ausgehend von Ihrem Home-Ordner aufgelöst angezeigt, so wie danach gesucht wurde. Beide fordern anschließend dazu auf, aggrega.server.binaryPath auf das aggrega-Binary zu setzen, und bieten Open binary path setting, das den Einstellungsbildschirm bei genau dieser Einstellung öffnet, sowie Show output. Wo der Pfad auf nichts verweist, bietet die Benachrichtigung vor diesen beiden außerdem Download the compiler und Choose another file, weil es dann keinen Compiler zu ersetzen gibt: Ersteres lädt einen herunter, wie unter Den Compiler beziehen beschrieben, und Letzteres fragt nach einer Compiler-Datei, die Sie haben, und richtet die Einstellung darauf aus. Eine Datei, die vorhanden ist und nicht ausgeführt werden kann, haben Sie selbst dort abgelegt, daher bietet diese Benachrichtigung keinen Download an. Jeder andere Startfehler nennt nach demselben Anfang den Grund, der ihm mitgeteilt wurde, und dann den Compiler, der ausgeführt wurde, und die Einstellung, die ihn benennt. Der Aggrega-Ausgabekanal enthält denselben Bericht.
Validate meldet, dass der Server nicht läuft, und bietet den Weg zurück an. Wird es gedrückt, während kein Language Server läuft, antwortet es mit Aggrega: the language server is not running. (Aggrega: Der Language Server läuft nicht.) — gefolgt, wo der letzte Start fehlgeschlagen ist, vom Grund, in den Worten, in denen dieser Fehler gemeldet wurde — mit Show output, Open binary path setting und dem Start des Statusleisten-Indikators.
Die Listen-Panels sagen, dass der Server nicht läuft, statt einen Fehler zu melden. Läuft kein Language Server, zeigen die Panels Registries und Catalog jeweils The Aggrega language server is not running. (Der Aggrega-Language-Server läuft nicht.) anstelle ihrer Liste, mit dem Tooltip des Indikators, und ein Druck auf die Zeile startet den Server. Die Liste des Panels Plugins entsteht durch Ausführen des Compilers als Befehl statt über den Language Server, daher sagt dort, wo dieser Befehl nicht gestartet werden konnte, seine Zeile in den Worten der Benachrichtigung, was mit dem Pfad nicht stimmt, und ein Druck darauf öffnet die Einstellung.
Aggrega: Open status bar menu fehlt im Befehlsindex, solange kein Language Server antwortet: Alles, was es anbietet, ist eine Aktion auf einem laufenden Language Server, und Ihr Editor führt keinen Befehl auf, der dort nicht ausgeführt werden kann. Es erscheint wieder, sobald einer antwortet.
Ein Befehl, der ohne Server funktioniert, bleibt im Befehlsindex, auch wenn er den Server betrifft. Aggrega: Toggle the artifact-rendering stage while inspecting schreibt eine Präferenz, und der Server liest diese Präferenz beim Start — ein gestoppter Server ist daher der nützlichste Moment, sie zu setzen, kein Grund, sie vorzuenthalten.
Lebenszyklus
Die Erweiterung verwaltet den gesamten Lebenszyklus des Language-Server-Prozesses. Wenn sie den Language Server stoppt — beim Schließen des Editors, wenn der Language Server in einen anderen Aggrega-Workspace wechselt oder wenn kein einzelner Workspace mehr übrig ist, an den er sich anbinden kann —, bittet sie den Language Server zuerst, sich kooperativ zu beenden, wodurch laufende Arbeit abgeschlossen werden kann. Arbeitet der Language Server noch, wenn diese Karenzzeit abläuft, wird er noch einmal gebeten — diesmal, diese Arbeit abzubrechen, statt sie abzuschließen. Hat er sich dann immer noch nicht beendet, greift die Erweiterung auf eine Beendigung auf Betriebssystemebene zurück. Ein Neustart — der Neustartbefehl, eine Änderung von aggrega.server.binaryPath oder eine Konfigurationsänderung, die die Erweiterung selbst vorgenommen hat — fragt nicht: Er beendet den Prozess auf Betriebssystemebene und startet einen neuen. Jeder dieser Schritte wird im Aggrega-Ausgabekanal gemeldet, sodass ein langsames Herunterfahren zeigt, welcher Schritt die Zeit braucht und ob der Language Server überhaupt geantwortet hat. Die Semantik ist auf POSIX- und Windows-Hosts identisch.
Ein Language Server, der stoppt, ohne dazu aufgefordert zu sein, wird erneut gestartet, und zwar begrenzt oft. Wenn ein laufender Server endet, startet die Erweiterung einen neuen; endet auch dieser — beim Start, bevor er die Eröffnungsanfrage der Erweiterung beantwortet hat, oder sobald er läuft —, wird er seinerseits erneut gestartet, bis zu aggrega.server.respawnAttempts Neustarts innerhalb von aggrega.server.respawnWindowSeconds Sekunden. Das Ende nach dem letzten davon lässt den Server gestoppt und löst Aggrega language server has stopped responding. (Der Aggrega-Language-Server reagiert nicht mehr.) aus, mit dem Namen des Befehls, der ihn wieder startet, und danach startet ihn nichts mehr von selbst — ein Server, der bei jedem Start abstürzt, wird also so oft erneut gestartet und nicht öfter. Der Aggrega-Ausgabekanal beschreibt jeden Schritt in Worten: dass der Server unerwartet gestoppt ist und wie er geendet hat, jeden Neustart und wie viele die Einstellung erlaubt, einen Neustart, der nicht hochgekommen ist, und warum, und dass er nicht erneut gestartet wird. Ein Stopp oder Neustart, den Sie angefordert haben — der Neustartbefehl, eine Änderung von aggrega.server.binaryPath oder eine Konfigurationsänderung, die die Erweiterung selbst vorgenommen hat —, wird nicht gezählt, und ein Neustart setzt die Zählung auf null zurück. Der erste Start und ein von Ihnen angeforderter Neustart werden bei einem Fehlschlag nicht wiederholt: Jeder endet in der Benachrichtigung, dass der Language Server nicht starten konnte, mit dem Grund.
Jeder Language Server beginnt das Problems-Panel mit dem, was er selbst meldet. Wenn ein Server startet — der erste, ein Neustart, wie auch immer er angefordert wurde, einer, der nach einem unerwarteten Stopp des letzten erneut gestartet wurde, einer, der in einen anderen Aggrega-Workspace verschoben wurde, und einer, der gestartet wurde, wo keiner lief —, wird das Problems-Panel von allem geleert, was der vorherige Server gemeldet hat, und jede geöffnete YAML-Datei wird gegen den neuen geprüft, sobald er antwortet. Ein Server kann nicht zurücknehmen, was er gemeldet hat, und der nach ihm gestartete weiß nicht, was das war, daher wäre ein stehen gelassener Befund einer, für den kein laufender Server einsteht — nach einem Wechsel einer zu dem Workspace, den Sie verlassen haben. Die Befunde verschwinden kurz und erscheinen wieder, während die geöffneten Dateien geprüft werden. Ein Befund, den nur eine andere Anfrage berechnet, bleibt weg, bis diese Anfrage erneut ausgeführt wird: Die Befunde des Builds kommen zurück, wenn der Graph gezeichnet wird oder ein Build oder Vorschau-Build läuft, die Drift-Warnung einer Lockfile, wenn der Graph gezeichnet wird — beide zugleich, wo ein Graph-Panel für dieses Release geöffnet ist, da es neu gezeichnet wird, wenn der Server zurückkommt —, und die Befunde zu den Veröffentlichungskonventionen, wenn Sie Lint ausführen. Ein Server, der stoppt und nicht ersetzt wird — seine Neustarts aufgebraucht oder kein Aggrega-Workspace mehr, an den er sich anbinden kann —, lässt das Problems-Panel, wie es war.
Der Language Server liest seine Konfiguration beim Start und behält sie, bis er stoppt. Die Befehlszeile liest sie bei jedem Lauf neu, daher ändert eine Bearbeitung von .aggrega-config.yaml oder ~/.config/aggrega/config.yaml sofort, was ein Terminal tut, und nichts an einem bereits laufenden Language Server. Deshalb beobachtet die Erweiterung die Konfigurationsdateien, die der laufende Server als gelesen meldet — die Dateipfade, die Show config unter den beitragenden Dateien auflistet —, und wenn sich eine davon auf der Festplatte ändert, gelöscht wird oder wieder erscheint und somit nicht mehr dem entspricht, was der Server gelesen hat, gibt sie eine Warnung aus, die die Datei nennt und sagt, dass der Language Server seine Konfiguration beim Start liest, mit einer Schaltfläche Restart server, die Aggrega: Start or restart the language server ausführt. Mehrere Schreibvorgänge aus einem Speichern lösen eine Warnung aus. Die Warnung wird für diese Datei nicht erneut ausgegeben, solange sie auf dem Bildschirm steht, und nach dem Schließen erst wieder, wenn sich die Datei erneut ändert, und ein Neustart beginnt die Beobachtung neu bei dem, was der neu gestartete Server gelesen hat. Eine Konfigurationsdatei, die beim Start des Servers nicht existierte, wurde nicht gelesen, daher wird sie nicht beobachtet, und ihr Anlegen löst nichts aus; der nächste Start liest sie. Welche Dateien beobachtet werden, wird bei jedem Serverstart in den Aggrega-Ausgabekanal geschrieben.
Eine Konfigurationsänderung, die die Erweiterung selbst vornimmt, wird durch einen Neustart des Language Servers angewendet, ohne zu fragen. Auf das Hinzufügen oder Entfernen einer Registry, das Befüllen einer Registry von der Willkommensseite aus, das Hinzufügen oder Entfernen eines Plugins, das Anlegen der Workspace-Konfiguration von der Willkommensseite aus und Aggrega: Set authoring_release in .aggrega-config.yaml…, wo es die Datei anlegen muss, folgt jeweils ein Neustart, der während seiner Ausführung als Benachrichtigung angezeigt wird, die die Datei nennt, die der Server gleich lesen wird, und keiner davon löst die Warnung aus: Sie haben diese Änderung angefordert. Wo das Anlegen der Workspace-Konfiguration den Language Server selbst startet — keiner lief, oder er lief für einen anderen Ordner —, liest dieser Start die neue Datei, und es folgt kein zweiter Neustart. Sobald ein nach der Änderung gestarteter Language Server sie gelesen hat, fügt der Abschluss der Operation selbst einen Satz hinzu, der sagt, dass die Änderung jetzt wirksam ist, statt einer zweiten Benachrichtigung; wo der Neustart fehlgeschlagen ist oder kein Language Server lief, um die Änderung zu lesen, entfällt der Satz, weil die Änderung dann in der Datei steht und noch nicht wirksam ist. Das Setzen von authoring_release endet mit dem Öffnen der Datei statt mit einem Satz und fügt daher nichts hinzu.