Eklentilerin amaçlandığı gibi çalıştığından emin olmak için yayınlanmadan önce kapsamlı bir şekilde test edilmesi gerekir. 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 bilgiler şu amaçlarla kullanılabilir:
- Bağımsız bir komut dosyasında yazılan bir eklentinin, bir e-tabloya, dokümana, sunuya veya forma uygulandığında beklendiği gibi çalıştığını doğrulayın.
- Eklenti yükleme akışının, özellikle farklı ilk yetkilendirme yaşam döngüsü durumları (yüklendi, etkinleştirildi veya her ikisi de) için beklendiği gibi çalıştığını doğrulayın.
- Eklentinin, belirli bir doküman ve içeriği üzerinde işlem yaparken beklendiği 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 birleşimidir. Bir komut dosyası sürümü geliştirdikten sonra bunu eklenti olarak test etmek istiyorsanız aşağıdaki adımları uygulayın:
- 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 > Test dağıtımları'nı tıklayın.
- Tür seçin'in yanındaki Dağıtım türlerini etkinleştir'i tıklayın ve Düzenleyici eklentisi'ni seçin.
- Yeni test oluştur'u 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 ilk yetkilendirme durumunu seçin.
- Test dokümanı 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çip Ekle'yi tıklayın.
- Testi kaydet'i tıklayın.
Kayıtlı tüm test dağıtımları Test dağıtımları iletişim kutusunda görünür. Bu sayede aynı test dağıtımını daha sonra tekrar ziyaret edebilirsiniz.
Test dağıtımı gerçekleştirme
Kaydedilmiş bir veya daha fazla 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 > Test dağıtımları'nı tıklayın.
- Kaydedilmiş Testler bölümünde, çalıştırmak istediğiniz kaydedilmiş test dağıtımının yanındaki radyo düğmesini seçip 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üsü ve kullanıcı arayüzü öğeleriyle etkileşim kurarak eklentinin amaçlandığı şekilde çalıştığını doğrulayabilirsiniz.
Eklentinizde ayrıntılı OAuth özelliğini test etmek için projenizde henüz yetkilendirme bulunmadığından emin olun. Mevcut yetkilendirmeleri geçersiz kılmak için ScriptApp.invalidateAuth'ı kullanın.
Test ayrıntıları
Editor eklentilerini bu şekilde test ederken aklınızda bulundurmanız 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 etmeye 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üzenleyenleriyle paylaşabileceğiniz bir URL bulunur. Bu sayede, test ve geliştirme yaparken başkalarıyla daha kolay ortak çalışabilirsiniz.
- Eklentiniz Özellikler hizmetini kullanıyorsa özellikler kalıcı olur ve test dağıtımı bir sonraki çalıştırıldığında kullanılabilir olmaya devam eder.
- 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 ilk dağıtım çalıştırılırken kaydedilen özellikler ikinci dağıtım çalıştırılırken kullanılabilir ve bunun tersi de geçerlidir. Ancak bu durum yalnızca dağıtımlar aynı komut dosyasını ve test dokümanını kullanıyorsa geçerlidir.
- Test dağıtımı yaparsanız komut dosyasını daha önce çalıştırmadıysanız yetkilendirme yapmanız istenebilir. Test sırasında bir komut dosyasını yetkilendirmenin, komut dosyasını test dışında da yetkilendireceğini unutmayın.