Buduj i testuj lokalnie
Podgląd na żywo w piaskownicy dla wtyczek UI i wzorzec testów offline dla wtyczek library i dbs, oba uruchamiane z własnego folderu wtyczki.
Każdy folder wtyczki w plugins/@xuda.io/ buduje się przez Vite (npm run dev / npm run build
we własnym katalogu wtyczki), a każdy rodzaj ma własny wzorzec wypróbowania wtyczki, zanim zostanie
gdziekolwiek przesłana.
Wtyczki UI: podgląd na żywo w plugin-sandbox
@xuda.io/plugin-sandbox to mały pakiet, który renderuje konfigurator na żywo dla jednej wtyczki
UI: lista rozwijana na każdą właściwość i panel podglądu, który renderuje się ponownie przy każdej
zmianie. Plik tests/index.html wtyczki UI podłącza go bezpośrednio do własnego źródła wtyczki, bez
kroku budowania:
initializeUiPlugin(el, plugin, properties, previewHtml) przyjmuje moduł środowiska uruchomieniowego,
schemat właściwości i HTML, względem którego podglądana jest wtyczka. Uruchom npm run dev w
folderze wtyczki (Vite serwuje tests/ jako katalog główny, zgodnie z vite.config.js wtyczki),
żeby go otworzyć.
Wtyczki library i dbs: skrypt testowy offline
Wtyczka, której praca dzieje się w server.mjs, testuje się zwykłym skryptem Node, a nie
piaskownicą w przeglądarce. xuda-library-plugin-xlsx to wzorzec do naśladowania: server.mjs
eksportuje obiekt internals ze swoimi czystymi funkcjami (normalize_book, render_book,
load_workbook, apply_operations, cell_value_of, ...), a tests/local.mjs importuje
{ internals } i ćwiczy je bezpośrednio, bez dysku, bez AI, bez połączenia z platformą:
co uruchamia node ./tests/local.mjs (zobacz scripts.test:local w package.json wtyczki).
Zapisanie ćwiczonej logiki jako nazwanych eksportów w internals to właśnie to, co to umożliwia;
server.mjs, który trzyma wszystko jako nieeksportowane funkcje lokalne, nie ma nic, co skrypt
testowy mógłby wywołać.
plugin_tester/
plugin_tester/ w katalogu głównym repozytorium to starszy tester: index.html uruchamia pełną
stronę xuda-runtime-slim.js na znacznikach _default/xu-single-page, a index.js to oparty na
jQuery uruchamiacz wtyczek (func.UI.widgets, $(el), fields_ret = get_fields_data(...)),
wywołujący API wtyczek ppi.xuda.io. Jego kształt (jQuery, xu-single-page, punkt końcowy
ppi.xuda.io, szukanie runtime/index.js zamiast runtime.mjs) nie pasuje do manifestu, rodzajów
i sygnatury środowiska fn(plugin_name, element, properties) opisanych na pozostałych stronach tej
sekcji, a żadna wtyczka w plugins/@xuda.io/ się do niego nie odwołuje. Wygląda na to, że poprzedza
obecny przepływ plugin-sandbox, a nie jest utrzymywanym sposobem lokalnego testowania wtyczki.