Przed opublikowaniem dodatków należy je dokładnie przetestować, aby upewnić się, że działają zgodnie z przeznaczeniem. Apps Script umożliwia testowanie dodatków do edytora w trakcie tworzenia na konkretnych plikach Dokumentów, Arkuszy, Formularzy lub Prezentacji Google. Możesz go użyć do:
- Sprawdź, czy dodatek napisany w samodzielnym skrypcie działa zgodnie z przeznaczeniem po zastosowaniu go w arkuszu, dokumencie, prezentacji lub formularzu.
- Sprawdź, czy proces instalacji dodatku działa zgodnie z oczekiwaniami, zwłaszcza w przypadku różnych początkowych stanów cyklu autoryzacji (zainstalowany, włączony lub oba).
- Sprawdź, czy dodatek działa zgodnie z oczekiwaniami w przypadku konkretnego dokumentu i jego zawartości.
- Testowanie i porównywanie bieżącej i poprzedniej wersji dodatku.
Tworzenie wdrożenia testowego
Wdrożenie testowe to połączenie dodatku i dokumentu testowego. Gdy opracujesz 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 dodatek.
- Kliknij Wdróż > Testuj wdrożenia.
- Obok opcji Wybierz typ kliknij Włącz typy wdrożenia 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 pojawią się w oknie Wdrożenia testowe. Dzięki temu możesz później wrócić do tego samego wdrożenia testowego.
Przeprowadzanie testowego wdrożenia
Jeśli masz co najmniej 1 zapisane wdrożenie 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 kliknij przycisk obok wdrożenia zapisanego testu, który chcesz uruchomić, i kliknij Wykonaj.
Dokument testowy otworzy się w nowej karcie. Dodatek jest w stanie autoryzacji określonym w wdrożeniu testowym. Możesz sprawdzić, czy dodatek działa zgodnie z oczekiwaniami, korzystając z jego menu i elementów interfejsu.
Aby przetestować funkcję szczegółowego OAuth w dodatku, upewnij się, że projekt nie ma jeszcze autoryzacji. Aby unieważnić istniejące autoryzacje, użyj funkcji ScriptApp.invalidateAuth.
Szczegóły testu
Podczas testowania dodatków do Edytora w ten sposób pamiętaj o tych kwestiach:
- Reguły instalowane nie są obsługiwane podczas testowania. Funkcje, które zależą od instalowanych wyzwalaczy, nie są testowalne.
- Podczas przeprowadzania testowego wdrożenia, które jest skonfigurowane do testowania z najnowszym kodem, 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ć edytującym oryginalny dokument testowy. Dzięki temu możesz łatwiej współpracować z innymi osobami podczas testowania i rozwijania.
- Jeśli dodatek korzysta z usługi Properties, właściwości są zachowywane i pozostają dostępne przy następnym uruchomieniu testowego wdrożenia.
- Dodatkowo każda wdrożona wersja testowa, która 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 z nich będą dostępne podczas uruchamiania drugiego i odwrotnie, ale tylko wtedy, gdy wdrażanie będzie korzystać z tego samego skryptu i dokumentu testowego.
- Jeśli uruchomisz wdrożenie testowe, może pojawić się prośba o autoryzację, jeśli skrypt nie był wcześniej uruchamiany. Pamiętaj, że autoryzacja skryptu podczas testowania powoduje też autoryzację skryptu poza testowaniem.