NNuvaka General AppGeliştirici belgeleri
ENİndir

Nuvaka › Geliştirici belgeleri › Ana sayfa widget'ları

Ana sayfa widget'ları

Her kullanıcı Nuvaka ana sayfasını sürükle-bırakla kendisi tasarlar. Uzantın bu sayfaya bir ya da daha çok widget sunabilir: kur, hava durumu, sayaç, yapılacaklar gibi küçük, kendi kutusunda çalışan bir görünüm. Düzen hesapta saklanır ve kullanıcının tüm cihazlarında aynı görünür.

Not: Uygulama desteği Nuvaka 0.3.1 ile gelir. Widget sunan uzantıda "minAppVersion": "0.3.1" kullan.

Manifest: contributes → home.widget

"entry": { "ui": "index.html" },
"pages": [
  { "id": "main", "title": { "tr": "Kurlar", "en": "Rates" } },
  { "id": "ticker", "title": { "tr": "Kur widget'ı", "en": "Rates widget" } }
],
"contributes": {
  "home.widget": [
    { "id": "ticker", "title": { "tr": "Kur", "en": "Rates" }, "page": "ticker",
      "sizes": [{ "w": 2, "h": 1 }, { "w": 4, "h": 2 }], "minRefreshSec": 300, "configurable": true, "icon": "chart-line" }
  ]
}
AlanKural
idzorunlu; [a-z0-9-]{1,30}, uzantı içinde tekil
titlezorunlu; { tr, en? }
pagezorunlu; widget'ın açacağı sayfa, pages içinde olmalı
sizes1–6 boyut, her biri { w: 1–4, h: 1–4 } (ızgara birimi). Kullanıcı yalnız bu boyutlardan birini seçebilir.
minRefreshSecisteğe bağlı; 60–86400. Verilmezse widget kendiliğinden yenilenmez.
configurableisteğe bağlı; true ise ana sayfada widget'ın "Ayarla" seçeneği görünür.
iconisteğe bağlı simge adı
  • Uzantı başına en çok 5 widget.
  • Widget'lar her sürümü incelemeye düşürmez. Her sürüm incelemesi yalnız Dosyalarım'a dokunan storage.* noktaları içindir (İnceleme kuralları).
  • Kurulum ekranının izin listesinde "Ana sayfa widget'ı" satırı görünür.
  • Mağaza kartında ve detayında widgets: [{ id, title, sizes }] döner (yoksa null); GET store?hasWidgets=true yalnız widget'lı uzantıları listeler.

Widget nasıl çalışır

  • Widget, uzantının sayfasının küçük bir çerçevede açılmış hâlidir. Kum havuzu, CSP ve izinler normal sayfayla aynıdır; ek bir yetkisi yoktur.
  • Sayfan widget olarak açıldığını nuvaka.ui.presentation() ile anlar: 'widget' döner. Bu kipte kendi menünü ve başlığını gizle, yalnız kutuya sığan özeti çiz.
  • Widget yalnız kendi kutusunun içine çizer. Tıklama uzantının ana sayfasını açar.
  • Ana sayfa görünmüyorsa widget duraklatılır (çerçeve silinmez). Yenileme minRefreshSec'ten sık olmaz.
  • Widget çerçeveleri açık uygulama sınırına (apps.keepAliveMax) sayılmaz; ana sayfada kendi sınırları vardır (ör. 12 canlı widget, gerisi "yüklemek için tıkla").
  • Boyut, ayar ve yeniden boyutlanma olayları için SDK'da nuvaka.ui.widget ad alanı 0.3.1 ile gelir; imzası yayınlanınca API başvurusuna eklenecek. O zamana kadar çerçevenin kendi boyutunu (window.innerWidth/innerHeight, resize olayı) kullan.

Düzen (bilgi için)

Düzeni kullanıcı düzenler; uzantılar ana sayfa düzenini okuyamaz ya da değiştiremez. Uygulama düzeni hesapta saklar (GET/PUT /api/home/layout, MVCC) ve değişiklik tüm cihazlara anında gider. Düzende widget tipi ext:<uzantı id>/<widget id> olarak durur. Uzantı kaldırılırsa widget düzenden silinmez, "uygulama kaldırıldı" olarak görünür; uzantı yeniden kurulunca geri gelir.

Nuvaka Apps API v1 · son güncelleme 2026-09-28