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

Animiertes GIF, das zeigt, dass das Yo Office-Validierungssteuerelement in der Befehlszeile ausgeführt wird und Ergebnisse generiert, die Überprüfung erfolgreich anzeigen.

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.

  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 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

  1. Installieren Sie tar und libxml, sofern dies noch nicht geschehen ist.

  2. Führen Sie den folgenden Befehl aus. Ersetzen Sie XSD_FILE durch den Pfad der XSD-Manifestdatei und XML_FILE durch den Pfad der XML-Manifestdatei.

    xmllint --noout --schema XSD_FILE XML_FILE
    

Siehe auch