Testowanie i debugowanie dodatków Apps Script do Google Workspace

Gdy opublikujesz dodatek, użytkownicy będą mogli go zainstalować za pomocą aplikacji hosta lub Google Workspace Marketplace. Przed opublikowaniem przetestuj dodatki opracowane w ramach aplikacji hosta, które rozszerzają.

Na tej stronie dowiesz się, jak zainstalować dodatek, który jest w trakcie opracowywania (nazywany nieopublikowanym lub dodatkiem programisty), aby był używany do testów lub do użytku osobistego. Dodatki możesz debugować za pomocą debugera i punktów przerwania dostępnego w Apps Script IDE.

Wymagania wstępne

  • Musisz mieć uprawnienia do edycji projektu skryptu dodatku.
  • Aby umożliwić innym osobom w organizacji testowanie dodatku, przyznaj im uprawnienia do edycji projektu skryptu. Szczegółowe informacje o przyznawaniu dostępu znajdziesz w artykule Współpraca z innymi deweloperami.

Instalowanie nieopublikowanego dodatku

Możesz instalować nieopublikowane dodatki z okna Wdrożenia Apps Script.

Aby zainstalować nieopublikowany dodatek do Google Workspace na potrzeby testów, wykonaj te czynności:

  1. Otwórz projekt skryptu w edytorze Apps Script.
  2. Kliknij Wdróż > Testuj wdrożenia.
  3. Kliknij Install (Zainstaluj).
  4. U dołu kliknij Gotowe.

Możesz zezwolić innym użytkownikom na testowanie dodatku, udostępniając im projekt Apps Script (wymagane są uprawnienia do edycji). Następnie poproś użytkowników o wykonanie czynności opisanych powyżej.

Po zainstalowaniu dodatek jest natychmiast dostępny w rozbudowanych aplikacjach hosta. Może być konieczne odświeżenie karty aplikacji hosta, zanim dodatek się pojawi. Przed użyciem dodatku musisz go autoryzować.

Odinstalowywanie nieopublikowanego dodatku

Aby odinstalować nieopublikowane wdrożenie dodatku:

  1. Otwórz projekt skryptu w edytorze Apps Script.
  2. Kliknij Wdróż > Testuj wdrożenia.
  3. Kliknij Odinstaluj.
  4. U dołu kliknij Gotowe.

Wykonanie tych czynności spowoduje natychmiastowe usunięcie wdrożenia, a dodatek nie będzie już widoczny w żadnej aplikacji hosta. W każdej chwili możesz ponownie zainstalować wdrożenie, powtarzając procedurę instalacji.

Sprawdzone metody testowania

Podczas testowania dodatku do Google Workspace postępuj zgodnie ze sprawdzonymi metodami tworzenia dodatków. Dodatkowo wykonaj te czynności:

  1. Przetestuj dokładnie przebieg nawigacji po karcie we wszystkich aplikacjach hosta rozszerzenia. Upewnij się, że dodatek działa prawidłowo, gdy użytkownik przechodzi z kontekstu do kontekstu oraz z kart kontekstowych i niekontekstowych.

  2. Użyj przykładowych danych testowych, aby ocenić działanie dodatku.

  3. Jeśli dodatek łączy się z interfejsem API innej firmy lub inną usługą, sprawdź, czy usługa jest dostępna i działa zgodnie z oczekiwaniami. Upewnij się, że dodatek prawidłowo obsługuje dane autoryzacji i logowania.

  4. Zadbaj o odpowiednią obsługę wszystkich warunków błędów. W razie potrzeby użyj kart błędów.

  5. Zwróć uwagę na wydajność dodatku. Jeśli po zmianie kodu dodatek zacznie działać wolniej, być może trzeba będzie usunąć lub przerobić tę funkcję.