Partner Portal
T-SOFT/Uygulama Geliştirme/CLI ile Geliştirme

CLI ile Geliştirme

tsoft-cli ile bir uygulamayı terminalden açar, test mağazanızda çalıştırır ve yayınlarsınız. Partner panelinde yaptığınız işlerin çoğu bu dört komutla yapılır.

npm install -g tsoft-cli
tsoft app login           # partner hesabına tarayıcıdan giriş
tsoft app init            # şablondan uygulama ve proje
tsoft app dev             # test mağazasında canlı geliştirme
tsoft app deploy          # ayarları ve vitrin eklentisini yayınlama

Giriş: tsoft app login

Tarayıcıda partner hesabınızla (login.tsoft360.com) giriş yaparsınız. Oturum ~/.tsoft-cli/partner.json dosyasında yalnız sizin okuyabileceğiniz izinle durur ve kendiliğinden yenilenir. tsoft app logout oturumu kapatır.

init, dev, deploy ve config pull bu oturumu kullanır. CI'da oturum yerine organizasyon deploy token'ı verin (TSOFT_DEPLOY_TOKEN).

Uygulama açma: tsoft app init

tsoft app init stok-alarmi --name "Stok Alarmı" --template both

Organizasyonunuzda geliştirme türünde bir uygulama açar ve klasöre bir proje yazar. Geliştirme türündeki uygulama yalnız organizasyonunuzun test mağazalarına kurulur, markette görünmez.

Şablonİçerik
serverCloudflare Worker: OAuth kurulumu, panel içinde açılan sayfa, kaldırma bildirimi
embedVitrine eklenen betik ve kurulum formu
bothİkisi birlikte

Uygulama sırrı yalnız server/.dev.vars dosyasına yazılır, ekrana basılmaz ve repoya girmez. Birden çok organizasyonunuz varsa --org ile seçin.

Test mağazasında çalıştırma: tsoft app dev

cd stok-alarmi
(cd server && npm install)
tsoft app dev

tsoft app dev şunları yapar:

  1. Yerel sunucu. server/ şablonu varsa wrangler dev ile 8787 portunda başlatır. Kendi sunucunuzu kullanıyorsanız --port 3000 verin.
  2. Tünel. cloudflared ile hesap gerektirmeyen bir hızlı tünel açar (https://…trycloudflare.com).
  3. Geçici adresler. tsoft.app.toml içindeki [app] url, [auth] redirect_urls, [webhooks] uninstall_url ve privacy_url adreslerini çalışma boyunca tünel adresine çeker. Adresin yolu korunur. Şablonda boş bırakılan adresler /app, /callback ve /webhooks/uninstalled olur.
  4. Kurulum. Uygulama test mağazalarınızın hiçbirinde kurulu değilse bir günlük kurulum linki üretir ve tarayıcıda açar. Mağaza panelinde kurulumu onaylarsınız.
  5. Vitrin önizlemesi. [embed] path klasörünü izler. Her kayıtta paketi taslak olarak yükler. Taslak incelemeye gitmez, e-posta göndermez, bir önceki taslağın yerini alır ve yalnız test mağazalarınızda yüklenir. Mağaza sayfasını yenileyince yeni betik gelir.

Ctrl+C ile çıkınca adresler çalışmadan önceki değerlerine döner. Terminal kapanır ya da süreç çökerse geri alınacak değerler .tsoft/dev-restore.json dosyasında kalır. Bir sonraki tsoft app dev çalışması önce bunları geri yazar.

tsoft app dev adresleri uygulamanın bütün kurulumları için değiştirir. Bu yüzden yalnız geliştirme türündeki uygulamada çalışır. Özel ya da herkese açık bir uygulamayı denemek için ayrı bir geliştirme uygulaması açın.
SeçenekNe yapar
--port <port>Kendi çalıştırdığınız sunucunun portu; wrangler dev başlatılmaz
--no-serverSunucu ve tünel olmadan yalnız vitrin önizlemesi

Gereksinimler:

  • cloudflared (macOS'ta brew install cloudflared)
  • Organizasyonunuzda en az bir test mağazası (partner panelinde mağaza erişimi isteyerek eklenir)

Yayınlama: tsoft app deploy

tsoft.app.toml ayarlarını ve vitrin eklentisini yeni bir uygulama sürümü olarak gönderir. Panelde son yayından sonra değişen bir alan ya da yeni bir izin varsa önce onay ister. tsoft app config pull paneldeki ayarları dosyaya geri yazar.

Ayar alanlarının tam listesi ve CI kullanımı için tsoft-cli README sayfasına bakın.