Einstellungen
Das Zahnrad oben rechts im Panel Commands öffnet sie — es ist die eigene Einstellungsseite des Editors, auf diese Erweiterung eingegrenzt, und die einzige Einstellungsoberfläche, die es gibt. Alles Folgende ist auch über den gewöhnlichen Settings-Editor und über Ihre Einstellungsdatei erreichbar.

Jede dieser Einstellungen gehört Ihnen, nicht dem Projekt. Jede beschreibt Ihre eigene Umgebung oder Ihre eigenen Lesegewohnheiten — wo Ihr Binary liegt, wie lange vor einer erneuten Validierung gewartet wird, wie viele Neustarts toleriert werden, ob Werte angezeigt werden, die man Ihnen über die Schulter mitlesen könnte, wie ein Panel gezeichnet werden soll —, daher ist jede auf Ihre Benutzereinstellungen beschränkt und auf Ihre Remote-Einstellungen, wenn Sie auf einem entfernten oder containerisierten Host arbeiten. Letzteres ist besonders für den Binary-Pfad wichtig: Der Compiler läuft auf dem Host, auf dem auch die Erweiterung läuft, sodass sich der Pfad zwischen Ihrem Laptop und einem Container unterscheiden kann und jeder Host seinen eigenen Wert behält.
Die Folge ist gewollt: Ein Repository kann keine dieser Einstellungen für jemanden festlegen, der es öffnet. Eine davon in eine .vscode/settings.json des Workspace zu schreiben, hat keine Wirkung — der Editor markiert sie dort als nicht anwendbar und verwendet weiterhin Ihren Wert. Wenn Sie eine Auswahl im Workspace selbst festhalten möchten, sind die beiden Release-Befehle unter Ein Release auswählen diejenigen, die das tun, und sie schreiben .aggrega/active-release oder .aggrega-config.yaml statt einer Editoreinstellung.
| Einstellung | Standard | Zweck |
|---|---|---|
aggrega.getStarted.show | true | Ob die Willkommensseite beim Start geöffnet wird. Drei Oberflächen verstellen diese eine Einstellung und bleiben synchron: das Kontrollkästchen am Fuß der Seite selbst, Aggrega: Stop opening the welcome page on startup und Aggrega: Get started. Das Ausschalten verhindert, dass sich die Seite öffnet, ohne sie zu entfernen; das Wiedereinschalten mit Aggrega: Get started öffnet sie auch. |
aggrega.server.binaryPath | aggrega | Pfad zur Binärdatei aggrega. Ein einfacher Name wird in PATH gesucht; ein Pfad, der mit ~/ (~\ unter Windows) oder ${userHome} beginnt, wird aus Ihrem Home-Ordner auf dem Host gelesen, auf dem die Erweiterung läuft; jeder andere Pfad wird so verwendet, wie er geschrieben ist. |
aggrega.server.debounceMs | 300 | Debounce-Fenster für die proaktive Validierung bei Änderungen. |
aggrega.server.respawnAttempts | 5 | Wie oft der Language Server innerhalb des unten angegebenen Fensters erneut gestartet wird, nachdem er ohne Aufforderung angehalten hat, bevor die Erweiterung ihn angehalten lässt und die Benachrichtigung auslöst, dass er nicht mehr antwortet. Ein erneut gestarteter Server, der anhält, bevor er geantwortet hat, zählt genauso wie einer, der während des Betriebs anhält. Siehe Lebenszyklus. |
aggrega.server.respawnWindowSeconds | 180 | Gleitendes Fenster in Sekunden, über das diese Neustarts gezählt werden. |
aggrega.server.restartGraceSeconds | 5 | Karenzfenster, bevor die Erweiterung den Language Server nach einer Änderung von binaryPath automatisch neu startet. Die Statusleiste zeigt einen Countdown; das Schnellaktionsmenü bietet Restart now und Cancel restart an. |
aggrega.server.buildOnInspect | false | Führt beim Inspizieren eines Graphen die Artefakt-Rendering-Phase aus, sodass die Hinweise, die aggrega build beim Rendern ausgibt, auch als Editorprobleme erscheinen. Es fügt keine der Prüfungen hinzu, an denen ein Build abbricht. Das Inspizieren kostet mehr, wenn sie läuft; nichts wird auf die Festplatte geschrieben. |
aggrega.graph.showSensitiveValues | false | Zeigt im Topologiegraphen die Werte, die ein Feature als sensibel deklariert, und stellt ein als Wert übergebenes Credential im Klartext dar; solange dies aktiviert ist, fordert die Graph-Anfrage sie beim Language Server an. Bleibt es deaktiviert, hält der Language Server sie aus dem gesendeten Graphen zurück, und sie werden vor dem Zeichnen des Graphen erneut entfernt. |
aggrega.operations.layout | buttons | Wie das Panel Commands seine Gruppen zeichnet — buttons setzt jede Operation in einen einzigen umbrechenden Fluss von Schaltflächen, ohne dass zwischen einer Gruppe und der nächsten etwas gezeichnet wird, sections macht jede Gruppe zu einem Abschnitt, den Sie unter seinem eigenen Titel öffnen. In beiden Fällen dieselben Gruppen, dieselben Operationen, dieselbe Reihenfolge. |
aggrega.notifications.toastDebounceMode | time | Wie oft der Hinweis, dass ein Release kein Lockfile hat, für Arbeit erneut angezeigt wird, die Sie nicht angefordert haben, etwa einen geöffneten Graphen, der nach dem Speichern neu gezeichnet wird: time zeigt ihn erneut, sobald seit dem Schließen des letzten toastThrottleSeconds vergangen sind, session zeigt ihn einmal, bis der Language Server neu startet. Ein Build, eine Preview oder ein von Ihnen geöffneter Graph, der wegen eines fehlenden Lockfiles abgelehnt wird, zeigt den Hinweis immer. |
aggrega.notifications.toastThrottleSeconds | 300 | Sekunden nach dem Schließen des Hinweises auf ein fehlendes Lockfile, bevor er für nicht angeforderte Arbeit erneut angezeigt wird. Wird nur gelesen, wenn toastDebounceMode auf time steht. |