Testowanie i debugowanie dodatków do Google Workspace za pomocą Apps Script

Po opublikowaniu dodatku użytkownicy mogą go zainstalować za pomocą aplikacji hosta lub Google Workspace Marketplace. Zanim opublikujesz dodatki, przetestuj je w aplikacjach hostujących, które rozszerzają.

Na tej stronie opisaliśmy, jak zainstalować dodatek, który jest w trakcie tworzenia (tzw. nieopublikowany lub dodatek dla dewelopera) na potrzeby testowania lub użytku osobistego. Dodatki możesz też debugować za pomocą debugera i punktów przerwania w IDE Apps Script.

Wymagania wstępne

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

Instalowanie nieopublikowanego dodatku

Nieopublikowane dodatki możesz zainstalować w dialogu Wdrożenia w Apps Script.

Aby zainstalować nieopublikowany dodatek Google Workspace do celów testowania:

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

Możesz pozwolić innym użytkownikom na testowanie dodatku, udostępniając projekt Apps Script na ich koncie (wymaga to dostępu do edycji). Następnie poproś użytkowników o wykonywanie czynności opisanych powyżej.

Po zainstalowaniu dodatek jest od razu dostępny w aplikacjach hosta, które rozszerza. Zanim wtyczka się wyświetli, może być konieczne odświeżenie karty aplikacji hosta. Zanim zaczniesz korzystać z dodatku, musisz go też autoryzować.

Odinstalowywanie nieopublikowanego dodatku

Aby odinstalować nieopublikowane wdrożenie dodatku:

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

W ten sposób wdrożenie zostanie natychmiast usunięte, 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 przestrzegaj sprawdzonych metod dotyczących tworzenia dodatków. Dodatkowo pamiętaj o tych kwestiach:

  1. Dokładnie przetestuj przepływy nawigacji kart we wszystkich aplikacjach hosta, do których rozszerza się dodatek. Upewnij się, że zachowanie dodatku jest prawidłowe, gdy użytkownik przechodzi z jednego kontekstu do drugiego oraz między kartami kontekstowymi i niekontekstowymi.

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

  3. Jeśli Twój dodatek łączy się z interfejsem API innej firmy lub inną usługą, sprawdź, czy można uzyskać dostęp do tej usługi i czy działa ona zgodnie z oczekiwaniami. Upewnij się, że dodatek poprawnie obsługuje dane logowania i autoryzacji.

  4. Upewnij się, że wszystkie błędy są obsługiwane prawidłowo. W razie potrzeby użyj kart z błędami.

  5. Zwróć uwagę na wydajność dodatku. Jeśli po wprowadzeniu zmian w kodzie dodatek zacznie działać wolniej, może być konieczne usunięcie tej funkcji lub jej przerobienie.