Przed opublikowaniem dodatków dokładnie je przetestuj, aby mieć pewność, że działają prawidłowo. Apps Script umożliwia testowanie dodatków do edytowania w konkretnych plikach Arkuszy, Formularzy lub Prezentacji Google. Można go użyć do:
- Sprawdź, czy dodatek napisany w samodzielnym skrypcie działa zgodnie z oczekiwaniami po zastosowaniu do arkusza, dokumentu, prezentacji lub formularza.
- Sprawdź, czy proces instalacji dodatku działa prawidłowo, zwłaszcza w przypadku początkowych stanów cyklu autoryzacji (zainstalowanych, aktywnych lub obu).
- Sprawdź, czy dodatek działa prawidłowo w przypadku konkretnego dokumentu i jego zawartości.
- Przetestuj i porównaj bieżące i poprzednie wersje dodatku.
Tworzenie wdrożenia testowego
Wdrożenie testowe to połączenie dodatku i dokumentu testowego. Gdy masz już gotową wersję skryptu i chcesz ją przetestować jako dodatek, wykonaj te czynności:
- Jeśli nie masz jeszcze arkusza kalkulacyjnego, dokumentu, prezentacji lub formularza, utwórz go, aby przetestować dodatek.
- Otwórz projekt skryptu zawierający Twój 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 kliknij Najnowszy kod.
- W sekcji Konfiguracja wybierz początkowy stan autoryzacji 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 testowe wdrożenia są widoczne w oknie Wdrożenia testowe. Dzięki temu możesz potem wrócić do tego samego wdrożenia testowego.
Uruchamianie wdrożenia testowego
Jeśli masz co najmniej 1 zapisane wdrożenie testowe, możesz je uruchomić w ten sposób:
- Otwórz projekt skryptu zawierający Twój dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- W sekcji Zapisane testy zaznacz opcję znajdującą się 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. Możesz sprawdzić, czy dodatek działa prawidłowo, korzystając z jego menu i elementów interfejsu.
Szczegóły testu
Podczas testowania dodatków do edytora pamiętaj o kilku kwestiach:
- Aktywatory możliwe do zainstalowania nie są obsługiwane podczas testów. Nie można przetestować funkcji, które zależą od aktywatorów możliwych do zainstalowania.
- Podczas uruchamiania testu ustawionego do testowania z użyciem najnowszego kodu możesz zobaczyć zmiany w skrypcie dodatku, odświeżając dokument testowy.
- Dokument testowy ma adres URL, który możesz udostępnić redaktorom oryginalnego dokumentu testowego. Dzięki temu możesz łatwiej współpracować z innymi, testując i opracowując aplikacje.
- Jeśli Twój dodatek korzysta z usługi Właściwości, właściwości zostaną zachowane i będą dostępne przy następnym uruchomieniu testu.
- Dodatkowo każde wdrożenie testowe korzystające 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 wykonywania drugiego i odwrotnie, ale tylko wtedy, gdy wdrożenia będą używać tego samego skryptu i dokumentu testowego.
- Jeśli uruchamiasz wdrożenie testowe, może pojawić się prośba o autoryzację, jeśli jeszcze nie uruchamiałeś tego skryptu. Pamiętaj, że autoryzacja skryptu podczas testowania upoważnia też go do innych testów.