Wenn Sie ein Add‑on veröffentlichen, können Nutzer es über die Hostanwendung oder den Google Workspace Marketplace installieren. Bevor Sie Add-ons veröffentlichen, sollten Sie sie in den Hostanwendungen testen, die sie erweitern.
Auf dieser Seite wird beschrieben, wie Sie ein Add-on installieren, das sich in der Entwicklung befindet (ein unveröffentlichtes oder Entwickler-Add-on), um es zu testen oder für den persönlichen Gebrauch zu verwenden. Sie können Add-ons auch mit dem Debugger und den Breakpoints der Apps Script-IDE debuggen.
Vorbereitung
- Sie benötigen Bearbeitungszugriff auf das Skriptprojekt des Add-ons.
- Wenn andere Personen in Ihrer Organisation das Add-on testen sollen, gewähren Sie ihnen Bearbeitungszugriff auf das Skriptprojekt. Weitere Informationen zum Gewähren des Zugriffs finden Sie unter Mit anderen Entwicklern zusammenarbeiten.
Nicht veröffentlichte Add-ons installieren
Sie können unveröffentlichte Add-ons über das Dialogfeld Bereitstellungen in Apps Script installieren.
So installieren Sie ein nicht veröffentlichtes Google Workspace-Add-on zum Testen:
- Öffnen Sie das Skriptprojekt im Apps Script-Editor.
- Klicken Sie auf Bereitstellen > Bereitstellungen testen.
- Klicken Sie auf Installieren.
- Klicken Sie unten auf Fertig.
Sie können anderen Nutzern erlauben, das Add‑on zu testen, indem Sie das Apps Script-Projekt für ihr Konto freigeben (Bearbeitungszugriff ist erforderlich). Fordern Sie die Nutzer dann auf, die oben beschriebenen Schritte auszuführen.
Nach der Installation ist das Add-on sofort in den Hostanwendungen verfügbar, die es erweitert. Möglicherweise müssen Sie den Tab der Hostanwendung aktualisieren, bevor das Add-on angezeigt wird. Außerdem müssen Sie das Add-on autorisieren, bevor Sie es verwenden können. Wenn Ihr Projekt bereits autorisiert ist, verwenden Sie ScriptApp.invalidateAuth, um die vorhandenen Autorisierungen zu widerrufen. So können Sie die Funktion granulares OAuth in Ihrem Add-on testen.
Nicht veröffentlichte Add-ons deinstallieren
So deinstallieren Sie ein nicht veröffentlichtes Add-on-Deployment:
- Öffnen Sie das Skriptprojekt im Apps Script-Editor.
- Klicken Sie auf Bereitstellen > Bereitstellungen testen.
- Klicken Sie auf Deinstallieren.
- 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 die Installationsanleitung wiederholen.
Best Practices für Tests
Achten Sie beim Testen Ihres Google Workspace-Add-ons darauf, die Best Practices für die Add-on-Entwicklung zu befolgen. Achten Sie außerdem auf Folgendes:
Testen Sie die Navigationsabläufe für Karten gründlich in allen Hostanwendungen, die durch das Add-on erweitert werden. Achten Sie darauf, dass sich das Add-on korrekt verhält, wenn der Nutzer zwischen Kontexten und zwischen nicht kontextbezogenen und kontextbezogenen Karten wechselt.
Beispielhafte Testdaten verwenden, um das Verhalten des Add-ons zu bewerten.
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 wie erwartet verhält. Prüfen Sie, ob Ihr Add-on die Autorisierungs- und Anmeldedaten korrekt verarbeitet.
Achten Sie darauf, dass alle Fehlerbedingungen ordnungsgemäß behandelt werden. Verwenden Sie bei Bedarf Fehlerkarten.
Achten Sie darauf, wie leistungsstark das Add-on ist. Wenn Sie eine Änderung am Code vornehmen und das Add-on langsamer wird, müssen Sie das Feature möglicherweise entfernen oder überarbeiten.