Przejdź do treści
Zweryfikowano

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:

tests/index.html
import * as plugin from "../src/runtime.mjs";
import { properties } from "../src/index.mjs";
import { initializeUiPlugin } from "@xuda.io/plugin-sandbox";

initializeUiPlugin($("body")[0], plugin, properties, `<div>12 27 2024 8:30</div>`)

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ą:

run it
npm run test:local

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.