Sari la conținut
Verificat

Construiește și testează local

Un sandbox cu previzualizare live pentru plugin-urile de UI și un model de test offline pentru plugin-urile library și dbs, ambele rulate din folderul propriu al pluginului.

Fiecare folder de plugin din plugins/@xuda.io/ se construiește cu Vite (npm run dev / npm run build în directorul propriu al pluginului), iar fiecare tip are propriul model de a încerca pluginul înainte să fie încărcat undeva.

Plugin-uri de UI: previzualizarea live din plugin-sandbox

@xuda.io/plugin-sandbox este un pachet mic care afișează un configurator live pentru un plugin de UI: un dropdown pentru fiecare proprietate și un panou de previzualizare care se redesenează pe măsură ce le schimbi. tests/index.html al unui plugin de UI îl leagă direct de sursa proprie a pluginului, fără pas de build:

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) primește modulul de runtime, schema de proprietăți și HTML-ul față de care se previzualizează pluginul. Rulează npm run dev în folderul pluginului (Vite servește tests/ ca rădăcină, conform vite.config.js al pluginului) ca să îl deschizi.

Plugin-uri library și dbs: un script de test offline

Un plugin a cărui muncă se petrece în server.mjs se testează singur cu un simplu script Node, nu cu un sandbox de browser. xuda-library-plugin-xlsx este modelul de urmat: server.mjs exportă un obiect internals cu funcțiile lui pure (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), iar tests/local.mjs importă { internals } și le exersează direct, fără drive, fără AI, fără conexiune la platformă:

run it
npm run test:local

care rulează node ./tests/local.mjs (vezi scripts.test:local din package.json al pluginului). Faptul că logica exersată este scrisă ca exporturi cu nume în internals este ceea ce face acest lucru posibil; un server.mjs care păstrează totul ca funcții locale neexportate nu are nimic pe care să îl poată apela un script de test.

plugin_tester/

plugin_tester/ din rădăcina repo-ului este un tester mai vechi: index.html pornește o pagină completă xuda-runtime-slim.js pe marcaj _default/xu-single-page, iar index.js este un runner de plugin-uri bazat pe jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) care apelează un API de plugin-uri ppi.xuda.io. Forma lui (jQuery, xu-single-page, un endpoint ppi.xuda.io, căutarea lui runtime/index.js în loc de runtime.mjs) nu se potrivește cu manifestul, tipurile și semnătura de runtime fn(plugin_name, element, properties) documentate pe celelalte pagini ale acestei secțiuni, iar niciunul dintre plugin-urile din plugins/@xuda.io/ nu îl referă. Pare să preceadă fluxul actual cu plugin-sandbox, nu să fie modul întreținut de a testa un plugin local.