Siirry sisältöön
Tarkistettu

Rakenna ja testaa paikallisesti

Live-esikatseluhiekkalaatikko UI-lisäosille ja offline-testimalli kirjasto- ja dbs-lisäosille, molemmat ajetaan lisäosan omasta kansiosta.

Jokainen plugins/@xuda.io/-kansion lisäosakansio rakentuu Vitellä (npm run dev / npm run build lisäosan omassa kansiossa), ja jokaisella tyypillä on oma mallinsa lisäosan kokeilemiseen ennen kuin se ladataan mihinkään.

UI-lisäosat: plugin-sandboxin live-esikatselu

@xuda.io/plugin-sandbox on pieni paketti, joka renderöi live-konfiguraattorin yhdelle UI-lisäosalle: pudotusvalikko jokaiselle ominaisuudelle ja esikatselualue, joka renderöityy uudelleen muutosten myötä. UI-lisäosan tests/index.html kytkee sen suoraan lisäosan omaan lähdekoodiin, ilman rakennusvaihetta:

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) ottaa ajonaikaisen moduulin, ominaisuusskeeman ja HTML:n, jota vasten lisäosaa esikatsellaan. Aja npm run dev lisäosan kansiossa (Vite palvelee tests/-kansiota juurena lisäosan vite.config.js:n mukaan) avataksesi sen.

Kirjasto- ja dbs-lisäosat: offline-testiskripti

Lisäosa, jonka työ tapahtuu tiedostossa server.mjs, testaa itsensä tavallisella Node-skriptillä selaimen hiekkalaatikon sijaan. xuda-library-plugin-xlsx on malli, jota seurata: server.mjs vie internals-objektin puhtaine funktioineen (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), ja tests/local.mjs tuo { internals }:n ja käyttää niitä suoraan, ilman drivea, tekoälyä tai alustayhteyttä:

run it
npm run test:local

mikä ajaa node ./tests/local.mjs (katso lisäosan package.json scripts.test:local). Testattavan logiikan kirjoittaminen nimettyinä vienteinä internals:iin tekee tämän mahdolliseksi; server.mjs, joka pitää kaiken viemättöminä paikallisina funktioina, ei tarjoa testiskriptille mitään kutsuttavaa.

plugin_tester/

Repon juuren plugin_tester/ on vanhempi testaaja: index.html käynnistää täyden xuda-runtime-slim.js-sivun _default/xu-single-page-merkintää vasten, ja index.js on jQuery-pohjainen lisäosa-ajaja (func.UI.widgets, $(el), fields_ret = get_fields_data(...)), joka kutsuu ppi.xuda.io-lisäosa-API:a. Sen muoto (jQuery, xu-single-page, ppi.xuda.io-päätepiste, haku tiedostoa runtime/index.js eikä runtime.mjs) ei vastaa tämän osion muilla sivuilla dokumentoitua manifestia, tyyppejä ja fn(plugin_name, element, properties) -ajonaikaista allekirjoitusta, eikä mikään plugins/@xuda.io/-kansion lisäosa viittaa siihen. Se vaikuttaa edeltävän nykyistä plugin-sandbox-työnkulkua eikä olevan ylläpidetty tapa testata lisäosaa paikallisesti.