Přeskočit na obsah
Ověřeno

Sestavení a testování lokálně

Živý náhled v sandboxu pro pluginy UI a offline testovací vzor pro pluginy library a dbs, oboje spouštěné z vlastní složky pluginu.

Každá složka pluginu pod plugins/@xuda.io/ se sestavuje přes Vite (npm run dev / npm run build uvnitř vlastního adresáře pluginu) a každý druh má vlastní vzor, jak plugin vyzkoušet, než se někam nahraje.

Pluginy UI: živý náhled plugin-sandbox

@xuda.io/plugin-sandbox je malý balíček, který vykreslí živý konfigurátor jednoho pluginu UI: rozbalovací seznam pro každou vlastnost a panel náhledu, který se při změně překresluje. Soubor tests/index.html pluginu UI ho napojí přímo na zdroj pluginu, bez kroku sestavení:

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) bere modul runtime, schéma vlastností a HTML, proti kterému se plugin zobrazí. Spusťte npm run dev ve složce pluginu (Vite obsluhuje tests/ jako kořen, podle vite.config.js pluginu) a náhled se otevře.

Pluginy library a dbs: offline testovací skript

Plugin, jehož práce probíhá v server.mjs, se testuje prostým skriptem Node, ne prohlížečovým sandboxem. xuda-library-plugin-xlsx je vzor, který následovat: server.mjs exportuje objekt internals se svými čistými funkcemi (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...) a tests/local.mjs importuje { internals } a přímo je procvičuje, bez disku, bez AI a bez připojení k platformě:

run it
npm run test:local

což spustí node ./tests/local.mjs (viz scripts.test:local v package.json pluginu). Zapsat procvičovanou logiku jako pojmenované exporty v internals je to, co to umožňuje; server.mjs, který drží vše jako neexportované lokální funkce, nemá nic, co by testovací skript mohl volat.

plugin_tester/

plugin_tester/ v kořeni repozitáře je starší tester: index.html spustí celou stránku xuda-runtime-slim.js nad značkami _default/xu-single-page a index.js je spouštěč pluginů založený na jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)), který volá API pluginů ppi.xuda.io. Jeho tvar (jQuery, xu-single-page, koncový bod ppi.xuda.io, hledání runtime/index.js místo runtime.mjs) neodpovídá manifestu, druhům a signatuře runtime fn(plugin_name, element, properties) popsaným na ostatních stránkách této sekce a žádný z pluginů pod plugins/@xuda.io/ na něj neodkazuje. Vypadá, že předchází současnému postupu s plugin-sandbox, ne že by byl udržovaným způsobem lokálního testování pluginu.