Das Release wählen, an dem Sie arbeiten
Ausgewähltes Release – eine Anzeige in der Statusleiste und eine Zeile Release oben im Commands-Panel, die jeweils das eine Release nennen, an dem der Editor arbeitet. Alles, was auf ein Release wirkt – Validierung, der Topologiegraph, Build, Vorschau-Build und Pull –, wirkt auf dieses eine. Ein bereits geöffnetes Graph-Panel behält das Release, aus dem es gezeichnet wurde, wenn Sie ein anderes auswählen, und das erneute Anzeigen des Graphen zeichnet das neu ausgewählte. Graph, Build, Vorschau-Build und Pull lesen die Katalogverzeichnisse, gegen die dieses Release gebaut wird: seine eigenen, wo Ihre Workspace-Konfiguration unter workspace.releases welche dafür nennt, und andernfalls die des Workspace – dieselben, die aggrega build --release in einem Terminal liest, sodass ein Fenster jedes Release eines Workspace gegen seinen eigenen Katalog baut, ohne dass ein Flag übergeben werden muss. Das Catalog-Panel, eine Inspektion, die Prüfung der Catalog-Zeile, Hover, Vervollständigung, Go to Definition, Find References und Find Implementations antworten ebenfalls im Sinne des ausgewählten Release: Wo Ihre Workspace-Konfiguration für jedes Release Katalogverzeichnisse nennt, liest jedes die Dokumente des Workspace außer denen in einem Verzeichnis, das nur ein anderes Release liest, sowie die Katalogverzeichnisse, gegen die das ausgewählte Release gebaut wird – sodass ein Name, den mehrere Varianten deklarieren, eine pro Release, zu der des ausgewählten Release aufgelöst wird. Ohne ausgewähltes Release antworten sie im Sinne des Workspace selbst. Siehe Ein Release auswählen.
Ein Release auswählen
Das meiste, was die Erweiterung tut, ist auf ein Release bezogen: welche Katalogverzeichnisse gelesen werden, welche Komponenten aufgelöst werden, welche Lockfile-Pins gelten und welche Befunde ein Dokument erhält. Die Erweiterung arbeitet daher mit jeweils einem ausgewählten Release, und sie zeigt Ihnen in der Statusleiste neben einem Raketensymbol, welches es ist.
Ein Release, das Sie auswählen, merkt sich das jeweilige Editorfenster. Wenn sich der Language Server verbindet, wird eine gemerkte Auswahl mit dem abgeglichen, was der Workspace noch anbietet, und wiederhergestellt, wenn sie noch vorhanden ist; ist sie verschwunden, teilt Ihnen der Editor das mit und greift auf das zurück, was Ihr Workspace vorgibt, womit die Auswahl auch beginnt, wenn Sie in diesem Fenster nichts ausgewählt haben. Diese Antwort ergibt sich, in der Reihenfolge des Vorrangs, aus:
build.authoring_releasein.aggrega-config.yaml, der committeten Einstellung, die ein ganzes Team teilt..aggrega/active-release, einer lokalen Markierungsdatei, die nicht committet wird.- Dem einzigen Release im Workspace, wenn es genau eines gibt.
Klicken Sie auf einen der beiden Indikatoren, um ein anderes Release auszuwählen (oder führen Sie Aggrega: Select Release… über die Command Palette aus). Die Änderung wird sofort wirksam — nichts wird neu gestartet, jede geöffnete YAML-Datei wird gegen das soeben gewählte Release neu geprüft, und das Panel Catalog liest seine Liste dafür erneut; dasselbe geschieht, wenn beim Verbinden des Language Servers ein Release übernommen wird. Das Merken ist lokal für das Editorfenster: Die Auswahl schreibt nichts in Ihren Workspace. Lag Ihr Fokus beim Öffnen der Auswahl auf dem Panel Commands — auf dessen Release-Zeile oder auf einem seiner Bedienelemente —, kehrt er beim Schließen der Auswahl zu diesem Bedienelement zurück, ob Sie ein Release gewählt oder die Auswahl verworfen haben; von anderswo geöffnet, lässt die Auswahl das Panel ohne Fokus.

Angeboten werden die Releases innerhalb des Ordners, an dem sich der Language Server verankert hat, relativ zu diesem benannt, weil er diese Form akzeptiert. Wo ein Release nicht angeboten werden kann, sagt der Editor, wie viele es sind und wo sie liegen, statt sie stillschweigend wegzulassen. Der Language Server liest kein Release über einen Link, der aus diesem Ordner hinausführt, sodass ein Release, das der Dateibaum Ihres Editors über einen hinausführenden Link zeigt — einen Link auf ein Verzeichnis außerhalb oder auf eine Release-Datei außerhalb —, nicht angeboten wird. Die einzige Ausnahme ist ein Link auf eine Release-Datei, die die Workspace-Konfiguration als build.authoring_release oder als Schlüssel von workspace.releases nennt: Dieses Release wird über seinen Link gelesen und angeboten. Beim Öffnen weist die Auswahl in einer eigenen Benachrichtigung darauf hin und nennt mit seinem Pfad relativ zu diesem Ordner jeden solchen Link, der dort steht, wo der Language Server sonst lesen würde: zuerst die Links auf Verzeichnisse, dann die Links auf Dateien. Ein Link, dessen Name auf .yaml oder .yml endet, wird genannt, unabhängig davon, was die Datei enthält, auf die er führt, weil diese Datei nicht gelesen wird, um es herauszufinden.
Wenn Sie eine Auswahl im Workspace selbst festhalten möchten — damit ein frischer Checkout damit beginnt —, tun dies zwei Befehle, und keiner von beiden ändert, woran Sie gerade arbeiten:
- Aggrega: Set the selected Release as this workspace’s default lässt den Language Server das aktuell ausgewählte Release in
.aggrega/active-releaseschreiben. Diese Datei ist lokal für Ihren Checkout und daher der richtige Ort für einen persönlichen Standard. Wo.aggregaoder die Markierung ein Link ist, der aus dem Aggrega-Workspace hinausführt, wird nichts geschrieben, und die Benachrichtigung enthält die eigenen Worte des Compilers zum Grund. - Aggrega: Set authoring_release in .aggrega-config.yaml… öffnet die Konfigurationsdatei, damit Sie
build.authoring_releasesetzen können. Diese Einstellung wird committet und geteilt und hat Vorrang vor der Markierungsdatei. Wo der Language Server meldet, dass die Konfigurationsdatei ein Link ist, der aus dem Aggrega-Workspace hinausführt, wird die Datei nicht geöffnet, und ein Fehler sagt, dass sie aus dem Workspace hinausführt und Aggrega sie daher nicht verwendet; das Bedienelement der Willkommensseite, das eine Workspace-Konfiguration anlegt, verfährt ebenso mit einer Datei, die es bereits vorfindet.
Bietet der Workspace kein Release an — keines konfiguriert, keine Markierung und nicht genau eine Datei als Rückfall —, sagt der Indikator das, und er sagt, welcher von zwei Fällen zutrifft. Er zeigt Release: none selected, wo es Releases zur Auswahl gibt und Sie auf keinem davon sind, und Release: none available, wo der Aggrega-Workspace überhaupt keines angeboten hat. Der zweite Zustand lässt sich nicht durch eine Auswahl beheben, daher nennt sein Tooltip die Auswege daraus — in einem anderen Aggrega-Workspace arbeiten oder ein Release anlegen —, statt Sie zu einer Liste zu schicken, die nur leer sein kann. Wo noch nichts den Workspace gelesen hat, sagt der Tooltip genau das, statt eine Zählung zu melden, die niemand vorgenommen hat. Jede dieser Anzeigen nennt, wonach gesucht wurde, und der vollständige Bericht wird in den Aggrega-Ausgabekanal geschrieben. Die Validierung läuft auch in diesem Zustand: Sie erhalten die Befunde, die ein Dokument für sich allein beantwortet — ob es sich parsen lässt und ob seine eigene Form zulässig ist —, und die Prüfungen, die ein Release benötigen, werden übersprungen, bis Sie eines auswählen.