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:
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:
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.