İLK EKLENTİNİZ

Başlarken

SDK'yı kurun, şablondan bir eklenti açın, simülatörde deneyin ve paketleyin.

Node.js 20.10+Yerel simülatör3 başlangıç şablonu

Gerekenler: Node.js 20.10 veya üstü. Başka bir şey kurmanız gerekmez; simülatör platformu yerelde taklit eder.

1. Eklenti klasörü

npx @viswoo/plugin-sdk init hediye-cekilisi --template interactive
cd hediye-cekilisi
npm install

Üç şablon vardır:

Şablon	Ne içerir
`basic`	Ayar şeması (zorunlu alan, etiket, renk, sunucuya özel alan), panel sekmesi, ekran görünümü, yerleşim
`interactive`	Dokunmatik ekran ve QR’lı telefon sayfası, çekiliş havuzu, tek kullanımlık kod, kasada teslim, sayaçlar
`server`	Eklentinin kendi sunucusu (Node örneği): imza doğrulama, kurulum belirteci, platform API’si

Eklenti kodu (hediye-cekilisi) kalıcıdır: küçük harf, rakam ve tire, 3–40 karakter. Yayımlandıktan sonra değişmez.

2. Simülatör

npm run dev

http://localhost:5199 panel sekmesini, TV’yi ve telefonu yan yana açar. Köprü istekleri platformun kurallarıyla yanıtlanır: izinler, kullanıcı rolü, ayar şeması, sunucuya özel alanlar, çekiliş sınırları, kodlar. Dosyayı kaydettiğinizde çerçeveler yeniden açılır. Ayrıntılar: Geliştirme araçları.

3. Doğrulama ve paket

npm run validate   # paket kuralları ve ekran görünümünün ES5 denetimi
npm run pack       # dist/hediye-cekilisi-0.1.0.vzp

pack köprüleri ve kitleri (viswoo-panel.js, viswoo-ui.css …) SDK’dan ekler; bunları pakete koymazsınız. Ekran görünümü tek dosyaya gömülür.

4. Yükleme ve yayın

Geliştirici portalında hesap açın, eklenti kodunu ayırın ve paketi yükleyin (ya da VISWOO_TOKEN=vzd_… npx viswoo-plugin publish .). Taslak sürümü kendi test alanınızda gerçek ekranda deneyin. Süreç: Yayın ve inceleme.

Sonraki adımlar

Kavramlar: eklentinin parçaları ve yaşam döngüsü
Manifest: viswoo-plugin.json alanları ve ayar şeması
Tasarım standardı: kitler ve inceleme kontrol listesi
Örnekler: Çarkıfelek’in kaynağı