Eklentiler, amaçlandıkları şekilde çalıştıklarından emin olmak için yayınlanmadan önce kapsamlı bir şekilde test edilmelidir. Apps Komut Dosyası; geliştirme aşamasındaki Düzenleyici Eklentilerini, belirli Google Dokümanlar E-Tablolar, Formlar veya Slaytlar dosyalarında test etmenize olanak tanır. Bu, şu amaçlarla kullanılabilir:
- Bağımsız bir komut dosyasıyla yazılan eklentinin bir e-tabloya, dokümana, sunuya veya forma uygulandığında amaçlandığı gibi çalıştığını doğrulayın.
- Eklenti yükleme akışının, özellikle farklı başlangıç yetkilendirme yaşam döngüsü durumları (yüklü, etkin veya her ikisi) için amaçlandığı gibi çalıştığını doğrulayın.
- Belirli bir doküman ve içeriği üzerinde işlem yaparken eklentinin amaçlandığı şekilde ç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 eklentinin ve test dokümanının birleşimidir. Hazırladığınız bir komut dosyası sürümü varsa ve bu sürümü eklenti olarak test etmek istediğinizde şu adımları izleyin:
- Henüz yoksa eklentiyi test etmek için bir e-tablo, doküman, sunu veya form oluşturun.
- Eklentinizi içeren komut dosyası projesini açın.
- Dağıt > Dağıtımları test et'i tıklayın.
- Tür seçin'in yanında Dağıtım türlerini etkinleştir'i tıklayın ve Düzenleyici Eklentisi'ni seçin.
- Yeni test oluştur veya Test ekle'yi tıklayın.
- Bir kod sürümü seçin veya En Son Kod'u seçin.
- Config (Yapılandırma) bölümünde, test için başlangıç yetkilendirme durumunu seçin.
- 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.
- Testi kaydet'i tıklayın.
Tüm kayıtlı test dağıtımları, Dağıtımları test et iletişim kutusunda görünür. Bu, aynı test dağıtımını daha sonra yeniden ziyaret etmenize olanak tanır.
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:
- Eklentinizi içeren komut dosyası projesini açın.
- Dağıt > Dağıtımları test et'i tıklayın.
- Kayıtlı Testler altında ç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 durumunda. Eklentinin menüsü ve kullanıcı arayüzü öğeleriyle etkileşim kurarak amaçlandığı gibi çalıştığını doğrulayabilirsiniz.
Test ayrıntıları
Düzenleyici Eklentilerini bu şekilde test ederken göz önünde bulundurmanız gereken birkaç nokta vardır:
- Test sırasında yüklenebilir tetikleyiciler desteklenmez. Yüklenebilir tetikleyicilere bağlı olan işlevler test edilemez.
- En son kodla test edilecek şekilde ayarlanmış bir test dağıtımı çalıştırırken test dokümanını yenileyerek eklenti komut dosyasına kaydedilen değişiklikleri görebilirsiniz.
- Test dokümanında, orijinal test dokümanının düzenleyicileriyle paylaşabileceğiniz bir URL bulunur. Bu sayede test ve geliştirme aşamasında başkalarıyla daha kolay iş birliği yapabilirsiniz.
- Eklentiniz Özellikler hizmetini kullanıyorsa test dağıtımı bir sonraki çalıştırıldığında özellikler kalıcı olur ve kullanılabilir durumda kalır.
- Ayrıca, aynı eklenti ve test dokümanı kombinasyonunu kullanan tüm test dağıtımları aynı mülk bilgilerine erişebilir. Örneğin, iki test dağıtımı oluşturursanız ilkini çalıştırırken kaydedilen özellikler, ikincisi çalıştırırken kullanılabilir. Bunun tersi de geçerlidir. Ancak, dağıtımlar aynı komut dosyasını ve test dokümanını kullanıyorsa bu özelliklerden yararlanılabilir.
- Bir test dağıtımı çalıştırırsanız ve komut dosyasını daha önce çalıştırmadıysanız yetkilendirmeniz istenebilir. Test sırasında bir komut dosyası yetkilendirmenin, komut dosyasını test dışında da yetkilendirdiğini unutmayın.