Validieren eines Office-Add-In-Manifests
Möglicherweise möchten Sie die Manifestdatei des 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.
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 des Manifests mit dem Yeoman-Generator für Office-Add-Ins
Wenn Sie Ihr Add-In mit dem Yeoman-Generator für Office-Add-Ins erstellt haben, können Sie damit auch die Manifestdatei des Projekts überprüfen. Führen Sie den folgenden Befehl im Stammverzeichnis Ihres Projekts aus.
npm run validate
Hinweis
Um auf diese Funktionalität zugreifen zu können, muss Ihr Add-In-Projekt mit dem Yeoman-Generator für Office-Add-Ins Version 1.1.17 oder höher erstellt werden.
Überprüfen des Manifests mit office-addin-manifest
Wenn Sie Ihr Add-In nicht mit dem Yeoman-Generator für Office-Add-Ins erstellt haben, können Sie das Manifest unter Verwendung von office-addin-manifest überprüfen.
Installieren Sie Node.js.
Öffnen Sie eine Eingabeaufforderung, und installieren Sie das Validierungssteuerelement mit dem folgenden Befehl.
npm install -g office-addin-manifest
Führen Sie den folgenden Befehl im Stammverzeichnis Ihres Projekts aus.
npm run validate
Hinweis
Wenn dieser Befehl nicht verfügbar ist oder 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ü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 anhand des XML-Schemas
Sie können die Manifestdatei anhand der Dateien für die XML-Schemadefinition (XSD) überprüfen. Dies stellt sicher, dass die Manifestdatei dem richtigen Schema entspricht, einschließlich aller Namespaces für die Elemente, die Sie verwenden. Wenn Sie Elemente aus anderen Beispielmanifesten kopiert haben, überprüfen Sie, ob auch die entsprechenden Namespaces eingeschlossen sind. Sie können diese Überprüfung mit einem Tool zur XML-Schemaüberprüfung durchführen.
So überprüfen Sie das Manifest mit einem XML-Schemaüberprüfungstool für die Befehlszeile
Installieren Sie tar und libxml, sofern dies noch nicht geschehen ist.
Führen Sie den folgenden Befehl aus. Ersetzen Sie
XSD_FILE
durch den Pfad der XSD-Manifestdatei undXML_FILE
durch den Pfad der XML-Manifestdatei.xmllint --noout --schema XSD_FILE XML_FILE
Siehe auch
- Office-Add-Ins-Manifest
- Löschen des Office-Caches
- Debuggen des Add-Ins mit Laufzeitprotokollierung
- Querladen von Office-Add-Ins zu Testzwecken
- Debuggen von Add-Ins mithilfe von Entwicklertools für Internet Explorer
- Debuggen von Add-Ins mithilfe von Entwicklertools für die Vorgängerversion von Edge
- Debuggen von Add-Ins mithilfe von Entwicklertools in Microsoft Edge (auf der Basis von Chromium)
Office Add-ins
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Feedback senden und anzeigen für