דילוג לתוכן
אומת

בנייה ובדיקה מקומית

ארגז חול של תצוגה מקדימה חיה לתוספי ממשק, ודפוס בדיקה במצב לא מקוון לתוספי library ו-dbs, שניהם רצים מהתיקייה של התוסף עצמו.

כל תיקיית תוסף תחת plugins/@xuda.io/ נבנית עם Vite (npm run dev / npm run build בתוך התיקייה של התוסף עצמו), ולכל סוג יש דפוס משלו לנסות את התוסף לפני שמעלים אותו לאנשהו.

תוספי ממשק: תצוגה מקדימה חיה ב-plugin-sandbox

@xuda.io/plugin-sandbox היא חבילה קטנה שמציגה מגדיר חי לתוסף ממשק אחד: תפריט נפתח לכל מאפיין, וחלונית תצוגה מקדימה שמתרנדרת מחדש כשמשנים אותם. הקובץ tests/index.html של תוסף ממשק מחבר אותה ישירות מול המקור של התוסף עצמו, בלי שלב בנייה:

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: סקריפט בדיקה במצב לא מקוון

תוסף שהעבודה שלו מתבצעת ב-server.mjs נבדק בסקריפט Node פשוט ולא בארגז חול בדפדפן. 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 ששומר הכול כפונקציות מקומיות שאינן מיוצאות אין בו שום דבר שסקריפט בדיקה יכול לקרוא לו.

plugin_tester/

plugin_tester/ בשורש המאגר הוא בודק ישן יותר: index.html מעלה דף xuda-runtime-slim.js מלא מול סימון _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) לא מתאים למניפסט, לסוגים ולחתימת ה-runtime fn(plugin_name, element, properties) שמתועדים בדפים האחרים של הפרק הזה, ואף אחד מהתוספים תחת plugins/@xuda.io/ לא מפנה אליו. נראה שהוא קדם לזרימת העבודה הנוכחית של plugin-sandbox, ואינו הדרך המתוחזקת לבדוק תוסף מקומית.