Add-ons sollten vor der Veröffentlichung gründlich getestet werden, um sicherzustellen, dass sie sich wie beabsichtigt verhalten. Mit Apps Script können Sie Editor-Add-ons in der Entwicklung bestimmter Google Docs-, Formulare- 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 ein Tabellenblatt, ein Dokument, eine Präsentation oder ein Formular angewendet wird.
- Prüfen Sie, ob der Add-on-Installationsablauf wie vorgesehen funktioniert, insbesondere bei verschiedenen anfänglichen Autorisierungsstatus (installiert, aktiviert oder beides).
- Prüfen Sie, ob das Add-on bei der Verwendung eines bestimmten Dokuments und seines Inhalts wie beabsichtigt funktioniert.
- Aktuelle Version und vorherige Version 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 diese als Add-on testen möchten, gehen Sie so vor:
- Erstellen Sie eine Tabelle, ein Dokument, eine Präsentation oder ein Formular, mit der Sie das Add-on testen möchten.
- Ö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 die Option Aktueller Code aus.
- Wählen Sie im Abschnitt Konfiguration den anfänglichen Autorisierungsstatus für den Test aus.
- Klicken Sie unter Dokument testen auf Kein Dokument ausgewählt. Wählen Sie die Datei aus Google Tabellen, Google Docs, Google Präsentationen oder Google Formulare aus, die Sie zum Testen des Add-ons verwenden möchten, und klicken Sie dann auf Einfügen.
- Klicken Sie auf Test speichern.
Alle gespeicherten Testbereitstellungen werden im Dialogfeld Testbereitstellungen angezeigt. So können Sie später dieselbe Testbereitstellung noch einmal ausführen.
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 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 Autorisierungsstatus, der in der Testbereitstellung angegeben wurde. Sie können prüfen, ob das Add-on wie vorgesehen funktioniert, indem Sie mit den Menü- und UI-Elementen interagieren.
Testdetails
Wenn Sie Add-ons für Editoren testen möchten, sollten Sie Folgendes beachten:
- Installierbare Trigger werden beim Testen nicht unterstützt. Funktionen, die von installierbaren Triggern abhängen, sind nicht testbar.
- Während 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 enthält eine URL, die Sie für Bearbeiter des ursprünglichen Testdokuments freigeben können. Auf diese Weise können Sie beim Testen und Entwickeln einfacher mit anderen zusammenarbeiten.
- Wenn Ihr Add-on den Attributdienst verwendet, bleiben die Attribute bestehen und 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 während der Ausführung der zweiten gespeicherten Attribute während der Ausführung der zweiten und umgekehrt verfügbar, aber nur, wenn die Bereitstellungen dasselbe Skript und Testdokument verwenden.
- Wenn Sie eine Testbereitstellung ausführen, werden Sie möglicherweise zur Autorisierung aufgefordert, wenn Sie das Skript noch nicht ausgeführt haben. Beachten Sie, dass durch das Autorisieren eines Skripts während eines Tests auch das Skript außerhalb von Tests autorisiert wird.