Eklenti nedir
Eklenti, tek bir Xuda projesine kurulan ve onu tarayıcıda, Studio'da ya da sunucuda çalışan kodla genişleten bir npm paketidir.
Bir Xuda eklentisi, bir projenin yetenek eklemek için kurduğu kapsamlı bir npm paketidir (birinci taraf
eklentiler için @xuda.io/<name>, üçüncü taraf için herhangi bir kapsam): bir arayüz bileşeni,
Studio'dan çağrılabilen bir kod kütüphanesi, bir veritabanı soketi, bir arayüz çerçevesi ya da bir simge
seti. Bu depodaki plugins/@xuda.io/ altındaki her eklenti bunlardan biridir ve aynı biçim monorepo
dışından yayımlanan bir eklenti için de geçerlidir.
Hareketli parçalar
Diskteki paket
Eklenti normal bir npm paketidir: package.json artı gönderdiği altı bildirim dosyasından hangileri
varsa (bkz. bildirim). Bu depodaki plugins/@xuda.io/<name>, birinci taraf
eklentilerin çalışma kopyasıdır. Üçüncü taraf aynı biçimi kendi deposundan yazar ve yayımlar.
Katalog belgesi
Bir eklentiyi yüklemek (upload_plugin), xuda_plugins veritabanına paket adıyla anahtarlanmış tek bir
belge yazar. Bu belge hem kurulum kaynağıdır (manifest, version ve package_source neyin getirileceğini
ve paketin gerçekte ne gönderdiğini söyler) hem de aynı eklentinin pazaryeri listesidir (label,
plugin_description, tags, icon, visibility, stat). Eşitlenmesi gereken ayrı bir liste kaydı yoktur.
Proje kurulumu
Bir eklentiyi bir projeye kurmak (install_plugin) üç şey yapar: paketi o projenin kendi
node_modules klasörüne (plugins_drive_path altında, proje başına bir ağaç, paylaşılan genel bir
kurulum değil) npm ile kurar, eklentiyi projenin app_plugins_purchased eşlemesine kaydeder (kurulu,
sürüm, bildirim, plugin_type) ve projeyi yeniden derleme gerektiren olarak işaretler
(set_update_required_to_app).
Bir eklentinin kodu gerçekte nerede çalışır
Bir eklenti en fazla üç farklı yer için kod gönderebilir ve yalnızca dosyanın var olduğu yerde çalışır:
- Tarayıcıda, eklentinin kurulu olduğu her yayımlanmış uygulamanın içinde,
runtime.mjsile. Bu, bir arayüz eklentisinin eklendiği her öğe için bir kez çağrılanfn(plugin_name, element, properties)işlevidir. - Sunucuda, projenin içinde,
server.mjsile. Bir kütüphane eklentisininmethodsişlevlerinin gerçekte uygulandığı ve bir veri (dbs) eklentisinin arka depoyla konuştuğu yerdir. - Studio'nun kendi içinde, proje oluşturulurken,
studio.mjsile. Birdbseklentisi bunu Studio tablo görünümüne karşı kendi canlı sorgularını çalıştırmak için kullanır.
Bir kullanıcının bir eklentiyi kurmadan önce gördüğü kurulum onay ekranı, doğrudan eklentinin bildiriminin bu dosyalardan hangilerini gönderdiğini söylediğine göre oluşturulur. Bildirimin yalnızca bir derleme çıktısı değil, eklentinin kurulumu yapan kişiyle sözleşmesi olmasının nedeni budur.