İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Aggrega Wasm annotation-transform soketi şeması

Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.

Şema kimliği: https://aggrega.ai/schemas/wasm-annotation-transform-v1beta1.schema.json

annotation-transform rolüne bağlanan bir yönetişim eklentisinin tükettiği (AnnotationTransformInput) ve ürettiği (AnnotationTransformOutput) iletim biçimleri. Rol, çözümlemeden sonra ve ek açıklama genişletmesinden önce çalışır: eklenti, çözümlenmiş enjeksiyon hedeflerini ve Manifest’in kayıtlı bağlama anahtarlarını okur ve genişletme bağlı ek açıklamaları Feature eklerine dönüştürmeden önce ana makinenin bu hedeflere uyguladığı ek açıklama enjeksiyonlarının bir listesini döndürür. Go, Rust ve TypeScript yük türleri bu şemadan plugin-ABI paketlerine üretilir; böylece üç dil tek bir iletim biçimini okur ve yazar; bir konuk bunları bu paketlerden ya da kit bunları yeniden dışa aktarıyorsa eklenti kiti üzerinden içe aktarır.

Aşağıdaki biçimlerden biri

  • AnnotationTransformInput
  • AnnotationTransformOutput

Tanımlar

AnnotationTransformInput

Ana makinenin her çağrıda annotation-transform eklentisine verdiği yük: geçerli ek açıklamalarıyla birlikte çözümlenmiş enjeksiyon hedefleri, Manifest’in kayıtlı ek açıklama bağlama anahtarları ve ekin kendi sabitlenmiş kaynakları ve ayarları.

ÖzellikTürZorunluAçıklama
targetsAnnotationTarget[]evetEnjeksiyon hedefleri: eklentinin ek açıklama enjekte edebileceği çözümlenmiş bileşenler; eklentinin mevcut bir anahtarın üzerine yazmadan neyi ekleyeceğine karar verebilmesi için her biri geçerli ek açıklama kümesiyle birlikte gelir. Ana makine tarafından belirlenimci olarak sıralanır.
binding_keysstring[]evetManifest’in bağlama kaydettiği ek açıklama anahtarları, yazarın sırasıyla. Anahtarı kayıtlı olan bir enjeksiyon bir Feature ekine genişler; eklenti yalnızca bağlanacak anahtarları enjekte etmek için bu listeyi okur. Ana makine, bir enjeksiyonun kayıtlı bir anahtarı adlandırmasını zorunlu tutmaz; kayıtsız enjekte edilmiş bir ek açıklama, yazar tarafından yazılmış bağlanmamış bir ek açıklamayla tam olarak aynı şekilde davranır.
sourcesAnnotationSource[]hayırAna makinenin okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış bir liste hâlindeki tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz.
settingsobjecthayırAna makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz.

Ek özelliklere izin verilmez.

AnnotationTransformOutput

annotation-transform eklentisinin ürettiği yanıt biçimi: ana makinenin adlandırılan hedeflere uyguladığı ek açıklama enjeksiyonlarının bir listesi. Ana makine yalnızca mevcut hedef koordinatlarına ek açıklama eklemelerini uygular; her biri bir yazarın o ek açıklamaya yazabileceği bir değer taşır: bir string ya da alt anahtarlardan oluşan bir nesne. Var olmayan bir koordinatı adlandıran ya da başka herhangi bir biçimde değer taşıyan bir enjeksiyon derlemeyi açıkça durdurur.

ÖzellikTürZorunluAçıklama
injectionsAnnotationInjection[]evetSırayla uygulanacak ek açıklama enjeksiyonları. Her biri mevcut bir hedef koordinatını ve oraya eklenecek ek açıklama anahtarını ve değerini adlandırır.
errorstringhayırKonuk çalıştığı ancak işlemi tamamlayamadığı zaman ayarlanan hata iletisi; başarıda bulunmaz. Ana makine, mevcut bir hatayı başarısız bir eklenti çağrısı olarak gösterir.

Ek özelliklere izin verilmez.

AnnotationTarget

Eklentinin ek açıklama enjekte edebileceği tek bir çözümlenmiş enjeksiyon hedefi: sınır yolu ve bileşen adı ile bileşenin halihazırda taşıdığı ek açıklama kümesi.

ÖzellikTürZorunluAçıklama
boundary_pathstringevetBileşenin Release içinde altında bulunduğu, eğik çizgiyle ayrılmış sınır yolu.
component_namestringevetBileşenin kendi sınırı içindeki adı.
annotationsstring, object veya null eşlemievetRelease’in bileşenin kendisine yazdığı ek açıklamalar; ek açıklama anahtarına göre anahtarlanmış ve yazıldıkları sırayla. Her değer yazarın yazdığı şeydir: bir string, kendi yazılış sırasındaki alt anahtarlardan oluşan bir nesne ya da bileşenin aksi halde devralacağı bir ek açıklamadan vazgeçtiği yerde null. Değeri ne olursa olsun her anahtar bulunur; böylece bir eklenti, bileşenin zaten taşıdığı bir ek açıklamayı taşımadığından ayırt edebilir ve yalnızca eksik olanı ekleyebilir.

Ek özelliklere izin verilmez.

AnnotationInjection

Bir hedefe enjekte edilecek tek bir ek açıklama: hedef koordinatı ile ek açıklama anahtarı ve değeri.

ÖzellikTürZorunluAçıklama
boundary_pathstringevetHedef bileşenin eğik çizgiyle ayrılmış sınır yolu. Ana makinenin sağladığı bir hedefi adlandırmalıdır; bilinmeyen bir koordinat derlemeyi durdurur.
component_namestringevetHedef bileşenin adı. Ana makinenin sağladığı bir hedefi adlandırmalıdır; bilinmeyen bir koordinat derlemeyi durdurur.
annotation_keystringevetHedef bileşene eklenecek ek açıklama anahtarı.
annotation_valuestring veya objectevetEk açıklamanın JSON olarak taşınan değeri: bir string ya da anahtarları alt anahtarlar, girdileri ise bir yazarın yapılandırılmış bir ek açıklamanın alt anahtarı altına yazabileceği şeyler olan bir nesne. Ana makine bunu, Release’te bileşene yazılmış aynı değeri okuduğu şekilde tam olarak okur ve nesnenin anahtar sırasını korur; böylece bir nesne birden çok alt anahtarı aynı anda yönlendiren bir bağlamayı, bir string ise tek bir alt anahtarı yönlendiren bir bağlamayı besleyebilir. Null, liste, sayı, boolean ve alt anahtarı olmayan bir nesne, enjeksiyon adlandırılarak reddedilir: bir enjeksiyon bir ek açıklama ekler ve hiçbir zaman bir ek açıklamayı kaldırmaz ya da ondan vazgeçmez.

Ek özelliklere izin verilmez.

AnnotationSource

Eklentiye verilen tek bir tanım dosyası: temel ad yolu ve dosyanın içeriği. İkisi de olduğu gibi taşınır; ana makine içeriği ayrıştırmaz.

ÖzellikTürZorunluAçıklama
pathstringevetKaynak dosyanın temel adı. Ana makine hiçbir zaman mutlak bir ana makine yolu değil, yalnızca temel adı sağlar; böylece iletim taşınabilir ve belirlenimci olur.
contentstringevetKaynak dosyanın opak bir string olarak olduğu gibi taşınan içeriği.

Ek özelliklere izin verilmez.