Konfiguracja rozszerzenia
Wymagania wstępne
- Visual Studio Code 1.85 lub nowszy, w wersji desktopowej. Rozszerzenie działa przez uruchamianie programu
aggregai 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
aggregana maszynie, na której znajduje się obszar roboczy. Rozszerzenie uruchamia ten, który wskazuje ustawienieaggrega.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ślnieaggrega— jest wyszukiwana wPATH. 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.yamlz blokiemworkspace:— i szuka go, wspinając się od otwartego folderu w górę. Oznaczenie katalogu głównego blokiemworkspace: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 Visual Studio Marketplace, z którego instaluje Visual Studio Code;
- w Open VSX, dla edytorów, które instalują rozszerzenia z Open VSX.
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:
code --install-extension aggrega-ai.aggregaRozszerzenie 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.

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/binw systemach Linux i macOS,%LOCALAPPDATA%\Programs\aggregaw systemie Windows — w którym kompilator jest zapisywany jakoaggregalubaggrega.exew 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
SHA256SUMSwydania, usuwając niezgodne pobranie i je wskazując, nadaje mu uprawnienia do wykonywania i uruchamia go raz zaggrega version -o json. Na miejsce trafia tylko plik, który przejdzie wszystkie trzy próby, i dopiero wtedyaggrega.server.binaryPathzostaje 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.