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

Konfiguracja rozszerzenia

Wymagania wstępne

  • Visual Studio Code 1.85 lub nowszy, w wersji desktopowej. Rozszerzenie działa przez uruchamianie programu aggrega i nie udostępnia wersji, którą mogłaby zamiast niego wykonać przeglądarka, dlatego nie działa w edytorach działających w całości w przeglądarce internetowej, takich jak vscode.dev i github.dev.
  • Kompilator aggrega na maszynie, na której znajduje się obszar roboczy. Rozszerzenie uruchamia ten, który wskazuje ustawienie aggrega.server.binaryPath: ścieżka zaczynająca się od ~/ (~\ w systemie Windows) lub od ${userHome} jest odczytywana względem folderu domowego na tej maszynie, każda inna ścieżka jest używana dosłownie, a sama nazwa — domyślnie aggrega — jest wyszukiwana w PATH. Jeśli nic nie znajdzie, rozszerzenie proponuje pobranie kompilatora, a Aggrega: Select Compiler Version pozwala później zmienić wersję; zob. Pozyskiwanie kompilatora.
  • Folder, który Aggrega rozpoznaje jako katalog główny obszaru roboczego, w otwartym folderze lub powyżej niego. Aggrega odczytuje jeden plik w katalogu głównym projektu — .aggrega-config.yaml z blokiem workspace: — i szuka go, wspinając się od otwartego folderu w górę. Oznaczenie katalogu głównego blokiem workspace: jest wyborem jawnym i zalecanym; projekt, który nigdy go nie zadeklarował, nadal może zostać rozpoznany po innych znacznikach, które opisuje dokumentacja konfiguracji Aggrega wraz ze wszystkim innym, co konfiguracja umożliwia w większym projekcie.

Niczego z tego nie trzeba przygotowywać ręcznie: zob. Strona powitalna.

Instalacja rozszerzenia

Identyfikator rozszerzenia to aggrega-ai.aggrega, a rozszerzenie jest dostępne w dwóch miejscach:

W edytorze należy otworzyć widok Rozszerzenia, wyszukać Aggrega i zainstalować pozycję o identyfikatorze aggrega-ai.aggrega.

Z terminala należy przekazać identyfikator do programu wiersza poleceń Visual Studio Code:

Terminal window
code --install-extension aggrega-ai.aggrega

Rozszerzenie wyświetla własny tekst — swoje polecenia, ustawienia, widoki i komunikaty — w języku wyświetlania, w którym działa Visual Studio Code, jeśli jest na ten język przetłumaczony, a w przeciwnym razie po angielsku; język wyświetlania zmieniony za pomocą Configure Display Language zaczyna obowiązywać po ponownym uruchomieniu edytora. To, co zgłasza kompilator, w tym jego diagnostyka i pytania importu, dociera w takim brzmieniu, w jakim formułuje je kompilator, tak jak w terminalu.

Pozyskiwanie kompilatora

Rozszerzenie uruchamia kompilator wskazany przez aggrega.server.binaryPath i najpierw go szuka, zanim zaproponuje jego pozyskanie. Ścieżka w ustawieniu zaczynająca się od ~/ — ~\ w systemie Windows — lub od ${userHome} jest odczytywana względem folderu domowego na maszynie, na której znajduje się obszar roboczy, więc w systemach Linux i macOS ~/.local/bin/aggrega wskazuje plik, który umieszczają tam skrypty instalacyjne; każda inna ścieżka jest używana dosłownie. Sama nazwa — domyślnie aggrega — jest wyszukiwana w PATH, a kanał wyjściowy Aggrega podaje, który plik został znaleziony i jaką wersję zgłasza.

Krok kompilatora na stronie powitalnej, oznaczony jako do zrobienia, oferujący Use the compiler on my PATH, Point at a compiler I have i Download the compiler.

Jeśli nic nie znajdzie, proponuje pobranie kompilatora — w kroku kompilatora na stronie powitalnej, gdzie Download the compiler znajduje się obok Use the compiler on my PATH i Point at a compiler I have, oraz w powiadomieniu, że nie udało się uruchomić serwera języka, ponieważ pod ścieżką nic nie ma. Pobieranie:

  • proponuje najnowsze opublikowane wydanie, z którym współpracuje to rozszerzenie, zbudowane dla systemu operacyjnego i procesora maszyny, na której znajduje się obszar roboczy — w oknie otwartym na zdalnej maszynie, w kontenerze lub WSL jest to tamta maszyna. Releases zawierają pliki binarne dla systemów Linux i macOS na 64-bitowych x86 i 64-bitowych ARM oraz dla systemu Windows na 64-bitowych x86; na każdej innej maszynie pobieranie jest odrzucane z jej wskazaniem;
  • proponuje folder używany przez skrypty instalacyjne Aggrega — ~/.local/bin w systemach Linux i macOS, %LOCALAPPDATA%\Programs\aggrega w systemie Windows — w którym kompilator jest zapisywany jako aggrega lub aggrega.exe w systemie Windows, i pozwala go zmienić; wersja jest podana w tytule pytania;
  • prosi o potwierdzenie wersji i pliku, zanim cokolwiek zostanie pobrane, a następnie pokazuje postęp, który można zatrzymać;
  • weryfikuje plik względem SHA256SUMS wydania, usuwając niezgodne pobranie i je wskazując, nadaje mu uprawnienia do wykonywania i uruchamia go raz z aggrega version -o json. Na miejsce trafia tylko plik, który przejdzie wszystkie trzy próby, i dopiero wtedy aggrega.server.binaryPath zostaje na niego ustawione w ustawieniach użytkownika.

Pobieranie odbywa się przez serwer proxy, którego edytor używa dla rozszerzeń, zgodnie z konfiguracją w jego ustawieniach http.proxy i http.proxyStrictSSL. Jeśli nie można odczytać listy wydań lub pliku — brak połączenia, GitHub ogranicza żądania z danego adresu albo żądanie zostało odrzucone — nic nie jest pobierane, ustawienie pozostaje bez zmian, a jedno zdanie wyjaśnia przyczynę.

Zastępuje wyłącznie kompilator, który ma prawo zastąpić: znajdujący się w tym wspólnym folderze lub pobrany przez samo rozszerzenie, co zapamiętuje ono na tej maszynie we własnym magazynie, a nie w ustawieniu. Poproszone o pobranie kompilatora w miejsce takiego, który umieszczono gdziekolwiek indziej, informuje, że nigdy go nie zastępuje, i zamiast tego proponuje wspólny folder.

Nigdy nie aktualizuje się samo. W przypadku kompilatora, który może zastąpić, odczytuje listę wydań przy otwarciu okna i informuje — raz dla każdej wersji — że dostępne jest nowsze wydanie; o kompilator wskazany samodzielnie przez użytkownika o nic nie pyta.

Aggrega: Select Compiler Version zmienia uruchamianą wersję i zachowuje ją do kolejnej zmiany. Polecenie wyświetla wydania, z którymi współpracuje to rozszerzenie, od najnowszego, oznaczając używane. Zanim cokolwiek zostanie pobrane, ostrzega, że kompilatora tego używa każdy obszar roboczy na tej maszynie, więc wersja zmienia się dla wszystkich, oraz że encja Release, której plik blokady zapisała inna wersja, może wymagać ponownego uruchomienia Pull; potwierdza się przyciskiem Download and switch. Nowa wersja jest pobierana obok bieżącej i weryfikowana jak każde pobranie, uruchamiany jest na niej serwer języka i dopiero wtedy zastępuje poprzednią. Jeśli serwer języka się na niej nie uruchamia, zostaje usunięta, poprzednia pozostaje, a serwer języka zostaje ponownie uruchomiony na poprzedniej. W oknie bez otwartego obszaru roboczego Aggrega nie ma serwera języka do uruchomienia, więc zastępuje go sprawdzenie wersji, o czym informuje komunikat. Kompilator jest zastępowany tylko tam, gdzie może to zrobić pobieranie; w przypadku kompilatora umieszczonego gdzieś samodzielnie polecenie o tym informuje i zamiast tego proponuje wspólny folder.