Hızlı başlangıç

T1 trusted local Node kodudur ve sandbox değildir. Yalnız incelediğiniz ve güvendiğiniz kaynağı çalıştırın.

Bu sayfa sıfırdan çalışan bir T1 (yerel geliştirme) plugin’ini anlatır: proje oluştur → evoX’e yükle → tuşa ata → cihazda gör. Tier’ler için önce Trust tier’ları sayfasına bakabilirsiniz:

T0 · Veri paketi

Profil/ikon/ses — kod yok, bugün yayınlanabilir.

T1 · Yerel dev

Bu sayfa. Ayrı Node process, sandbox değil.

T2 · Public sandbox

Default-deny capability; public upload kapalı.

1. Projeyi oluşturun

Node.js 20+ yeterli; kurulum gerekmez:

npx @evoxapp/plugin-cli init my-plugin --runtime trusted-node --name "İlk Plugin"
cd my-plugin
npm install

Şablon şunları üretir:

my-plugin/
├── manifest.json    # Host sözleşmesi: kimlik, runtime, izinler, aksiyonlar
├── runtime.mjs      # Plugin giriş noktası (SDK client + event handler'lar)
├── package.json     # @evoxapp/plugin-sdk bağımlılığı
└── README.md        # Bu adımların özeti

runtime.mjs içinde hazır bir örnek vardır: Merhaba aksiyonu tuşta göründüğünde “Merhaba” yazar, basınca saati gösterir.

client.on('action.keyDown', async (event) => {
  if (event.context?.actionId !== 'hello') return;
  await client.setTitle(event.context.bindingInstanceId, new Date().toLocaleTimeString('tr-TR', { hour: '2-digit', minute: '2-digit' }));
  await client.showSuccess(event.context.bindingInstanceId);
});

2. evoX’e yükleyin

Geliştirici penceresini açın

evoX masaüstünde Eklentiler bölümüne gidin ve üst çubuktaki Geliştirici butonuna tıklayın.

Projeyi seçin

Proje seç ile my-plugin klasörünü seçin. Manifest host tarafından doğrulanır; hata varsa açık mesaj görürsünüz.

Güven verin ve başlatın

T1 risk metnini okuyup güveni onaylayın, ardından plugin’i başlatın. Plugin ayrı bir Node process olarak çalışır; durumunu ve loglarını aynı pencereden izlersiniz.

Tuşa atayın

Tuşlar ekranında aksiyon kitaplığından Merhaba aksiyonunu bir tuşa atayın. Tuşta “Merhaba” görünür; basınca saat yazılır.

3. Geliştirme döngüsü

Kodu değiştirin → Geliştirici penceresinden yeniden yükle. Uygulamayı kapatmanız gerekmez.
Loglar aynı pencerede bounded/redacted gösterilir; console.error çıktınız buraya düşer.
Kimlik hosta aittir: client.session.plugin.pluginId atanır, plugin kendi kimliğini/izinlerini seçemez.

Sonraki adımlar

Entegrasyon plugini yaz

OBS/Twitch/Spotify tarzı Market entegrasyonları (tam Node + npm).

İlk gerçek plugin (tutorial)

Ayarlar + host-brokered ağ ile hava durumu göstergesi yapın.

Event referansı

Tüm event ve host-RPC yüzeyi.

Manifest

Runtime, izin ve aksiyon alanları.

Public hedef (T2)

sandbox-js projesi: npx @evoxapp/plugin-cli init my-plugin (varsayılan) — public upload açılınca yayın hedefi.

Başlangıç

Temel kavramlar

Örnekler ve dağıtım

T0 · Veri paketi

T1 · Yerel dev

T2 · Public sandbox

1. Projeyi oluşturun

2. evoX’e yükleyin

3. Geliştirme döngüsü

Sonraki adımlar

Entegrasyon plugini yaz

İlk gerçek plugin (tutorial)

Event referansı

Manifest

Public hedef (T2)

T0 · Veri paketi

T1 · Yerel dev

T2 · Public sandbox

​1. Projeyi oluşturun

​2. evoX’e yükleyin

​3. Geliştirme döngüsü

​Sonraki adımlar

Entegrasyon plugini yaz

İlk gerçek plugin (tutorial)

Event referansı

Manifest

Public hedef (T2)

1. Projeyi oluşturun

2. evoX’e yükleyin

3. Geliştirme döngüsü

Sonraki adımlar