Editor-Add-on testen

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, die sich in der Entwicklung befinden, in bestimmten Google Docs-, Sheets-, Forms- oder Präsentationen-Dateien testen. Dies kann für Folgendes verwendet werden:

  • 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 die Installation des Add-ons wie vorgesehen funktioniert, insbesondere für verschiedene anfängliche Autorisierungs-Lebenszyklusstatus (installiert, aktiviert oder beides).
  • Prüfen Sie, ob das Add-on wie vorgesehen funktioniert, wenn es auf ein bestimmtes Dokument und dessen Inhalt angewendet wird.
  • Aktuelle und vorherige Versionen des Add-ons testen und vergleichen

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:

  1. Wenn Sie noch keine haben, erstellen Sie eine Tabelle, ein Dokument, eine Präsentation oder ein Formular, mit dem Sie das Add-on testen können.
  2. Öffnen Sie das Script-Projekt, das Ihr Add-on enthält.
  3. Klicken Sie auf Bereitstellen > Bereitstellungen testen.
  4. Klicken Sie neben Typ auswählen auf „Bereitstellungstypen aktivieren“  und wählen Sie Editor-Add-on aus.
  5. Klicken Sie auf Neuen Test erstellen oder Test hinzufügen.
  6. Wählen Sie eine Codeversion aus oder klicken Sie auf Neuester Code.
  7. Wählen Sie im Bereich Konfiguration den anfänglichen Autorisierungsstatus für den Test aus.
  8. Klicken Sie unter Testdokument auf Kein Dokument ausgewählt. Wählen Sie die Datei in Google Sheets, Google Docs, Google Präsentationen oder Google Formulare aus, die Sie zum Testen des Add-ons verwenden möchten, und klicken Sie auf Einfügen.
  9. Klicken Sie auf Test speichern.

Alle gespeicherten Testbereitstellungen werden im Dialogfeld Testbereitstellungen angezeigt. So können Sie sich die Testbereitstellung später noch einmal ansehen.

Testbereitstellung ausführen

Wenn Sie einen oder mehrere gespeicherte Testbereitstellungen haben, können Sie eine davon ausführen, indem Sie so vorgehen:

  1. Öffnen Sie das Script-Projekt, das Ihr Add-on enthält.
  2. Klicken Sie auf Bereitstellen > Bereitstellungen testen.
  3. Wählen Sie unter Gespeicherte Tests das Optionsfeld neben der Bereitstellung des gespeicherten Tests 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 Autorisierungsstatus, der in der Testbereitstellung angegeben ist. Sie können prüfen, ob das Add-on wie vorgesehen funktioniert, indem Sie mit dem Menü und den UI-Elementen interagieren.

Wenn Sie die Funktion Granular OAuth für Ihr Add-on testen möchten, darf Ihr Projekt noch keine Autorisierungen haben. Verwenden Sie ScriptApp.invalidateAuth, um vorhandene Autorisierungen zu widerrufen.

Testdetails

Beim Testen von Editor-Add-ons auf diese Weise sind einige Dinge zu beachten:

  • 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 Tests mit dem aktuellen Code konfiguriert ist, können Sie Änderungen, die am Add-on-Script gespeichert wurden, sehen, indem Sie das Testdokument aktualisieren.
  • Das Testdokument hat eine URL, die Sie für Bearbeiter des ursprünglichen Testdokuments freigeben können. So können Sie bei Tests und der Entwicklung leichter mit anderen zusammenarbeiten.
  • Wenn Ihr Add-on den Properties-Dienst verwendet, bleiben die Eigenschaften erhalten und sind beim nächsten Ausführen 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 Testbereitstellungen erstellen, sind die während der Ausführung der ersten gespeicherten Eigenschaften während der Ausführung 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 Script noch nicht ausgeführt haben. Wenn Sie ein Skript während des Testens autorisieren, wird es auch außerhalb des Tests autorisiert.