Instalowanie i obsługa pluginów

Pluginy mogą dodawać widoki centralne, panele boczne obszarów roboczych, komendy, skróty klawiszowe i przyciski w miejscach rozszerzeń interfejsu. Pakiet może też zawierać motywy.

Aplikacja instaluje lokalne foldery z gotowym buildem. Ekran Plugins nie zawiera sklepu z rozszerzeniami ani instalacji przez npm.

Od czego zacząć

Potrzeba	Najkrótsza ścieżka
Mam gotowy plugin	Instrukcja instalacji poniżej; Node.js i Rust nie są potrzebne
Chcę stworzyć własny plugin	Pierwszy plugin i wybór szablonu
Rozbudowuję istniejący projekt	Manifest, API, widoki i stan
Chcę dodać komendę lub przycisk	Komendy i elementy interfejsu
Chcę dopracować wygląd	Style i zasoby
Przygotowuję wydanie lub szukam błędu	Kwalifikacja desktopowa, CLI, pakowanie i naprawa

Pakiet to folder z plugin.json, gotowym kodem i zasobami. Deklaracja w manifeście zapowiada element interfejsu, a rejestracja w activate() dostarcza jego implementację. Rewizja identyfikuje konkretną zawartość zainstalowanego pakietu; jest niezależna od numeru wersji podanego przez autora.

Instalacja pluginu

1. Pobierz gotowy pakiet od autora. W jego głównym folderze muszą znajdować się plugin.json i skompilowane pliki wskazane w manifeście.
2. Otwórz Settings > Plugins > Import plugin i wskaż folder pakietu.
3. Znajdź zaimportowany plugin i włącz jego przełącznik.
4. Przeczytaj informacje o pakiecie. Jeśli akceptujesz tę rewizję, wybierz Trust and enable.
5. Otwórz widok lub uruchom komendę pluginu. Plugin typu lazy aktywuje się przy pierwszym użyciu, a startup po przygotowaniu obszaru roboczego aplikacji.

Sam import nie uruchamia JavaScriptu pluginu. Zgoda dotyczy skrótu zawartości zainstalowanego pakietu. Nie potwierdza tożsamości wydawcy.

Jeśli otrzymasz ZIP, najpierw go rozpakuj. Wskaż folder, w którym bezpośrednio znajduje się plugin.json, a nie samo archiwum ani katalog źródeł. Dla pakietu zawierającego wyłącznie motyw pomiń włączanie kodu i przejdź do Settings > Themes.

Dostęp i zaufanie

Kod pluginu działa w środowisku JavaScript głównego okna aplikacji. Nie jest izolowany i może mieć dostęp na poziomie aplikacji, w tym do plików i terminali. Włączaj tylko kod, któremu ufasz. Publiczne SDK opisuje wspierane punkty integracji, ale nie jest granicą uprawnień.

Okno Settings odczytuje metadane bez uruchamiania modułu pluginu. Motywy dostarczane przez pakiet są dostępne w Settings > Themes po imporcie, nawet gdy kod pluginu pozostaje wyłączony.

Wyłączanie, aktualizacja i usuwanie

Przełącznik wyłącza plugin. Uninstall usuwa go z biblioteki. Jeśli plugin zarejestrował niezapisane widoki, najpierw wybierz Save, Discard lub Cancel w głównym oknie. Anulowanie operacji lub błąd zapisu pozostawia plugin dostępny.

Otwarte widoki wyłączonego lub brakującego pluginu wyświetlają komunikat o niedostępności. Ich zapisane opisy pozostają w sesji do czasu zamknięcia widoku albo przywrócenia zgodnego pluginu.

Aby zaktualizować plugin, wyłącz go, zaimportuj nowy folder z buildem i zatwierdź nową rewizję. Jeśli poprzedni kod był już załadowany, użyj Restart Lomi przed uruchomieniem zamiennika. Szczegóły znajdziesz na stronie pakowanie i rozwiązywanie problemów.

Własny plugin

Zacznij od strony Pierwszy plugin. Przykład tworzy panel pokazujący aktywny projekt i zapamiętuje, czy wyświetlać jego ścieżkę.

Kod źródłowy: ustawienia pluginów, natywna obsługa pakietów.