Apps Script-Add-ons für Google Workspace testen und Fehler beheben

Wenn Sie ein Add-on veröffentlichen, können Nutzer es über die Host-App oder den Google Workspace Marketplace installieren. Testen Sie vor der Veröffentlichung die von Ihnen entwickelten Add-ons in den Hostanwendungen, die sie erweitern.

Auf dieser Seite wird beschrieben, wie Sie ein Add-on, das sich in der Entwicklung befindet (unveröffentlichtes Add-on oder Entwickler-Add-on genannt), zu Testzwecken oder zur persönlichen Verwendung installieren. Sie können Add-ons auch mit dem Debugger und den Haltepunkten der Apps Script IDE debuggen.

Voraussetzungen

  • Sie benötigen Bearbeitungszugriff auf das Skriptprojekt des Add-ons.
  • Damit andere Nutzer in Ihrer Organisation das Add-on testen können, müssen Sie ihnen Bearbeitungszugriff auf das Skriptprojekt gewähren. Weitere Informationen zum Gewähren von Zugriff finden Sie unter Mit anderen Entwicklern zusammenarbeiten.

Nicht veröffentlichtes Add-on installieren

Sie können nicht veröffentlichte Add-ons über das Dialogfeld Bereitstellungen von Apps Script installieren.

So installieren Sie ein nicht veröffentlichtes Google Workspace-Add-on zum Testen:

  1. Öffnen Sie das Skriptprojekt im Apps Script-Editor.
  2. Klicken Sie auf Bereitstellen > Deployments testen.
  3. Klicken Sie auf Installieren.
  4. Klicken Sie unten auf Fertig.

Sie können das Add-on von anderen Nutzern testen lassen, indem Sie das Apps Script-Projekt für ihr Konto freigeben (Bearbeitungszugriff erforderlich). Fordern Sie die Nutzenden dann auf, die oben genannten Schritte auszuführen.

Nach der Installation ist das Add-on sofort in den erweiterten Hostanwendungen verfügbar. Möglicherweise müssen Sie den Tab der Hostanwendung aktualisieren, damit das Add-on angezeigt wird. Außerdem müssen Sie das Add-on autorisieren, bevor Sie es verwenden können.

Nicht veröffentlichtes Add-on deinstallieren

So deinstallieren Sie eine nicht veröffentlichte Add-on-Bereitstellung:

  1. Öffnen Sie das Skriptprojekt im Apps Script-Editor.
  2. Klicken Sie auf Bereitstellen > Deployments testen.
  3. Klicken Sie auf Deinstallieren.
  4. Klicken Sie unten auf Fertig.

Durch diese Schritte wird die Bereitstellung sofort entfernt und das Add-on wird in keiner Hostanwendung mehr angezeigt. Sie können die Bereitstellung jederzeit neu installieren, indem Sie den Installationsvorgang wiederholen.

Best Practices für Tests

Folgen Sie beim Testen des Google Workspace-Add-ons den Best Practices für die Entwicklung von Add-ons. Beachten Sie außerdem Folgendes:

  1. Testen Sie die Navigationsabläufe der Karte gründlich in allen Hostanwendungen, die das Add-on erweitert. Das Add-on-Verhalten muss korrekt sein, wenn der Nutzer vom Kontext zum Kontext und zwischen nicht kontextbezogenen und kontextbezogenen Karten wechselt.

  2. Verwenden Sie Beispieltestdaten, um das Verhalten Ihres Add-ons zu bewerten.

  3. Wenn Ihr Add-on eine Verbindung zu einer Drittanbieter-API oder einem anderen Dienst herstellt, prüfen Sie, ob auf den Dienst zugegriffen werden kann und er sich erwartungsgemäß verhält. Achten Sie darauf, dass das Add-on die Autorisierungs- und Anmeldedetails korrekt verarbeitet.

  4. Achten Sie darauf, dass alle Fehlerbedingungen ordnungsgemäß verarbeitet werden. Verwenden Sie bei Bedarf Fehlerkarten.

  5. Achten Sie auf die Leistung des Add-ons. Wenn Sie eine Änderung am Code vornehmen und das Add-on langsamer wird, müssen Sie dieses Feature möglicherweise entfernen oder überarbeiten.