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 w fazie rozwoju w odniesieniu do określonych plików Arkuszy, Formularzy i Prezentacji Google. Dzięki temu możesz:
- 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 zgodnie z oczekiwaniami, szczególnie 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 obecną i poprzednią wersję dodatku oraz porównaj ją.
Tworzenie wdrożenia testowego
Wdrożenie testowe polega na połączeniu 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 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 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.
Przeprowadzenie wdrożenia testowego
Jeśli masz zapisane wdrożenia testowe, możesz je uruchomić, wykonując te czynności:
- Otwórz projekt skryptu zawierający dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- W sekcji Zapisane testy wybierz opcję 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 zamierzeniami, wchodząc w interakcję z jego menu i elementami interfejsu.
Szczegóły testowania
Testując dodatki do Edytora, pamiętaj o kilku kwestiach:
- Instalacyjne aktywatory nie są obsługiwane podczas testowania. Nie można testować funkcji, które zależą od reguł do zainstalowania.
- Gdy przeprowadzasz wdrożenie testowe, które ma zostać przetestowane przy użyciu najnowszego kodu, odśwież dokument testowy, aby zobaczyć zmiany zapisane w skrypcie dodatku.
- Dokument testowy zawiera adres URL, który można udostępnić edytującym dokument testowy. W ten sposób możesz łatwiej współpracować z innymi podczas testowania i tworzenia aplikacji.
- Jeśli dodatek korzysta z usługi Właściwości, właściwości pozostają dostępne po następnym uruchomieniu wdrożenia testowego.
- Dodatkowo każde wdrożenie testowe, które wykorzystuje tę samą kombinację dodatku i dokumentu testowego, ma dostęp do tych samych informacji o właściwości. 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ą korzystać z tego samego skryptu i dokumentu testowego.
- Jeśli przeprowadzisz wdrożenie testowe, może pojawić się prośba o autoryzację, jeśli skrypt nie został wcześniej uruchomiony. Pamiętaj, że autoryzacja skryptu podczas testowania jest też autoryzowana poza testowaniem.