Düzenleyici Eklentisini test etme

Eklentiler, amaçlandığı gibi çalıştıklarından emin olmak için yayınlanmadan önce kapsamlı bir şekilde test edilmelidir. Apps Komut Dosyası, Düzenleyici Eklentileri'ni belirli Google Dokümanlar E-Tablolar, Formlar veya Slaytlar dosyalarında geliştirme aşamasında test etmenize olanak tanır. Bu özellik şu amaçlarla kullanılabilir:

  • Bağımsız bir komut dosyasında yazılan eklentinin bir sayfaya, dokümana, sunuya veya forma uygulandığında amaçlanan şekilde çalıştığını doğrulayın.
  • Eklenti yükleme akışının, özellikle farklı başlangıç yetkilendirme yaşam döngüsü durumları (yüklendi, etkinleştirildi veya her ikisi) için amaçlandığı şekilde çalıştığını doğrulayın.
  • Belirli bir doküman ve içeriği üzerinde işlem yaparken eklentinin amaçlandığı gibi çalıştığını doğrulayın.
  • Eklentinin mevcut ve önceki sürümlerini test edip karşılaştırın.

Test dağıtımı oluşturma

Test dağıtımı, bir eklenti ile test dokümanının bileşimidir. Geliştirdiğiniz komut dosyası sürümünü eklenti olarak test etmek isterseniz aşağıdaki adımları uygulayın:

  1. Henüz yoksa eklentiyi test etmek için bir e-tablo, doküman, sunu veya form oluşturun.
  2. Eklentinizi içeren komut dosyası projesini açın.
  3. Dağıt > Dağıtımları test et'i tıklayın.
  4. Tür seç'in yanında, Dağıtım türlerini etkinleştir'i tıklayın ve Düzenleyici Eklentisi'ni seçin.
  5. Yeni test oluştur veya Test ekle'yi tıklayın.
  6. Bir kod sürümü veya En son kod'u seçin.
  7. Yapılandırma bölümünde test için ilk yetkilendirme durumunu seçin.
  8. Dokümanı test et bölümünde, Doküman seçilmedi'yi tıklayın. Eklentiyi test etmek için kullanmak istediğiniz E-Tablolar, Dokümanlar, Slaytlar veya Formlar dosyasını seçin ve Ekle'yi tıklayın.
  9. Testi kaydet'i tıklayın.

Kaydedilen tüm test dağıtımları, Dağıtımları test et iletişim kutusunda görünür. Böylece daha sonra aynı test dağıtımını tekrar ziyaret edebilirsiniz.

Test dağıtımı çalıştırma

Bir veya daha fazla kayıtlı test dağıtımınız varsa aşağıdaki adımları uygulayarak bunlardan birini çalıştırabilirsiniz:

  1. Eklentinizi içeren komut dosyası projesini açın.
  2. Dağıt > Dağıtımları test et'i tıklayın.
  3. Kayıtlı Testler bölümünde, çalıştırmak istediğiniz kayıtlı test dağıtımının yanındaki radyo düğmesini seçin ve Yürüt'ü tıklayın.

Test dokümanı yeni bir sekmede açılır. Eklenti, test dağıtımında belirtilen yetkilendirme durumundadır. Eklentinin menü ve kullanıcı arayüzü öğeleriyle etkileşimde bulunarak istenen şekilde çalıştığını doğrulayabilirsiniz.

Test ayrıntıları

Bu şekilde Düzenleyici Eklentilerini test ederken göz önünde bulundurulması gereken birkaç nokta vardır:

  • Test sırasında yüklenebilir tetikleyiciler desteklenmez. Yüklenebilir tetikleyicilere bağlı işlevler test edilemez.
  • En son kodla test etmek üzere ayarlanmış bir test dağıtımını çalıştırırken, test dokümanını yenileyerek eklenti komut dosyasına kaydedilen değişiklikleri görebilirsiniz.
  • Test dokümanı, orijinal test dokümanının düzenleyicileriyle paylaşabileceğiniz bir URL'ye sahiptir. Bu şekilde, test ve geliştirme sırasında diğer kullanıcılarla daha kolay iş birliği yapabilirsiniz.
  • Eklentiniz Özellikler hizmetini kullanıyorsa özellikler korunur ve test dağıtımının bir sonraki çalıştırılışında kullanılabilir durumda kalır.
  • Ayrıca aynı eklenti ve test belgesi kombinasyonunu kullanan tüm test dağıtımları aynı mülk bilgilerine erişebilir. Örneğin, iki test dağıtımı oluşturursanız ilk dağıtım çalıştırılırken kaydedilen özellikler, ikincisi çalıştırılırken kaydedilen özellikler ve ikincisi çalıştırılırken kaydedilen özellikler, yalnızca dağıtımlar aynı komut dosyasını ve test belgesini kullanıyorsa kullanılabilir.
  • Bir test dağıtımı çalıştırırsanız komut dosyasını daha önce çalıştırmadıysanız yetkilendirme istenebilir. Bir komut dosyasını test ederken yetkilendirmenin, komut dosyasını test dışında da yetkilendirdiğini unutmayın.