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

Po opublikowaniu dodatku użytkownicy mogą go zainstalować w aplikacji hosta lub w Google Workspace Marketplace. Zanim opublikujesz dodatek, przetestuj go w aplikacjach hosta, które rozszerza.

Na tej stronie dowiesz się, jak zainstalować dodatek, który jest w trakcie tworzenia (dodatek nieopublikowany lub dla programistów), na potrzeby testowania lub do użytku osobistego. Możesz też debugować dodatek za pomocą debugera Apps Script i punktów przerwania.

Wymagania wstępne

  • Musisz mieć uprawnienia edytującego do projektu skryptu.
  • Aby umożliwić innym osobom testowanie dodatku, przyznaj im uprawnienia edytującego do projektu. Więcej informacji znajdziesz w artykule Współpraca z innymi programistami.
  • Użytkownicy testujący muszą należeć do tej samej domeny co właściciel skryptu.

Instalowanie nieopublikowanego dodatku

Nieopublikowane dodatki możesz zainstalować w oknie Wdrożenia.

Aby zainstalować nieopublikowany dodatek na potrzeby testowania:

  1. Otwórz projekt skryptu w edytorze skryptów Apps Script.
  2. Kliknij Wdróż > Wdrożenia testowe.
  3. Kliknij Zainstaluj.
  4. U dołu kliknij Gotowe.

Aby umożliwić innym użytkownikom testowanie dodatku, udostępnij im projekt (wymagane są uprawnienia do edycji). Następnie poproś ich o wykonanie tych samych czynności.

Po zainstalowaniu dodatek jest od razu dostępny w aplikacjach hosta, które rozszerza. Zanim dodatek się pojawi, może być konieczne odświeżenie karty aplikacji hosta. Zanim zaczniesz korzystać z dodatku, autoryzuj go. Jeśli Twój projekt jest już autoryzowany, użyj ScriptApp.invalidateAuth aby unieważnić dotychczasowe autoryzacje. Dzięki temu możesz przetestować funkcję szczegółowych uprawnień OAuth.

Odinstalowywanie nieopublikowanego dodatku

Aby odinstalować nieopublikowany dodatek:

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

Te czynności spowodują usunięcie wdrożenia i dodatek nie będzie już widoczny. Wdrożenie możesz ponownie zainstalować w dowolnym momencie.

Sprawdzone metody testowania

Podczas testowania dodatku postępuj zgodnie ze sprawdzonymi metodami. Wykonaj też te czynności:

  1. Przetestuj ścieżki nawigacji po kartach we wszystkich aplikacjach hosta, które rozszerza dodatek. Sprawdź, jak zachowuje się dodatek, gdy użytkownik przechodzi między kontekstami oraz między kartami bez kontekstu i z kontekstem.

  2. Aby ocenić działanie dodatku , użyj przykładowych danych testowych.

  3. Jeśli dodatek łączy się z interfejsem API innej firmy, sprawdź, czy usługa jest dostępna. Upewnij się, że dodatek prawidłowo obsługuje autoryzację i logowanie.

  4. Prawidłowo obsługuj stany błędów. W razie potrzeby używaj kart błędów.

  5. Monitoruj skuteczność dodatku. Jeśli po zmianie kodu dodatek działa wolniej, może być konieczne przepracowanie tej funkcji.