Gdy opublikujesz dodatek, użytkownicy będą mogli go zainstalować w aplikacji hosta lub w Google Workspace Marketplace. Zanim opublikujesz dodatki, przetestuj je w aplikacjach hostujących, które rozszerzają.
Na tej stronie opisujemy, jak zainstalować dodatek, który jest w trakcie opracowywania (nazywany nieopublikowanym lub deweloperskim), aby go przetestować lub używać do celów osobistych. Dodatki możesz też debugować za pomocą debugera i punktów przerwania w środowisku IDE Apps Script.
Wymagania wstępne
- Musisz mieć uprawnienia edytującego do projektu skryptu dodatku.
- Aby umożliwić innym osobom w organizacji przetestowanie dodatku, przyznaj im dostęp do projektu skryptu z uprawnieniami do edycji. Więcej informacji o przyznawaniu dostępu znajdziesz w artykule Współpraca z innymi deweloperami.
Instalowanie nieopublikowanego dodatku
Nieopublikowane dodatki możesz zainstalować w oknie Wdrożenia w Apps Script.
Aby zainstalować nieopublikowany dodatek do Google Workspace w celu przetestowania go, wykonaj te czynności:
- Otwórz projekt skryptu w edytorze Apps Script.
- Kliknij Wdrażanie > Testuj wdrożenia.
- Kliknij Zainstaluj.
- U dołu kliknij Gotowe.
Możesz umożliwić innym użytkownikom testowanie dodatku, udostępniając im projekt Apps Script (wymagane są uprawnienia do edycji). Następnie poproś użytkowników o wykonanie powyższych 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. Przed użyciem dodatku musisz go też autoryzować. Jeśli Twój projekt jest już autoryzowany, użyj funkcji ScriptApp.invalidateAuth, aby unieważnić dotychczasowe autoryzacje i przetestować w dodatku funkcję szczegółowego protokołu OAuth.
Odinstalowywanie nieopublikowanego dodatku
Aby odinstalować nieopublikowane wdrożenie dodatku, wykonaj te czynności:
- Otwórz projekt skryptu w edytorze Apps Script.
- Kliknij Wdrażanie > Testuj wdrożenia.
- Kliknij Odinstaluj.
- 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 pamiętaj, aby przestrzegać sprawdzonych metod tworzenia dodatków. Pamiętaj też o tych kwestiach:
Dokładnie przetestuj ścieżki nawigacji po kartach testowych we wszystkich aplikacjach hosta, w których działa dodatek. Sprawdź, czy dodatek działa prawidłowo, gdy użytkownik przechodzi między różnymi kontekstami oraz między kartami kontekstowymi i niekontekstowymi.
Użyj przykładowych danych testowych, aby ocenić działanie dodatku.
Jeśli dodatek łączy się z interfejsem API lub inną usługą innej firmy, sprawdź, czy usługa jest dostępna i działa zgodnie z oczekiwaniami. Upewnij się, że dodatek prawidłowo obsługuje autoryzację i dane logowania.
Upewnij się, że wszystkie warunki błędu są obsługiwane w odpowiedni sposób. W razie potrzeby używaj kart błędów.
Zwróć uwagę na wydajność dodatku. Jeśli po wprowadzeniu zmian w kodzie dodatek zacznie działać wolniej, może być konieczne usunięcie lub zmodyfikowanie tej funkcji.