XCon Studio

Appearance

@xcons/cli-thingsboard - Genel Bakış ​

ThingsBoard Widget Yönetim CLI Aracı - ThingsBoard widget'larını oluşturmak, yönetmek ve dağıtmak için XCONS platform entegrasyonu ile geliştirilmiş komut satırı aracı.

Genel Tanım ​

XCONS ThingsBoard CLI, ThingsBoard widget'larının geliştirilmesi ve yönetimi için kapsamlı bir araçtır. Modern yapı araçları ve geliştirme ortamları ile kullanıma hazır TypeScript widget projeleri oluşturur.

Temel Özellikler ​

Widget Yönetimi ​

  • Widget Oluşturma: Tam kaynak kodlu ve yapılandırmalı yeni widget projeleri
  • Widget Listeleme: Sunucudaki widget'ları filtreleme ve JSON çıktısı ile
  • Widget Silme: ID veya isim ile widget silme işlemleri
  • Widget Kurulumu: Yerel projeden sunucuya widget yükleme

Widget Bundle Yönetimi ​

  • Bundle Listeleme: ThingsBoard sunucusundaki tüm widget bundle'ları
  • Bundle Oluşturma: Yeni widget bundle'ları oluşturma

Geliştirme Özellikleri ​

  • TypeScript Desteği: Decorator'lar ile tam TypeScript geliştirme
  • Modern Yapı Sistemi: XCONS Build Engine ile optimize edilmiş derleme
  • Harici Kütüphane Desteği: Konfigürasyon ile harici bağımlılık yönetimi
  • Debug Modu: Detaylı işlem bilgileri ve hata ayıklama
  • Üretim Yapıları: Optimize edilmiş ve minify edilmiş çıktılar

Kurulum ​

bash
# Doğrudan npx ile kullanım (önerilen)
npx @xcons/cli-thingsboard widget create my-widget

# Global kurulum
npm install -g @xcons/cli-thingsboard
xcons-thingsboard widget create my-widget

Temel Komutlar ​

Widget Komutları ​

  • widget create - Yeni widget projesi oluştur
  • widget list - Sunucudaki widget'ları listele
  • widget delete - Widget'ı sunucudan sil
  • widget install - Widget'ı sunucuya yükle
  • widget build - Widget projesini derle

Widget Bundle Komutları ​

  • widget-bundle list - Widget bundle'larını listele
  • widget-bundle create - Yeni widget bundle oluştur

Widget Türleri ​

TimeSeries (Zaman Serisi) ​

  • Geçmiş verileri zaman içinde görüntüle
  • Çoklu veri kaynağı desteği
  • Grafik kütüphanesi entegrasyonu

Latest Values (Son Değerler) ​

  • Güncel telemetri değerlerini göster
  • Grid tabanlı düzen
  • Özel birimler ve formatlama

RPC Control (RPC Kontrol) ​

  • Cihaz kontrol arayüzleri
  • Buton tabanlı etkileşimler
  • Komut geri bildirimi

Static (Statik) ​

  • Özel HTML içeriği
  • Bilgi panelleri
  • Dokümantasyon widget'ları

Proje Yapısı ​

Oluşturulan her widget tam geliştirme ortamı içerir:

my-widget/
├── .xcon/
│   └── config.json         # XCONS widget konfigürasyonu
├── .idea/                  # IntelliJ IDEA konfigürasyonu
├── src/
│   ├── index.ts           # Ana widget uygulaması
│   ├── index.html         # Widget HTML şablonu
│   └── style.css          # Widget stilleri
├── dist/                  # Derlenmiş widget dosyaları
├── package.json           # NPM konfigürasyonu
├── tsconfig.json          # TypeScript konfigürasyonu
└── README.md             # Widget dokümantasyonu

XCONS Platform Entegrasyonu ​

XCONS Build Engine ​

  • TypeScript derleme ve decorator desteği
  • Harici kütüphane yönetimi
  • Kaynak optimizasyonu
  • ThingsBoard wrapper otomasyonu

XCONS Widget Sistemi ​

  • @property decorator ile reaktif özellikler
  • @computed decorator ile hesaplanmış özellikler
  • @Widget decorator ile widget konfigürasyonu
  • Otomatik yaşam döngüsü yönetimi

Geliştirme İş Akışı ​

  1. Widget Oluştur

    bash
    xcons-thingsboard widget create my-sensor-widget

  2. Geliştir

    bash
    xcons-thingsboard widget build --debug

  3. ThingsBoard'a Yükle

    bash
    xcons-thingsboard widget install -h your-server:8080 -u username -p password

Debug Modu ​

Detaylı işlem bilgisi için debug modunu etkinleştirin:

bash
# Kurulum ile debug modu
xcons-thingsboard widget install --debug

# Derleme ile debug modu
xcons-thingsboard widget build --debug

Sistem Gereksinimleri ​

  • Node.js 18+
  • NPM 9+
  • ThingsBoard CE/PE 3.0+

Sonraki Adımlar ​

Bu genel bakış sonrasında, aşağıdaki dokümantasyonlara göz atabilirsiniz:

Destek ​

  • Dokümantasyon: ThingsBoard widget geliştirme kılavuzları
  • Sorunlar: GitHub'da CLI sorunlarını bildirin
  • Topluluk: XCONS Platform topluluk forumları
  • İletişim: support@xcon-studio.com

XCONS ThingsBoard CLI - Widget yönetimi artık çok basit