Add-ons sollten vor der Veröffentlichung gründlich getestet werden, damit sie wie vorgesehen funktionieren. Mit Apps Script können Sie Editor-Add-ons in der Entwicklungsphase in bestimmten Google Docs-, Sheets-, Formulare- oder Präsentationsdateien testen. Sie können damit Folgendes tun:
- Prüfen Sie, ob ein Add-on, das in einem eigenständigen Script geschrieben wurde, wie vorgesehen funktioniert, wenn es auf eine Tabelle, ein Dokument, eine Präsentation oder ein Formular angewendet wird.
- Prüfen Sie, ob die Installation des Add-ons wie vorgesehen funktioniert, insbesondere für verschiedene ursprüngliche Status des Autorisierungszyklus (installiert, aktiviert oder beides).
- Prüfen Sie, ob das Add-on wie vorgesehen funktioniert, wenn es auf ein bestimmtes Dokument und seinen Inhalt angewendet wird.
- Testen und vergleichen Sie die aktuelle und die vorherige Version des Add-ons.
Testbereitstellung erstellen
Eine Testbereitstellung besteht aus einem Add-on und einem Testdokument. Wenn Sie eine Scriptversion entwickelt haben und sie als Add-on testen möchten, gehen Sie so vor:
- Erstellen Sie eine Tabelle, ein Dokument, eine Präsentation oder ein Formular, um das Add-on zu testen.
- Öffnen Sie das Script-Projekt mit Ihrem Add-on.
- Klicken Sie auf Bereitstellen > Bereitstellungen testen.
- Klicken Sie neben Typ auswählen auf „Bereitstellungstypen aktivieren“ und wählen Sie Editor-Add-on aus.
- Klicken Sie auf Neuen Test erstellen oder Test hinzufügen.
- Wählen Sie eine Codeversion aus oder Letzter Code.
- Wählen Sie im Abschnitt Config den ursprünglichen Autorisierungsstatus für den Test aus.
- Klicken Sie unter Testdokument auf Kein Dokument ausgewählt. Wählen Sie die Google Tabellen-, Docs-, Präsentationen- oder Formulare-Datei aus, mit der Sie das Add-on testen möchten, und klicken Sie auf Einfügen.
- Klicken Sie auf Test speichern.
Alle gespeicherten Testbereitstellungen werden im Dialogfeld Testbereitstellungen angezeigt. So können Sie dieselbe Testbereitstellung später noch einmal aufrufen.
Testbereitstellung ausführen
Wenn Sie eine oder mehrere gespeicherte Testimplementierungen haben, können Sie eine davon ausführen. Gehen Sie dazu so vor:
- Öffnen Sie das Script-Projekt mit Ihrem Add-on.
- Klicken Sie auf Bereitstellen > Bereitstellungen testen.
- Wählen Sie unter Gespeicherte Tests das Optionsfeld neben der gespeicherten Testbereitstellung aus, die Sie ausführen möchten, und klicken Sie auf Ausführen.
Das Testdokument wird in einem neuen Tab geöffnet. Das Add-on befindet sich im Autorisierungsstatus, der in der Testbereitstellung angegeben ist. Sie können prüfen, ob das Add-on wie vorgesehen funktioniert, indem Sie mit den Menü- und UI-Elementen interagieren.
Testdetails
Beachten Sie beim Testen von Editor-Add-ons Folgendes:
- Installierbare Trigger werden beim Testen nicht unterstützt. Funktionen, die von installierbaren Triggern abhängen, können nicht getestet werden.
- Wenn Sie eine Testbereitstellung ausführen, die für den Test mit dem neuesten Code konfiguriert ist, können Sie Änderungen, die im Add-on-Script gespeichert wurden, sehen, indem Sie das Testdokument aktualisieren.
- Das Testdokument hat eine URL, die Sie mit den Bearbeitern des ursprünglichen Testdokuments teilen können. So können Sie beim Testen und Entwickeln einfacher mit anderen zusammenarbeiten.
- Wenn Ihr Add-on den Properties-Dienst verwendet, bleiben die Properties erhalten und sind bei der nächsten Ausführung der Testbereitstellung verfügbar.
- Außerdem hat jede Testbereitstellung, die dieselbe Kombination aus Add-on und Testdokument verwendet, Zugriff auf dieselben Property-Informationen. Wenn Sie beispielsweise zwei Testimplementierungen erstellen, sind die beim Ausführen der ersten gespeicherten Eigenschaften beim Ausführen der zweiten verfügbar und umgekehrt. Das gilt jedoch nur, wenn für die Implementierungen dasselbe Script und Testdokument verwendet wird.
- Wenn Sie eine Testbereitstellung ausführen, werden Sie möglicherweise zur Autorisierung aufgefordert, wenn Sie das Script noch nicht zuvor ausgeführt haben. Wenn Sie ein Script während des Tests autorisieren, wird es auch außerhalb des Tests autorisiert.