İçeriğe geç
Doğrulandı

Eklenti bildirimi

Bir eklentinin gönderebileceği altı dosya, her biri farklı bir giriş noktası, ve hangilerinin var olduğunu kaydeden bildirim.

Bir eklentinin bildirimi, yazdığınız bir dosya değildir. Bir eklenti yüklendiği anda platform tarafından hesaplanır: validate_plugin() diskte tam olarak altı dosya adına bakar, hangilerinin var olduğunu (ve her birinin paket kökünde mi yoksa dist/ altında mı bulunduğunu) kaydeder ve sonucu eklentinin katalog belgesinde doc.manifest olarak saklar. Sonraki her şey, yani çalışma zamanının yükleyicisi, kurulum onay ekranı ve panonun kurulum düğmesi, paketin kendisini yoklamak yerine bu bildirimi okur.

Altı dosya

Bir eklenti, türünün ihtiyaç duyduğu bunlardan hangisini gönderirse onu gönderir. plugins/@xuda.io/xuda-ui-plugin-moment/src yalnızca index.mjs ve runtime.mjs içerir, plugins/@xuda.io/xuda-library-plugin-xlsx index.mjs ve server.mjs içerir, plugins/@xuda.io/xuda-dbs-plugin-couchdb index.mjs ve server.mjs içerir.

Kök veya dist/

validate_plugin() her dosyaya önce paket kökünde, sonra dist/<file> altında bakar. İki konum da bildirimi karşılar. Bu yüzden Vite ile derlenen bir eklenti (plugins/@xuda.io/ altındakilerin çoğu) kaynağı src/ altında gönderir ve derlemesinin bildirim dosyalarını dist/ içine yazmasına izin verir.

CSS yalnızca dist içinden yüklenir

runtime.css (ve diğer her bildirim CSS'i) yalnızca eşleşen .mjs dosyası dist/ altında bulunduğunda alınır, paket kökünden asla. Çalışma zamanı stil sayfasını getirmeden önce manifest[resource].dist && manifest[resource].css değerini kontrol eder. Bu yüzden kökte bir runtime.mjs ve kökte bir style.css olan bir eklenti doğrulamadan geçer (ikisinde de exist: true) ama çalışma zamanı CSS'i hiç yüklemez. Eklentinin stil sayfasının gerçekten yüklenmesi gerekiyorsa dist/ üzerinden gönderin.

Bildirim ne için kullanılır

  • Bir arayüz eklentisini yüklemek. Bildirim hem runtime.mjs hem de index.mjs dosyasının var olduğunu göstermedikçe çalışma zamanı bir arayüz eklentisini hiç çalıştırmaz. Sonra properties için index.mjs içe aktarılır, her özelliğin değeri (xu-exp: ifade bağlamaları dahil) öğenin özniteliklerine göre çözümlenir, runtime.mjs içe aktarılır ve fn çağrılır.
  • Kurulum onay ekranı. Bildirimdeki varlık, doğrudan kullanıcının kurmadan önce okuduğu cümlelere dönüşür: server.mjs göndermek "Kendi kodunu Xuda sunucularında, projenizin içinde çalıştırır" der. runtime.mjs göndermek "Kendi kodunu yayımlanan uygulamanızın içinde, onu kullanan herkesin tarayıcısında çalıştırır" der. studio.mjs ve setup.mjs için de kendi satırları vardır.
  • Panonun Kurulum düğmesi. Bir eklentinin kurulum ekranı yalnızca manifest['index.mjs'].exist doğruysa ve o modül boş değilse ya da eklentinin kendi kurulumu olan bir bağımlılığı varsa gösterilir.