Przed opublikowaniem dodatków należy je dokładnie przetestować, aby mieć pewność, że działają zgodnie z oczekiwaniami. Dzięki Apps Script możesz testować dodatki do edytora w fazie rozwoju w konkretnych plikach Dokumentów, Arkuszy lub Prezentacji Google. Możesz go używać do:
- Sprawdź, czy dodatek napisany w samodzielnym skrypcie działa zgodnie z oczekiwaniami, gdy zastosujesz go w arkuszu, dokumencie, prezentacji lub formularzu.
- Sprawdź, czy proces instalacji dodatku działa zgodnie z oczekiwaniami, w szczególności w różnych początkowych stanach cyklu autoryzacji (zainstalowany, włączony lub oba).
- Sprawdź, czy dodatek działa zgodnie z oczekiwaniami w przypadku konkretnego dokumentu i jego zawartości.
- Przetestuj i porównaj bieżącą i poprzednią wersję dodatku.
Tworzenie testowego wdrożenia
Testowe wdrożenie to połączenie rozszerzenia i dokumentu testowego. Gdy masz już opracowaną wersję skryptu i chcesz przetestować ją jako dodatek, wykonaj te czynności:
- Jeśli nie masz jeszcze żadnego, utwórz arkusz kalkulacyjny, dokument, prezentację lub formularz, aby przetestować dodatek.
- Otwórz projekt skryptu zawierającego dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- Obok opcji Wybierz typ kliknij Włącz typy wdrożenia i wybierz Dodatek Edytor.
- Kliknij Utwórz nowy test lub Dodaj test.
- Wybierz wersję kodu lub kliknij Najnowszy kod.
- W sekcji Konfiguracja wybierz początkowy stan autoryzacji dla testu.
- W sekcji Dokument testowy kliknij Nie wybrano dokumentu. Wybierz plik Arkuszy, Dokumentów, Slajdów lub Formularzy, którego chcesz użyć do przetestowania dodatku, i kliknij Wstaw.
- Kliknij Zapisz test.
Wszystkie zapisane wdrożenia testowe pojawiają się w oknie Wdrożenia testowe. Dzięki temu możesz później wrócić do tego samego testowego wdrożenia.
Przeprowadź testowe wdrożenie
Jeśli masz co najmniej 1 zapisane wdrożenia testowe, możesz uruchomić jedno z nich, wykonując te czynności:
- Otwórz projekt skryptu zawierającego dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- W sekcji Zapisane testy kliknij przycisk radiowy obok zapisanego wdrożenia testu, które chcesz uruchomić, i kliknij Wykonaj.
Dokument testowy otworzy się w nowej karcie. Dodatek jest w stanie autoryzacji określonym we wdrożeniu testowym. Aby sprawdzić, czy dodatek działa zgodnie z oczekiwaniami, możesz wchodzić w interakcje z jego menu i elementami interfejsu.
Szczegóły testowania
Podczas testowania wtyczek Edytora należy pamiętać o kilku kwestiach:
- Reguły instalowane nie są obsługiwane podczas testowania. Funkcje, które zależą od instalowanych wyzwalaczy, nie są testowalne.
- Podczas testowania wdrożenia, które jest skonfigurowane tak, aby testować przy użyciu najnowszego kodu, możesz zobaczyć zmiany zapisane w skrypcie dodatku, odświeżając dokument testowy.
- Dokument testowy ma adres URL, który możesz udostępnić edytorom oryginalnego dokumentu testowego. Dzięki temu możesz łatwiej współpracować z innymi podczas testowania i tworzenia.
- Jeśli dodatek korzysta z usługi Właściwości, właściwości są przechowywane i pozostają dostępne podczas kolejnego testowego wdrożenia.
- Ponadto każde wdrożenie testowe, które korzysta z tego samego połączenia dodatku i dokumentu testowego, ma dostęp do tych samych informacji o usłudze. Jeśli na przykład utworzysz 2 testowe wdrożenia, właściwości zapisane podczas uruchamiania pierwszego będą dostępne podczas uruchamiania drugiego i odwrotnie, ale tylko wtedy, gdy wdrożenia używają tego samego skryptu i tego samego dokumentu testowego.
- Jeśli uruchomisz testowe wdrożenie, może pojawić się prośba o autoryzację, jeśli skrypt nie był wcześniej uruchamiany. Pamiętaj, że autoryzowanie skryptu podczas testowania powoduje też autoryzację skryptu poza testowaniem.