Apps Komut Dosyası Google Workspace eklentilerini test etme ve hata ayıklama

Yayınladığınız eklentileri kullanıcılar, barındıran uygulama veya Google Workspace Marketplace üzerinden yükleyebilir. Geliştirdiğiniz eklentileri, yayınlamadan önce genişlettikleri ana uygulamalarda test edin.

Bu sayfada, geliştirme aşamasındaki bir eklentinin (yayınlanmamış veya geliştirici eklentisi olarak adlandırılır) test veya kişisel kullanım için nasıl yükleneceği açıklanmaktadır. Ayrıca, Apps Script IDE'nin hata ayıklayıcısını ve kesme noktalarını kullanarak eklentilerde hata ayıklama yapabilirsiniz.

Ön koşullar

  • Eklentinin komut dosyası projesine düzenleyici erişiminiz olmalıdır.
  • Kuruluşunuzdaki diğer kullanıcıların eklentiyi test etmesine izin vermek için komut dosyası projesine düzenleyici erişimi verin. Erişim verme hakkında ayrıntılı bilgi için Diğer Geliştiricilerle Ortak Çalışma başlıklı makaleyi inceleyin.

Yayınlanmamış bir eklentiyi yükleme

Yayınlanmamış eklentileri Apps Komut Dosyası'nın Dağıtımlar iletişim kutusundan yükleyebilirsiniz.

Test için yayınlanmamış bir Google Workspace eklentisini yüklemek üzere aşağıdaki adımları uygulayın:

  1. Komut dosyası projesini Apps Script düzenleyicisinde açın.
  2. Dağıt > Dağıtımları test et'i tıklayın.
  3. Yükle'yi tıklayın.
  4. Alt tarafta Bitti'yi tıklayın.

Apps Script projesini hesaplarıyla paylaşarak diğer kullanıcıların eklentiyi test etmesine izin verebilirsiniz (düzenleme erişimi gereklidir). Ardından kullanıcılardan yukarıdaki adımları uygulamalarını isteyin.

Yüklenen eklentiler, genişlettikleri ana uygulamalarda hemen kullanılabilir. Eklenti görünmeden önce ana makine uygulaması sekmesini yenilemeniz gerekebilir. Ayrıca, eklentiyi kullanmadan önce yetkilendirmeniz gerekir.

Yayından kaldırılan eklentileri kaldırma

Yayınlanmamış bir eklenti dağıtımını kaldırmak için aşağıdaki adımları uygulayın:

  1. Komut dosyası projesini Apps Script düzenleyicisinde açın.
  2. Dağıt > Dağıtımları test et'i tıklayın.
  3. Kaldır'ı tıklayın.
  4. Alt tarafta Bitti'yi tıklayın.

Bu adımlar, dağıtımı hemen kaldırır ve eklenti artık hiçbir barındırma uygulamasında görünmez. Yükleme prosedürünü tekrarlayarak dağıtımı dilediğiniz zaman yeniden yükleyebilirsiniz.

Testlerle ilgili en iyi uygulamalar

Google Workspace eklentinizi test ederken eklenti geliştirmeyle ilgili en iyi uygulamaları izlediğinizden emin olun. Ayrıca aşağıdakileri yaptığınızdan emin olun:

  1. Eklentinin genişlettiği tüm ana uygulamalarda test kartı gezinme akışını ayrıntılı olarak test edin. Kullanıcı bağlamdan bağlama ve bağlam dışı ile bağlama dayalı kartlar arasında geçiş yaparken eklenti davranışının doğru olduğundan emin olun.

  2. Eklentinizin davranışını değerlendirmek için örnek test verilerini kullanın.

  3. Eklentiniz bir üçüncü taraf API'ye veya başka bir hizmete bağlanıyorsa hizmete erişilebildiğini ve beklendiği gibi davrandığını doğrulayın. Eklentinizin yetkilendirme ve giriş ayrıntılarını doğru şekilde işlediğinden emin olun.

  4. Tüm hata koşullarının uygun şekilde ele alındığından emin olun. Gerekirse hata kartlarını kullanın.

  5. Eklentinin performansına dikkat edin. Kodda yaptığınız bir değişiklikten sonra eklenti yavaşlamaya başlarsa bu özelliği kaldırmanız veya yeniden çalışmanız gerekebilir.