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 in der Entwicklung für bestimmte Dateien in Google Docs, Google Tabellen, Google Formulare oder Google Präsentationen testen. Dies kann verwendet werden, um:
- Prüfen Sie, ob ein Add-on, das in einem eigenständigen Skript geschrieben wurde, wie vorgesehen funktioniert, wenn es auf eine Tabelle, ein Dokument, eine Präsentation oder ein Formular angewendet wird.
- Prüfen Sie, ob der Installationsablauf des Add-ons wie beabsichtigt funktioniert, insbesondere bei unterschiedlichen anfänglichen Status des Autorisierungslebenszyklus (installiert, aktiviert oder beides).
- Prüfen Sie, ob das Add-on bei der Bearbeitung eines bestimmten Dokuments und seines Inhalts wie vorgesehen funktioniert.
- Sie können die aktuelle mit der vorherigen Version des Add-ons testen und vergleichen.
Testbereitstellung erstellen
Eine Testbereitstellung ist die Kombination aus einem Add-on und einem Testdokument. Sobald Sie eine Skriptversion entwickelt haben und diese als Add-on testen möchten, gehen Sie so vor:
- Wenn Sie das Add-on noch nicht haben, erstellen Sie eine Tabelle, ein Dokument, eine Präsentation oder ein Formular, um das Add-on zu testen.
- Öffnen Sie das Skriptprojekt, das Ihr 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 Google Tabellen-, Google Docs-, Google Präsentationen- oder Google 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 dieselbe Testbereitstellung später noch einmal aufrufen.
Testbereitstellung ausführen
Wenn Sie eine oder mehrere gespeicherte Testbereitstellungen haben, können Sie eine davon so ausführen:
- Öffnen Sie das Skriptprojekt, das Ihr 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 hat den in der Testbereitstellung angegebenen Autorisierungsstatus. Sie können prüfen, ob das Add-on wie gewünscht funktioniert, indem Sie mit dem Menü und den UI-Elementen interagieren.
Testdetails
Wenn Sie Editor-Add-ons auf diese Weise testen, gibt es eine Reihe von Dingen zu beachten:
- Installierbare Trigger werden beim Testen nicht unterstützt. Funktionen, die von installierbaren Triggern abhängen, können nicht getestet werden.
- Während Sie eine Testbereitstellung ausführen, die so eingerichtet ist, dass sie mit dem neuesten Code getestet wird, 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 leichter mit anderen zusammenarbeiten.
- Wenn das Add-on den Eigenschaftendienst verwendet, bleiben die Attribute erhalten und bleiben verfügbar, wenn die Testbereitstellung das nächste Mal ausgeführt wird.
- 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 Bereitstellung gespeicherten Attribute auch beim Ausführen der zweiten verfügbar und umgekehrt. Dies gilt jedoch nur, wenn die Bereitstellungen dasselbe Skript und Testdokument verwenden.
- Wenn Sie eine Testbereitstellung ausführen, werden Sie möglicherweise zur Autorisierung aufgefordert, falls 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.