Testen und Debuggen von Office-Add-Ins auf einem nicht lokalen Server

  • Artikel

Wenn Sie die Entwicklung und Tests auf einem localhost abgeschlossen haben und das Add-In von einem nicht lokalen Server oder Cloudkonto aus stagingen und testen möchten, können Sie das Tool office-addin-debugging für jedes Node.js-basierte Add-In-Projekt verwenden. (Das Tool wird in Projekten, die mit Visual Studio erstellt wurden, nicht unterstützt.)

Hinweis

Wenn Sie auf einem Windows-Computer arbeiten, haben Sie möglicherweise eine weitere Option für nicht lokale Tests. Informationen zum Testen aus einer Netzwerkfreigabe finden Sie unter Querladen von Office-Add-Ins.

Projekte, die mit dem Teams-Toolkit oder dem Office Yeoman-Generator (Yo Office) erstellt wurden

Wenn Ihr Projekt mit teams Toolkit oder Office Yeoman Generator (Yo Office) erstellt wurde, ist das Tool office-addin-debugging bereits installiert, und Ihre package.json Datei enthält start - und stop -Skripts, die das Tool aufrufen. Um ihn für nicht lokale Tests zu verwenden, aktualisieren Sie den Domänenteil der URLs in Ihrem Manifest so, dass er bei Bedarf auf Ihren Stagingserver (oder CDN) verweist. Führen Sie dann an der Befehlszeile (oder visual Studio Code TERMINAL) aus npm run start , um das Add-In zum Testen und Debuggen querzuladen.

Wichtig

Das office-addin-debugging-Tool registriert das Add-In in der Windows-Registrierung oder in einem speziellen Ordner auf einem Mac. Für ein Outlook-Add-In wird auch das Add-In in Exchange registriert. Um bei der Entwicklung subtile Fehler zu vermeiden, beenden Sie eine Testsitzung immer, indem Sie ausführen npm run stop , um sicherzustellen, dass diese Registrierungen entfernt und der Serverprozess vollständig beendet wird. Wenn Sie den Server, das Befehlszeilenfenster (oder TERMINAL), Visual Studio Code oder die Office-Anwendung manuell schließen, werden diese Registrierungen nicht entfernt.

Weitere Projekte

Wenn Ihr Projekt nicht mit Teams Toolkit oder Yo Office erstellt wurde, führen Sie das Tool mit npx im Stammverzeichnis des Projekts aus. Rufen Sie ihn mit seinem start Befehl auf, gefolgt vom relativen Pfad zum Manifest. Es folgt ein Beispiel.

npx office-addin-debugging start manifest.json

Mit diesem Befehl wird das Add-In zum Testen und Debuggen querladen. Das Tool funktioniert auch mit einem reinen Add-In-Manifest.

Es gibt viele Optionen für den start Befehl. Weitere Informationen finden Sie in der INFODATEI für das Tool unter office-addin-debugging.

Wichtig

Das office-addin-debugging-Tool registriert das Add-In in der Windows-Registrierung oder in einem speziellen Ordner auf einem Mac. Für ein Outlook-Add-In wird auch das Add-In in Exchange registriert. Um bei der Entwicklung subtile Fehler zu vermeiden, beenden Sie eine Testsitzung immer, indem Sie ausführen npx office-addin-debugging stop , um sicherzustellen, dass diese Registrierungen entfernt und der Serverprozess vollständig beendet wird. Wenn Sie den Server, das Befehlszeilenfenster (oder TERMINAL), Visual Studio Code oder die Office-Anwendung manuell schließen, werden diese Registrierungen nicht entfernt. Wenn Sie die --prod Option mit dem start Befehl verwendet haben, verwenden Sie dieselbe Option mit dem stop Befehl.