İçeriğe geç
Doğrulandı

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.mjs ile. Bu, bir arayüz eklentisinin eklendiği her öğe için bir kez çağrılan fn(plugin_name, element, properties) işlevidir.
  • Sunucuda, projenin içinde, server.mjs ile. Bir kütüphane eklentisinin methods işlevlerinin gerçekte uygulandığı ve bir veri (dbs) eklentisinin arka depoyla konuştuğu yerdir.
  • Studio'nun kendi içinde, proje oluşturulurken, studio.mjs ile. Bir dbs eklentisi 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.

Sonraki