İçeriğe geç
Doğrulandı

Yerelde derleyin ve test edin

UI eklentileri için canlı önizleme sanal alanı, kütüphane ve dbs eklentileri için çevrimdışı test deseni: ikisi de eklentinin kendi klasöründen çalışır.

plugins/@xuda.io/ altındaki her eklenti klasörü Vite ile derlenir (eklentinin kendi dizini içinde npm run dev / npm run build) ve her türün, eklenti herhangi bir yere yüklenmeden önce denemek için kendi deseni vardır.

UI eklentileri: plugin-sandbox canlı önizlemesi

@xuda.io/plugin-sandbox, tek bir UI eklentisi için canlı bir yapılandırıcı oluşturan küçük bir pakettir: özellik başına bir açılır liste ve onları değiştirdikçe yeniden çizilen bir önizleme bölmesi. Bir UI eklentisinin tests/index.html dosyası bunu doğrudan eklentinin kendi kaynağına karşı bağlar, derleme adımı gerekmez:

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), çalışma zamanı modülünü, özellik şemasını ve eklentinin önizleneceği HTML'i alır. Açmak için eklentinin klasöründe npm run dev çalıştırın (Vite, eklentinin vite.config.js dosyasına göre tests/ klasörünü kök olarak sunar).

Kütüphane ve dbs eklentileri: çevrimdışı bir test betiği

İşi server.mjs içinde gerçekleşen bir eklenti, tarayıcı sanal alanı yerine düz bir Node betiğiyle kendini test eder. xuda-library-plugin-xlsx izlenecek desendir: server.mjs, saf işlevlerini (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...) içeren bir internals nesnesi dışa aktarır ve tests/local.mjs, { internals } içe aktarıp onları doğrudan çalıştırır: sürücü yok, AI yok, platform bağlantısı yok:

run it
npm run test:local

bu, node ./tests/local.mjs komutunu çalıştırır (eklentinin package.json dosyasındaki scripts.test:local değerine bakın). Çalıştırılan mantığı internals üzerinde adlandırılmış dışa aktarımlar olarak yazmak bunu mümkün kılar. Her şeyi dışa aktarılmayan yerel işlevler olarak tutan bir server.mjs, bir test betiğinin çağırabileceği hiçbir şeye sahip olmaz.

plugin_tester/

Depo kökündeki plugin_tester/ daha eski bir test aracıdır: index.html, _default/xu-single-page işaretlemesine karşı tam bir xuda-runtime-slim.js sayfası başlatır ve index.js, bir ppi.xuda.io eklenti API'sini çağıran jQuery tabanlı bir eklenti çalıştırıcısıdır (func.UI.widgets, $(el), fields_ret = get_fields_data(...)). Biçimi (jQuery, xu-single-page, bir ppi.xuda.io uç noktası, runtime.mjs yerine runtime/index.js aranması), bu bölümün diğer sayfalarında belgelenen bildirim, türler ve fn(plugin_name, element, properties) çalışma zamanı imzasıyla uyuşmaz ve plugins/@xuda.io/ altındaki eklentilerin hiçbiri ona başvurmaz. Bir eklentiyi yerelde test etmenin bakımı yapılan yolu olmaktan çok, güncel plugin-sandbox iş akışından önce kalmış gibi görünür.