Validieren eines Office-Add-In-Manifests

  • Artikel

Sie sollten die Manifestdatei Ihres Add-Ins überprüfen, um sicherzustellen, dass sie korrekt und vollständig ist. Über die Überprüfung können auch Probleme identifiziert werden, die den Fehler "Ihr Add-In-Manifest ist ungültig" verursachen, wenn Sie versuchen, Ihr Add-In querzuladen. In diesem Artikel werden verschiedene Methoden zum Validieren der Manifestdatei beschrieben. Sofern nicht anders angegeben, funktionieren sie sowohl für das einheitliche Manifest für Microsoft 365 als auch für das XML-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.

Überprüfen Ihres Manifests mit dem Befehl validate

Wenn Sie das Teams-Toolkit oder den Yeoman-Generator für Office-Add-Ins 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 Teams 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 Teams Toolkits

Wenn Sie im Teams 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