Dodatki należy dokładnie przetestować przed ich opublikowaniem, aby mieć pewność, że działają prawidłowo. Apps Script umożliwia testowanie dodatków do edytora w trakcie opracowywania na określonych plikach Arkuszy, Formularzy i Prezentacji Google. Można go użyć, aby:
- 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 (zainstalowane, włączone lub oba).
- Sprawdź, czy dodatek działa prawidłowo w przypadku określonego dokumentu i jego zawartości.
- Przetestuj i porównaj bieżącą i poprzednią wersję dodatku.
Tworzenie wdrożenia testowego
Wdrożenie testowe stanowi 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 ich 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 na potrzeby testu.
- W sekcji Dokument testowy kliknij Nie wybrano dokumentu. Wybierz plik Arkuszy, Dokumentów, Prezentacji lub Formularzy, których chcesz użyć do przetestowania dodatku, i kliknij Wstaw.
- Kliknij Zapisz test.
Wszystkie zapisane wdrożenia testowe są wyświetlane w oknie Testowe wdrożenia. Dzięki temu możesz później wrócić do tego samego wdrożenia testowego.
Przeprowadzanie 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 przeprowadzić, i kliknij Wykonaj.
Dokument testowy otworzy się w nowej karcie. Dodatek ma stan autoryzacji określony we wdrożeniu testowym. Aby sprawdzić, czy dodatek działa zgodnie z założeniami, korzystaj z jego menu i elementów interfejsu.
Szczegóły testowania
Testując dodatki do edytora w ten sposób, należy pamiętać o kilku kwestiach:
- Aktywatory do zainstalowania nie są obsługiwane podczas testowania. Funkcja, która zależy od aktywatorów, które można zainstalować, nie jest sprawdzana.
- Po uruchomieniu wdrożenia testowego, które zostało skonfigurowane do przetestowania z użyciem najnowszego kodu, odśwież dokument testowy, aby zobaczyć zmiany zapisane w skrypcie dodatku.
- Dokument testowy ma adres URL, który możesz udostępnić edytującym oryginalnego dokumentu testowego. W ten sposób można łatwiej współpracować z innymi osobami w trakcie testowania i tworzenia oprogramowania.
- Jeśli dodatek korzysta z usługi Właściwości, właściwości pozostają dostępne i pozostają dostępne po następnym uruchomieniu wdrożenia testowego.
- Poza tym każde wdrożenie testowe korzystające z tej samej kombinacji 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 również autoryzowana poza testowaniem.