Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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ń.

Strona ustawień samego edytora zawężona do ustawień rozszerzenia Aggrega, każde pod własnym nagłówkiem.

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.

UstawienieDomyślniePrzeznaczenie
aggrega.getStarted.showtrueCzy 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.binaryPathaggregaŚ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.debounceMs300Okno debounce dla proaktywnej walidacji przy zmianie.
aggrega.server.respawnAttempts5Ile 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.respawnWindowSeconds180Przesuwne okno w sekundach, w którym liczone są te ponowne uruchomienia.
aggrega.server.restartGraceSeconds5Okno 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.buildOnInspectfalseUruchamia 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.showSensitiveValuesfalsePokazuje 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.layoutbuttonsSposó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.toastDebounceModetimeJak 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.toastThrottleSeconds300Liczba 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.