Validieren eines Office-Add-In-Manifests

Überprüfen Sie Ihr Add-In-Manifest vor dem Querladen oder Veröffentlichen, um Schema- und Konfigurationsprobleme frühzeitig abzufangen. Dadurch können Fehler wie "Ihr Add-In-Manifest ist ungültig" verhindert werden.

Sofern nicht anders angegeben, gelten die Methoden in diesem Artikel sowohl für das einheitliche Manifest für Microsoft 365 als auch für das reine Add-In-Manifest.

Hinweis

Ausführliche Informationen zur Verwendung der Laufzeitprotokollierung zur Behebung von Problemen des Add-In-Manifests finden Sie unter Debuggen des Add-Ins mit Laufzeitprotokollierung.

Auswählen einer Validierungsmethode

Überprüfen Ihres Manifests mit dem Befehl validate

Wenn Sie das Agents Toolkit oder Yo Office zum Erstellen Ihres Add-Ins verwendet haben, können Sie die Manifestdatei Ihres Projekts mit dem folgenden Befehl im Stammverzeichnis Ihres Projekts überprüfen.

npm run validate

Überprüfung des Microsoft 365- und Copilot-Stores

Der validate Befehl führt auch die Überprüfung des Microsoft 365- und Copilot-Speichers durch, lässt jedoch Entwicklerinformationen wie localhost-URLs zu. Wenn Sie die Microsoft 365- und Copilot-Speicherüberprüfung auf Produktionsebene ausführen möchten, führen Sie den folgenden Befehl aus.

npm run validate -- -p

Wenn Sie Probleme mit diesem Befehl haben, versuchen Sie Folgendes (ersetzen MANIFEST_FILE Sie durch den Namen der Manifestdatei).

npx office-addin-manifest validate -p MANIFEST_FILE

Überprüfen des Manifests mit office-addin-manifest

Wenn Sie das Microsoft 365 Agents Toolkit oder den Yeoman-Generator für Office-Add-Ins nicht zum Erstellen Ihres Add-Ins verwendet haben, können Sie das Manifest mithilfe von office-addin-manifest überprüfen.

  1. Installieren Sie Node.js.

  2. Öffnen Sie eine Eingabeaufforderung, und installieren Sie das Validierungssteuerelement mit dem folgenden Befehl.

    npm install -g office-addin-manifest

  3. Führen Sie den folgenden Befehl im Ordner Ihres Projekts aus, der die Manifestdatei enthält (ersetzen Sie MANIFEST_FILE durch den Namen der Manifestdatei).

    office-addin-manifest validate MANIFEST_FILE

    Hinweis

    Wenn dieser Befehl nicht funktioniert, führen Sie stattdessen den folgenden Befehl aus, um die Verwendung der neuesten Version des office-addin-manifest-Tools zu erzwingen (ersetzen Sie MANIFEST_FILE durch den Namen der Manifestdatei).

    npx office-addin-manifest validate MANIFEST_FILE

Überprüfen des Manifests auf der Benutzeroberfläche des Agents Toolkits

Wenn Sie im Agents Toolkit arbeiten und das einheitliche Manifest verwenden, können Sie die Validierungsoptionen des Toolkits verwenden. Anweisungen finden Sie unter Überprüfen der Anwendung.

Siehe auch

  • Last updated on