Editor-Add-on testen

Add-ons sollten vor der Veröffentlichung gründlich getestet werden, wie beabsichtigt verhalten. Mit Apps Script können Sie Editor-Add-ons für bestimmte Google-Dokumente, -Formulare oder -Präsentationen in Google Docs. Dieses kann für Folgendes verwendet werden:

  • Prüfen, ob ein in einem eigenständiges Skript geschriebenes Add-on wie vorgesehen funktioniert wenn sie auf ein Tabellenblatt, ein Dokument, eine Präsentation oder ein Formular angewendet werden.
  • Überprüfen Sie, ob der Installationsablauf des Add-ons wie vorgesehen funktioniert, insbesondere bei anderer Anfangsbuchstabe Status des Autorisierungslebenszyklus (installiert, aktiviert oder beides)
  • Prüfen Sie, ob das Add-on wie vorgesehen funktioniert, wenn Sie auf einen bestimmten Dokument und seinem Inhalt.
  • Testen und vergleichen Sie die aktuelle und die vorherige 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, führen Sie folgende Schritte aus:

  1. Wenn Sie noch keines haben, erstellen Sie eine Tabelle, ein Dokument Präsentation oder Formular zum Testen des Add-ons.
  2. Öffnen Sie das Skriptprojekt, das das 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 oder Neuester Code aus.
  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 Tabellen-, Docs- und Google Präsentationen- oder Google Formulare-Datei, 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. Dadurch können 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, indem Sie Gehen Sie dazu so vor:

  1. Öffnen Sie das Skriptprojekt, das das Add-on enthält.
  2. Klicken Sie auf Bereitstellen > Bereitstellungen testen.
  3. Wählen Sie unter Gespeicherte Tests das Optionsfeld neben dem gespeicherten Test 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 die in der Testbereitstellung angegeben sind. Sie können überprüfen, ob das Add-on wie folgt funktioniert: durch Interaktion mit dem Menü und den UI-Elementen.

Testdetails

Beim Testen von Editor-Add-ons ist eine Reihe von Dingen zu beachten. auf folgende Weise:

  • Installierbare Trigger werden beim Testen nicht unterstützt. Funktionen, die von der installierbaren Trigger nicht testbar sind.
  • Wenn Sie eine Testbereitstellung ausführen, die mit dem neuesten Code getestet werden soll, können die im Add-on-Skript gespeicherten Änderungen sehen, indem Sie das Testdokument aktualisieren.
  • Das Testdokument hat eine URL, die Sie mit Bearbeitern des Originals teilen können Testdokument. So können Sie einfacher mit anderen zusammenarbeiten, während Testen und Entwickeln.
  • Wenn das Add-on das Properties-Dienst Eigenschaften bleiben und bei der nächsten Testbereitstellung verfügbar bleiben ausgeführt wird.
  • Außerdem kann jede Testbereitstellung, die die gleiche Kombination aus Add-on und Das Testdokument hat Zugriff auf dieselben Property-Informationen. Wenn Sie beispielsweise Erstellen Sie zwei Testbereitstellungen, wobei die Attribute beim Ausführen der ersten während die zweite ausgeführt wird und umgekehrt, aber nur, wenn der Bereitstellungen verwenden dasselbe Skript und dasselbe Testdokument.
  • Wenn Sie eine Testbereitstellung ausführen, werden Sie möglicherweise zur Autorisierung aufgefordert, wenn Sie das Skript noch nie ausgeführt haben. Beachten Sie, dass das Autorisieren eines Skripts wird das Skript auch außerhalb des Tests autorisiert.