ONLYOFFICE Desktop Editors nie dokumentuje ani jednego przełącznika „Włącz tworzenie wtyczek”. Obsługiwany obieg pracy polega na zainstalowaniu własnej wtyczki za pomocą Menedżera wtyczek, umieszczeniu jej w lokalnym folderze wtyczek i opcjonalnie zastąpieniu zainstalowanej kopii dowiązaniem symbolicznym do działającego folderu źródłowego. Aby sprawdzić błędy i użyć punktów przerwania, uruchom aplikację desktopową z udokumentowaną flagą debugowania. Są to oddzielne kroki: tryb debugowania udostępnia narzędzia programistyczne, a instalacja lub linkowanie wtyczki udostępnia je edytorowi.
Aktualna dokumentacja API ONLYOFFICE opisuje ten sam przepływ pracy na komputerze stacjonarnym, a także dokumentuje flagę umożliwiającą utrzymanie włączonego trybu debugowania po każdym uruchomieniu. Nie znalazłem oficjalnego powiadomienia o nowym przełączniku trybu programistycznego, który zmieniałby te kroki. Niniejszy przewodnik jest zgodny z oficjalnymi instrukcjami dostępnymi 6 października 2026 r. Ścieżki mogą się różnić w zależności od typu instalacji, dlatego przed zmianą plików należy sprawdzić ścieżkę dla swojej platformy.
| Zbliżać się | Najlepszy dla | Kompromis |
|---|---|---|
Zainstaluj .pluginarchiwum w Menedżerze wtyczek | Pierwsza instalacja, szybkie testy lub sporadyczne zmiany | Proste i obsługiwane, ale musisz odbudować i ponownie zainstalować archiwum po każdej zmianie źródła. |
| Połącz folder zainstalowanej wtyczki z folderem źródłowym | Częste edycje w trakcie rozwoju | Usuwa powtarzające się pakiety, ale wymaga prawidłowej ścieżki dla każdego użytkownika oraz ponownego załadowania lub otwarcia w celu uwzględnienia zmian. |
| Uruchom z flagą debugowania | Sprawdzanie wyników konsoli, ramek wtyczek lub punktów przerwania | Włącza narzędzia programistyczne; nie instaluje wtyczek ani nie ładuje automatycznie niezaufanego kodu. |
Większość programistów korzysta z archiwum raz, aby zarejestrować wtyczkę, a następnie używa dowiązania symbolicznego do iteracji. Flagę debugowania należy dodawać tylko podczas diagnostyki kodu. Należy wyłączyć jej trwałą wersję, chyba że narzędzia programistyczne są potrzebne przy każdym uruchomieniu.
Zacznij od lokalnego katalogu wtyczki zawierającego co najmniej pliki wymagane przez wtyczkę, w tym config.jsoni index.html. Plik konfiguracyjny musi mieć prawidłowy identyfikator GUID wtyczki i wskazywać stronę główną wtyczki oraz zasoby, korzystając ze schematu wtyczki ONLYOFFICE. Skorzystaj z oficjalnych przykładowych wtyczek lub dokumentacji API, aby zapoznać się z pełnym schematem; nieprawidłowy identyfikator GUID, uszkodzona ścieżka lub nieprawidłowa konfiguracja mogą uniemożliwić wyświetlenie wtyczki.
Identyfikator GUID w programie config.jsonzazwyczaj ma postać asc.{YOUR-GUID}. Desktop Editors używa identyfikatora GUID jako nazwy folderu wtyczki, ale pomija asc.prefiks. Zachowaj ten sam identyfikator GUID w katalogu źródłowym, archiwum i ścieżce instalacji. Nie używaj ponownie identyfikatora GUID wbudowanej ani innej zainstalowanej wtyczki.
.zipna .plugin..pluginplik i potwierdź.Wtyczka powinna pojawić się na karcie „Wtyczki” w otwartym edytorze oraz w edytorach otwieranych później. Ręczna ścieżka archiwizacji działa bez połączenia z internetem. Instalacja z Marketplace jest przeznaczona dla gotowych do użycia wtyczek i nie zastępuje wczytywania własnej wersji rozwojowej.
Po pierwszej instalacji Desktop Editors zapisuje kopię w sdkjs-pluginskatalogu. Zastąp tę kopię dowiązaniem symbolicznym do folderu źródłowego, aby móc bezpośrednio edytować pliki robocze. Zamknij Desktop Editors przed zmianą folderu zainstalowanej wtyczki testowej. Zachowaj kopię zapasową lub upewnij się, że folder źródłowy jest nienaruszony i usuń tylko folder odpowiadający identyfikatorowi GUID wtyczki testowej.
| System operacyjny | Katalog wtyczek użytkownika |
|---|---|
| Okna | %LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\ |
| macOS | ~/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/ |
| Linux | ~/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/ |
W katalogu nazwa łącza to identyfikator GUID w nawiasach klamrowych bez asc.prefiksu. Na przykład, jeśli identyfikator GUID konfiguracji to asc.{91EAC419-EF8B-440C-A960-B451C7DF3A37}, nazwa folderu lub łącza to {91EAC419-EF8B-440C-A960-B451C7DF3A37}.
Otwórz wiersz polecenia jako administrator, jeśli wymaga tego Twoje konto lub zasady systemu Windows. Po zamknięciu edytorów i przeniesieniu zainstalowanego folderu test-plugin w inne miejsce, utwórz łącze do katalogu:
mklink /D "%LOCALAPPDATA%\ONLYOFFICE\DesktopEditors\data\sdkjs-plugins\{YOUR-GUID}" "C:\path\to\your\plugin"Zastąp oba symbole zastępcze identyfikatorem GUID i pełną ścieżką do katalogu źródłowego. Cel łącza nie może już istnieć.
ln -s "/path/to/your/plugin" "$HOME/Library/Application Support/asc.onlyoffice.ONLYOFFICE/data/sdkjs-plugins/{YOUR-GUID}"ln -s "/path/to/your/plugin" "$HOME/.local/share/onlyoffice/desktopeditors/sdkjs-plugins/{YOUR-GUID}"Użyj ścieżek do zainstalowanej edycji; kompilacje spakowane lub w trybie sandbox mogą przechowywać dane użytkownika w innym miejscu. Po edycji kodu źródłowego otwórz ponownie dokument lub przeładuj wtyczkę, w zależności od potrzeb. Dowiązanie symboliczne zapobiega przebudowie archiwum, ale zmiany nie zawsze zostaną uwzględnione, dopóki edytor nie przeładuje wtyczki.
Aby debugować wtyczkę, zamknij całkowicie program Desktop Editors i uruchom go za pomocą polecenia --ascdesktop-support-debug-info. Użyj polecenia odpowiedniego dla swojego systemu operacyjnego. Jeśli aplikacja została zainstalowana w niestandardowej lokalizacji, dostosuj ścieżkę wykonywalną.
Uruchom to w wierszu poleceń:
"%ProgramFiles%\ONLYOFFICE\DesktopEditors\DesktopEditors" --ascdesktop-support-debug-infoAlternatywnie, edytuj pole „Cel” skrótu, dodając spację i flagę po ścieżce wykonywalnej. Ma to wpływ na uruchamianie za pośrednictwem tego skrótu.
"/opt/onlyoffice/desktopeditors/DesktopEditors" --ascdesktop-support-debug-info"/Applications/ONLYOFFICE.app/Contents/MacOS/ONLYOFFICE" --ascdesktop-support-debug-infoPo uruchomieniu aplikacji kliknij wewnątrz dokumentu i naciśnij [ F1lub] lub kliknij prawym przyciskiem myszy edytowalne pole paska narzędzi i wybierz [zbadaj element] . W narzędziach programistycznych wybierz ramkę iframe wtyczki, aby zbadać jej własny kod JavaScript i logi. Przekazany kod jest callCommanduruchamiany w ramce edytora o nazwie [lub] frameEditor, więc jego błędy i punkty przerwania mogą pojawiać się w innym kontekście niż kod interfejsu użytkownika wtyczki.
Opcjonalna flaga --ascdesktop-support-debug-info-keep=1utrzymuje tryb debugowania włączony podczas uruchamiania. Aby wyłączyć stan trwały, uruchom program za pomocą --ascdesktop-support-debug-info-keep=0; --ascdesktop-support-debug-info-keep=defaultaby powrócić do stanu domyślnego. Trwałe narzędzia programistyczne są wygodne na dedykowanej maszynie testowej, ale pozostawienie ich włączonych na współdzielonej stacji roboczej wprowadza bałagan i sprawia, że narzędzia inspekcyjne są dostępne, gdy nie są potrzebne.
F1narzędzia Inspect Element po uruchomieniu z flagą debugowania.frameEditor.Jeśli wtyczka jest niedostępna, sprawdź, czy config.jsonznajdują index.htmlsię w katalogu głównym archiwum, czy identyfikator GUID jest prawidłowy, a folder używa identyfikatora GUID bez asc.prefiksu. Sprawdź, czy link prowadzi do katalogu źródłowego, a nie do katalogu nadrzędnego, w którym się znajduje. Jeśli wtyczka jest widoczna, ale zachowuje się jak starsza wersja, zamknij i ponownie otwórz dokument, aby edytor ponownie wczytał powiązane pliki.
Flaga debugowania pulpitu nie jest globalnym przełącznikiem uprawnień do tworzenia wtyczek. Zainstalowanie archiwum lub umieszczenie folderu w obsługiwanym katalogu wtyczki powoduje jej udostępnienie; flaga debugowania udostępnia narzędzia inspekcyjne. Podobnie, instrukcje dotyczące ładowania wtyczki za pomocą adresu URL do edytora internetowego nie mają automatycznego zastosowania do edytorów pulpitu. Należy skorzystać z opisanego powyżej procesu instalacji i debugowania, specyficznego dla pulpitu.
Te instrukcje dotyczą wtyczek do edytorów pulpitu ONLYOFFICE. Nie wyjaśniają, jak włączyć wtyczki w DocSpace, jak skonfigurować wtyczki po stronie serwera w ONLYOFFICE Docs ani jak opublikować wtyczkę w Marketplace. W przypadku tych przepływów pracy należy skorzystać z odpowiedniej oficjalnej dokumentacji produktu.
Dowiedz się, jak przeciągać obraz w programie Word, wybierać opcje zawijania tekstu, zachowywać go w akapicie lub mocować na stronie oraz rozwiązywać problemy z obrazami, których nie można przenieść.
Dowiedz się, jak wstawić pole wyboru w programie Excel za pomocą narzędzia w komórce, zliczyć zaznaczone elementy za pomocą formuł lub dodać powiązany formant formularza w starszych wersjach programu na komputery stacjonarne.
Generuj litery od A do Z, małe litery lub etykiety powyżej Z w programie Excel za pomocą formuły z uchwytem wypełniania, SEKWENCJI lub wielokrotnego użytku listy niestandardowej.
Dowiedz się, jak przekreślać wiersze w programie Excel w systemie Windows, na komputerze Mac i w przeglądarce, formatować część komórki i usuwać wiersze bez usuwania ich wartości.
Microsoft Access to aplikacja bazy danych systemu Windows do przechowywania powiązanych rekordów, tworzenia zapytań, tworzenia formularzy wprowadzania danych i generowania raportów. Dowiedz się, jak działa i kiedy się sprawdza.
Dowiedz się, jak zaimportować plik PST do programu Outlook 2010 lub wyeksportować pocztę, kontakty, kalendarz i zadania. Postępuj zgodnie z odpowiednimi menu i unikaj pominiętych folderów lub duplikatów.
Dowiedz się, jak dostosować wysokość i szerokość linii siatki w programie Word 2010, zmienić widoczną częstotliwość linii oraz ustawić odstępy między liniami siatki w pionie i w poziomie.
Za pomocą dodatku LiveWeb możesz umieścić witrynę internetową na slajdzie programu PowerPoint, ustawić jej rozmiar i sposób odświeżania oraz sprawdzić zgodność przed prezentacją.
Odzyskaj zapomniane hasło PST programu Outlook, korzystając z bieżących instrukcji Kernela, obejmujących m.in. identyfikację właściwego pliku, wykonanie kopii zapasowej i sprawdzenie ograniczeń narzędzia.
Dodaj święta krajowe w nowym Outlooku, Outlooku w przeglądarce lub klasycznej wersji Outlooka. Dowiedz się, jak unikać duplikatów wydarzeń i sprawdzać, czy nie brakuje dat z lat 2026–2027.
