Yerel geliştirme

Çevrimiçi Apps Komut Dosyası ortamını kullanarak bağlayıcıyla ilgili tüm görevleri gerçekleştirebilseniz de, bunların bazıları zaman içinde tekrarlanabilir ve hataya açık hale gelebilir.

dscc-gen, bu yinelenen görevleri ele almak üzere tasarlanmış özenli bir araçtır. Böylece, otomasyonla önlenebilecek hatalar yerine işletmenizin sorununu çözmeye odaklanabilirsiniz.

Koşullar

dscc-gen kullanılıyor

dscc-gen, yeni topluluk-bağlayıcı projeleri oluşturabilir veya mevcut projelerde kullanılabilir.

Mevcut bağlayıcılar

dscc-gen mevcut projelerle de kullanılabilir. Öncelikle scriptId öğenizi kopyalayın ve ardından aşağıdaki komutu çalıştırın (YOUR_SCRIPT_ID komutunu scriptId ile değiştirin):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Bağlayıcınızla ilgili birkaç ayrıntı girmeniz istenecektir. Halihazırda "Üretim" adlı bir dağıtımınız yoksa sizin için bir dağıtım oluşturulur. Mevcut kodunuz değiştirilmez ancak dscc-gen ürününün yapabileceği her şeye erişebilirsiniz.

Yeni bağlayıcılar

dscc-gen ile yeni bir topluluk bağlayıcısı oluşturmak için aşağıdaki komutu çalıştırın:

npx @google/dscc-gen connector

Yeni bağlayıcınız için birkaç ayrıntı girmeniz istenecektir. İlk kez kullananlardan clasp kimlik doğrulaması istenir. clasp, komut satırından Apps Komut Dosyası projeleri oluşturup değiştirmek için kullanabileceğiniz bir araçtır.

dscc-gen, istemleri tamamladıktan sonra yeni bir Apps Komut Dosyası projesi oluşturur ve yapabileceği her şeyi yazdırır.

dscc-gen uygulamasının yapabileceği işlemler neler?

Komut Açıklama
npm run open Apps Komut Dosyası'nda projenizi açın.
npm run push Yerel değişikliklerinizi Apps Komut Dosyası'na aktarın.
npm run watch Yerel değişiklikleri izleyin ve bunları Apps Komut Dosyası'na aktarın.
npm run prettier Topluluk standartlarını kullanarak kodunuzu biçimlendirin.
npm run try_latest Looker Studio'da en son kodla dağıtımı açın.
npm run try_production Looker Studio'da Üretim dağıtımınızı açın.
npm run update_production En son kodunuzu kullanmak için üretim dağıtımınızı güncelleyin.

Nasıl kullanmalıyım?

dscc-gen kullanımı genellikle aşağıdaki gibi olur:

  1. Bağlayıcınıza eklemek istediğiniz bir özelliği belirleyin.
  2. npm run watch komutunu çalıştırın. Böylece yerel değişiklikler Apps Komut Dosyası'na aktarılır.
  3. Kod değişikliklerinizi favori JavaScript düzenleyicinizi kullanarak yapın.
  4. npm run tryLatest komutunu çalıştırın ve yeni özelliğinizin beklendiği gibi çalışıp çalışmadığını kontrol edin.
  5. Üretim dağıtımınızı yeni özelliği içerecek şekilde güncellemek için npm run updateProduction komutunu çalıştırın.
  6. npm run tryProduction komutunu çalıştırın ve yeni özelliğin çalışıp çalışmadığını tekrar kontrol edin.

Komut dosyası kimliğinizi alın

scriptId öğenizi almak için mevcut projenize gidin, ardından URL'nin /d/ tarihinden sonraki ve /edit tarihinden önceki bölümünü kopyalayın. Örneğin: şu URL:

  • Orijinal URL: https://script.google.com/a/google.com/d/example-script-id/edit
  • Komut dosyası kimliği: example-script-id