Add-ons sollten vor der Veröffentlichung gründlich getestet werden, um sicherzustellen, dass sie wie vorgesehen funktionieren. Mit Apps Script können Sie Editor-Add-ons während der Entwicklung für bestimmte Dateien in Google Docs, Google Formulare oder Google Präsentationen testen. Dies kann für Folgendes verwendet werden:
- Prüfen Sie, ob ein in einem eigenständiges Skript geschriebenes Add-on wie vorgesehen funktioniert, wenn es auf ein Tabellenblatt, ein Dokument, eine Präsentation oder ein Formular angewendet wird.
- Prüfen Sie, ob der Installationsablauf des Add-ons wie vorgesehen funktioniert, insbesondere bei verschiedenen anfänglichen Status des Autorisierungslebenszyklus (installiert, aktiviert oder beides).
- Prüfen Sie, ob das Add-on wie vorgesehen funktioniert, wenn Sie auf ein bestimmtes Dokument und dessen Inhalt reagieren.
- Testen und vergleichen Sie die aktuelle mit der vorherigen Version des Add-ons.
Testbereitstellung erstellen
Eine Testbereitstellung ist die Kombination aus einem Add-on und einem Testdokument. Wenn Sie eine Skriptversion entwickelt haben und sie als Add-on testen möchten, gehen Sie so vor:
- Falls Sie noch keines haben, erstellen Sie eine Tabelle, ein Dokument, eine Präsentation oder ein Formular, um das Add-on zu testen.
- Öffnen Sie das Skriptprojekt, das das Add-on enthält.
- 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 oder Neuester Code aus.
- Wählen Sie im Bereich Konfiguration den anfänglichen Autorisierungsstatus für den Test aus.
- Klicken Sie unter Testdokument auf Kein Dokument ausgewählt. Wählen Sie die Tabellen-, Docs-, Präsentationen- oder Formulare-Datei aus, die Sie zum Testen des Add-ons verwenden 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 die gleiche Testbereitstellung später noch einmal aufrufen.
Testbereitstellung ausführen
Wenn Sie eine oder mehrere gespeicherte Testbereitstellungen haben, können Sie eine davon ausführen. Gehen Sie dazu so vor:
- Öffnen Sie das Skriptprojekt, das das Add-on enthält.
- 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 wurde. Sie können überprüfen, ob das Add-on wie vorgesehen funktioniert, indem Sie mit dem Menü und den UI-Elementen interagieren.
Testdetails
Wenn Sie Editor-Add-ons auf diese Weise testen, ist eine Reihe von Dingen zu beachten:
- Installierbare Trigger werden beim Testen nicht unterstützt. Eine von installierbaren Triggern abhängige Funktionalität ist nicht testbar.
- Wenn Sie eine Testbereitstellung ausführen, die mit dem neuesten Code getestet werden soll, können Sie die im Add-on-Skript gespeicherten Änderungen sehen, indem Sie das Testdokument aktualisieren.
- Das Testdokument hat eine URL, die Sie mit Bearbeitern des ursprünglichen Testdokuments teilen können. So können Sie beim Testen und Entwickeln einfacher mit anderen zusammenarbeiten.
- Wenn das Add-on den Attributdienst verwendet, bleiben Attribute erhalten und bleiben bei der nächsten Testbereitstellung verfügbar.
- Darüber hinaus hat jede Testbereitstellung, die dieselbe Kombination aus Add-on und Testdokument verwendet, Zugriff auf dieselben Attributinformationen. Wenn Sie beispielsweise zwei Testbereitstellungen erstellen, sind die beim Ausführen der ersten gespeicherten Attribute verfügbar, während die zweite ausgeführt wird und umgekehrt. Dies gilt jedoch nur, wenn für die Bereitstellungen dasselbe Skript und dasselbe Testdokument verwendet werden.
- Wenn Sie eine Testbereitstellung ausführen, werden Sie möglicherweise zur Autorisierung aufgefordert, sofern Sie das Skript noch nicht ausgeführt haben. Beachten Sie, dass das Autorisieren eines Skripts während des Tests auch außerhalb des Tests autorisiert wird.