Testowanie dodatku do Edytora

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:

  1. Jeśli jeszcze ich nie masz, utwórz arkusz kalkulacyjny, dokument, prezentację lub formularz, aby przetestować dodatek.
  2. Otwórz projekt skryptu zawierający dodatek.
  3. Kliknij Wdróż > Testuj wdrożenia.
  4. Obok opcji Wybierz typ kliknij Włącz typy wdrożeń i wybierz Dodatek do edytora.
  5. Kliknij Utwórz nowy test lub Dodaj test.
  6. Wybierz wersję kodu lub kliknij Najnowszy kod.
  7. W sekcji Konfiguracja wybierz początkowy stan autoryzacji na potrzeby testu.
  8. 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.
  9. 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:

  1. Otwórz projekt skryptu zawierający dodatek.
  2. Kliknij Wdróż > Testuj wdrożenia.
  3. 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.