Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Δημιουργία και δοκιμή τοπικά

Ένα sandbox ζωντανής προεπισκόπησης για πρόσθετα UI, και ένα μοτίβο offline δοκιμής για πρόσθετα library και dbs, και τα δύο εκτελούνται από τον ίδιο τον φάκελο του πρόσθετου.

Κάθε φάκελος πρόσθετου κάτω από το plugins/@xuda.io/ χτίζεται με Vite (npm run dev / npm run build μέσα στον δικό του κατάλογο του πρόσθετου), και κάθε είδος έχει το δικό του μοτίβο για να δοκιμάσετε το πρόσθετο πριν μεταφορτωθεί οπουδήποτε.

Πρόσθετα UI: η ζωντανή προεπισκόπηση plugin-sandbox

Το @xuda.io/plugin-sandbox είναι ένα μικρό πακέτο που αποδίδει έναν ζωντανό διαμορφωτή για ένα πρόσθετο UI: ένα αναπτυσσόμενο μενού ανά ιδιότητα, και ένα παράθυρο προεπισκόπησης που ξαναχτίζεται καθώς τις αλλάζετε. Το tests/index.html ενός πρόσθετου UI το συνδέει απευθείας με τον δικό του πηγαίο κώδικα του πρόσθετου, χωρίς βήμα 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) παίρνει την ενότητα runtime, το σχήμα ιδιοτήτων και το HTML με το οποίο θα γίνει η προεπισκόπηση του πρόσθετου. Εκτελέστε npm run dev στον φάκελο του πρόσθετου (το Vite σερβίρει το tests/ ως ρίζα, σύμφωνα με το vite.config.js του πρόσθετου) για να το ανοίξετε.

Πρόσθετα library και dbs: ένα offline script δοκιμής

Ένα πρόσθετο του οποίου η δουλειά γίνεται στο server.mjs δοκιμάζεται με ένα απλό script Node αντί για sandbox browser. Το xuda-library-plugin-xlsx είναι το μοτίβο προς μίμηση: το server.mjs εξάγει ένα αντικείμενο internals με τις καθαρές συναρτήσεις του (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), και το tests/local.mjs εισάγει το { internals } και τις ασκεί απευθείας, χωρίς drive, χωρίς AI, χωρίς σύνδεση με την πλατφόρμα:

run it
npm run test:local

το οποίο εκτελεί το node ./tests/local.mjs (δείτε το scripts.test:local στο package.json του πρόσθετου). Η γραφή της λογικής που ασκείται ως ονομασμένες εξαγωγές στο internals είναι αυτό που το κάνει δυνατό: ένα server.mjs που κρατά τα πάντα ως μη εξαγόμενες τοπικές συναρτήσεις δεν έχει τίποτα που να μπορεί να καλέσει ένα script δοκιμής.

plugin_tester/

Το plugin_tester/ στη ρίζα του repo είναι ένας παλαιότερος δοκιμαστής: το index.html εκκινεί μια πλήρη σελίδα xuda-runtime-slim.js πάνω σε markup _default/xu-single-page, και το index.js είναι ένας εκτελεστής πρόσθετων βασισμένος σε jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) που καλεί ένα API πρόσθετων ppi.xuda.io. Η μορφή του (jQuery, xu-single-page, ένα τελικό σημείο ppi.xuda.io, αναζήτηση του runtime/index.js αντί για runtime.mjs) δεν ταιριάζει με το manifest, τα είδη και την υπογραφή runtime fn(plugin_name, element, properties) που τεκμηριώνονται στις άλλες σελίδες αυτής της ενότητας, και κανένα από τα πρόσθετα κάτω από το plugins/@xuda.io/ δεν το αναφέρει. Μοιάζει να προηγείται της τρέχουσας ροής εργασίας plugin-sandbox και όχι να είναι ο συντηρούμενος τρόπος τοπικής δοκιμής ενός πρόσθετου.