Dodatki należy dokładnie przetestować przed opublikowaniem, aby mieć pewność, że działają prawidłowo. Apps Script umożliwia testowanie dodatków do Edytora Google Ads w trakcie opracowywania w konkretnych plikach Arkuszy, Formularzy lub Prezentacji Google. Pozwala to:
- Sprawdź, czy dodatek napisany w osobnym skrypcie działa poprawnie po zastosowaniu do arkusza, dokumentu, prezentacji lub formularza.
- Sprawdź, czy proces instalacji dodatku działa zgodnie z oczekiwaniami, zwłaszcza w przypadku różnych początkowych stanów cyklu życia autoryzacji (zainstalowany, włączony lub oba).
- Sprawdź, czy dodatek działa zgodnie z oczekiwaniami podczas działania na konkretnym dokumencie i jego zawartości.
- Przetestuj i porównaj bieżącą i poprzednią wersję dodatku.
Tworzenie wdrożenia testowego
Wdrożenie testowe to połączenie dodatku i dokumentu testowego. Gdy masz już opracowaną wersję skryptu i chcesz ją przetestować jako dodatek, wykonaj te czynności:
- Jeśli jeszcze go nie masz, utwórz arkusz kalkulacyjny, dokument, prezentację lub formularz, aby przetestować dodatek.
- Otwórz projekt skryptu zawierający dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- Obok opcji Wybierz typ kliknij Włącz typy wdrożeń i wybierz Dodatek do edytora.
- Kliknij Utwórz nowy test lub Dodaj test.
- Wybierz wersję kodu lub Najnowszy kod.
- W sekcji Konfiguracja wybierz początkowy stan autoryzacji na potrzeby testu.
- W sekcji Dokument testowy kliknij Nie wybrano dokumentu. Wybierz plik Arkuszy, Dokumentów, Prezentacji lub Formularzy, którego chcesz użyć do przetestowania dodatku, i kliknij Wstaw.
- Kliknij Zapisz test.
Wszystkie zapisane wdrożenia testowe są widoczne w oknie Wdrożenia testowe. Dzięki temu możesz później wrócić do tego samego wdrożenia testowego.
Uruchom wdrożenie testowe
Jeśli masz zapisane wdrożenia testowe, możesz uruchomić jedno z nich, wykonując te czynności:
- Otwórz projekt skryptu zawierający dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- W sekcji Zapisane testy wybierz przycisk obok zapisanego wdrożenia testowego, które chcesz uruchomić, i kliknij Wykonaj.
Dokument testowy otworzy się w nowej karcie. Dodatek ma stan autoryzacji określony we wdrożeniu testowym. Możesz sprawdzić, czy dodatek działa zgodnie z oczekiwaniami, wchodząc w interakcję z jego menu i elementami interfejsu.
Szczegóły testowania
Testując dodatki do Edytora Google w ten sposób, pamiętaj o kilku kwestiach:
- Aktywatory instalacyjne nie są obsługiwane podczas testowania. Funkcji, które zależą od aktywatorów możliwych do zainstalowania, nie można testować.
- Gdy uruchamiasz wdrożenie testowe, które jest ustawione na testowanie z użyciem najnowszego kodu, możesz odświeżyć dokument testowy, aby wyświetlić zmiany zapisane w skrypcie dodatku.
- Dokument testowy ma adres URL, który możesz udostępnić edytującym pierwotny dokument testowy. Ułatwia to współpracę z innymi osobami podczas testowania i tworzenia aplikacji.
- Jeśli Twój dodatek korzysta z usługi Właściwości, właściwości pozostają dostępne przy następnym uruchomieniu wdrożenia testowego.
- Dodatkowo każde wdrożenie testowe, które korzysta z tej samej kombinacji dodatku i dokumentu testowego, ma dostęp do tych samych informacji o usłudze. Jeśli na przykład utworzysz 2 wdrożenia testowe, właściwości zapisane podczas uruchamiania pierwszego będą dostępne podczas uruchamiania drugiego i odwrotnie, ale tylko wtedy, gdy wdrożenia będą używać tego samego skryptu i dokumentu testowego.
- Jeśli uruchomisz wdrożenie testowe, możesz zobaczyć prośbę o autoryzację, jeśli skrypt nie był wcześniej uruchamiany. Pamiętaj, że autoryzacja skryptu na etapie testowania autoryzuje go także poza testami.