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.
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.mjshem deindex.mjsdosyasının var olduğunu göstermedikçe çalışma zamanı bir arayüz eklentisini hiç çalıştırmaz. Sonrapropertiesiçinindex.mjsiçe aktarılır, her özelliğin değeri (xu-exp:ifade bağlamaları dahil) öğenin özniteliklerine göre çözümlenir,runtime.mjsiçe aktarılır vefnç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.mjsgöndermek "Kendi kodunu Xuda sunucularında, projenizin içinde çalıştırır" der.runtime.mjsgöndermek "Kendi kodunu yayımlanan uygulamanızın içinde, onu kullanan herkesin tarayıcısında çalıştırır" der.studio.mjsvesetup.mjsiçin de kendi satırları vardır. - Panonun Kurulum düğmesi. Bir eklentinin kurulum ekranı yalnızca
manifest['index.mjs'].existdoğruysa ve o modül boş değilse ya da eklentinin kendi kurulumu olan bir bağımlılığı varsa gösterilir.