Ustawienia
Otwiera je koło zębate w prawym górnym rogu panelu Commands — to własna strona ustawień edytora, zawężona do tego rozszerzenia, i jest to jedyne miejsce z ustawieniami. Wszystko poniżej jest też dostępne ze zwykłego edytora Settings oraz z pliku ustawień.

Każde z tych ustawień należy do użytkownika, a nie do projektu. Każde opisuje własne środowisko lub własne nawyki czytania — gdzie znajduje się plik binarny, jak długo czekać przed ponowną walidacją, ile ponownych uruchomień tolerować, czy pokazywać wartości, które można by odczytać przez ramię, jak ma być rysowany panel — dlatego każde jest ograniczone do ustawień użytkownika, a podczas pracy na zdalnym lub skonteneryzowanym hoście do ustawień zdalnych. Ta ostatnia część ma znaczenie zwłaszcza dla ścieżki do pliku binarnego: kompilator działa na tym samym hoście co rozszerzenie, więc ścieżka może się różnić między laptopem a kontenerem, a każdy host przechowuje własną wartość.
Ta konsekwencja jest zamierzona: repozytorium nie może przypiąć żadnego z tych ustawień dla osoby, która je otwiera. Zapisanie któregoś z nich w pliku .vscode/settings.json obszaru roboczego nie ma żadnego efektu — edytor oznacza je tam jako niemające zastosowania i nadal używa wartości użytkownika. Aby zapisać wybór w samym obszarze roboczym, należy użyć dwóch poleceń dotyczących encji Release opisanych w sekcji Wybór Release; zapisują one .aggrega/active-release lub .aggrega-config.yaml, a nie ustawienie edytora.
| Ustawienie | Domyślnie | Przeznaczenie |
|---|---|---|
aggrega.getStarted.show | true | Czy strona powitalna otwiera się przy uruchomieniu. To jedno ustawienie zmieniają trzy elementy interfejsu, które pozostają ze sobą zgodne: pole wyboru u dołu samej strony, Aggrega: Stop opening the welcome page on startup oraz Aggrega: Get started. Wyłączenie go sprawia, że strona przestaje się otwierać, ale nie zostaje usunięta; ponowne włączenie za pomocą Aggrega: Get started także ją otwiera. |
aggrega.server.binaryPath | aggrega | Ścieżka do pliku binarnego aggrega. Sama nazwa jest wyszukiwana w PATH; ścieżka zaczynająca się od ~/ (~\ w systemie Windows) lub ${userHome} jest odczytywana z folderu domowego na hoście, na którym działa rozszerzenie; każda inna ścieżka jest używana tak, jak została zapisana. |
aggrega.server.debounceMs | 300 | Okno debounce dla proaktywnej walidacji przy zmianie. |
aggrega.server.respawnAttempts | 5 | Ile razy w poniższym oknie serwer językowy jest uruchamiany ponownie po tym, jak zatrzymał się bez polecenia, zanim rozszerzenie pozostawi go zatrzymanego i wyświetli powiadomienie o braku odpowiedzi. Ponownie uruchomiony serwer, który zatrzyma się, zanim odpowie, liczy się tak samo jak serwer zatrzymany w trakcie działania. Zob. Cykl życia. |
aggrega.server.respawnWindowSeconds | 180 | Przesuwne okno w sekundach, w którym liczone są te ponowne uruchomienia. |
aggrega.server.restartGraceSeconds | 5 | Okno karencji, zanim rozszerzenie automatycznie uruchomi ponownie serwer językowy po zmianie binaryPath. Pasek stanu pokazuje odliczanie; menu szybkich akcji oferuje Restart now i Cancel restart. |
aggrega.server.buildOnInspect | false | Uruchamia etap renderowania artefaktów podczas inspekcji grafu, aby porady, które aggrega build zgłasza podczas renderowania, pojawiały się też jako problemy w edytorze. Nie dodaje żadnego ze sprawdzeń, na których budowanie się zatrzymuje. Inspekcja kosztuje wtedy więcej; nic nie jest zapisywane na dysku. |
aggrega.graph.showSensitiveValues | false | Pokazuje w grafie topologii wartości, które encja Feature deklaruje jako wrażliwe, wyświetlając przekazywane przez wartość poświadczenia jawnym tekstem; gdy ustawienie jest włączone, żądanie grafu prosi o nie serwer językowy. Gdy jest wyłączone, serwer językowy pomija je w wysyłanym grafie, a przed narysowaniem grafu są one ponownie usuwane. |
aggrega.operations.layout | buttons | Sposób, w jaki panel Commands rysuje swoje grupy — buttons umieszcza wszystkie operacje w jednym zawijanym ciągu przycisków bez niczego między kolejnymi grupami, sections zamienia każdą grupę w sekcję otwieraną pod własnym tytułem. W obu przypadkach te same grupy, te same operacje i ta sama kolejność. |
aggrega.notifications.toastDebounceMode | time | Jak często powiadomienie, że encja Release nie ma pliku blokady, jest pokazywane ponownie dla pracy, o którą nie proszono, na przykład dla otwartego grafu przerysowanego po zapisaniu: time pokazuje je ponownie po upływie toastThrottleSeconds od zamknięcia poprzedniego, session pokazuje je raz, do ponownego uruchomienia serwera językowego. Build, Preview lub otwarty graf odrzucone z powodu brakującego pliku blokady zawsze pokazują powiadomienie. |
aggrega.notifications.toastThrottleSeconds | 300 | Liczba sekund od zamknięcia powiadomienia o brakującym pliku blokady, po której jest ono pokazywane ponownie dla pracy, o którą nie proszono. Odczytywane tylko wtedy, gdy toastDebounceMode ma wartość time. |