Zum Hauptinhalt springen
Fabled

Modulersteller

Fehlerbehebung bei der Modul-CLI

Ordnen Sie Validierungs-, Archivierungs-, Authentifizierungs-, Netzwerk- und Überprüfungsfehler einem sicheren nächsten Schritt zu.

Die Validierung schlägt fehl

  • Modulvalidierung ausführen. --json und verwenden Sie den Fehlercode und den JSON-Zeiger, um das Manifest- oder Asset-Feld zu finden.
  • Wenn das Manifest fehlt, benennen Sie es in fabled.module.json um. Entfernen Sie die alte Datei „fabled-module.json“, wenn beide vorhanden sind.
  • Aktualisieren Sie die deklarierten Bytes und sha256 jedes Assets nach der Bearbeitung. Das Modulpaket validiert diese Deklarationen und berechnet den endgültigen Archiv-Digest. Quelldeklarationen werden nicht neu geschrieben.
  • Überprüfen Sie die Paket-/Herausgeber-ID-Syntax, genaue semantische Versionen, unterstützte Ziel-/Slot-Kombinationen, Funktionseinwilligung, Gebietsschema-Tags, Beitragsreferenzen und zusammenhängende Migrationen.

Die Archivinspektion schlägt fehl

Erstellen Sie das Artefakt mit dem Modulpaket neu. Allzweck-ZIP-Tools können Komprimierung, Kommentare, Plattformmetadaten, Links, doppelte/Groß-/Kleinschreibung kollidierende Namen oder Datenbeschreibungen hinzufügen, die das sichere Profil ablehnt. Halten Sie das Archiv unter 5 MiB, jeden Eintrag unter 1 MiB und die Anzahl der Einträge bei 128 oder weniger.

Anmeldung oder gespeicherte Anmeldeinformationen schlagen fehl

  • Generieren Sie einen neuen Code unter Konto → Sicherheit. Codes verfallen nach 120 Sekunden und funktionieren einmal.
  • Fügen Sie nur den genauen fabled://module-cli-URI oder den 43-stelligen Code ein. Geben Sie es nicht als Argument weiter.
  • Melden Sie die CLI ab und wieder an, wenn die Sitzung abgelaufen ist, abgewiesen wurde oder das alte Format der Version 1 verwendet. Wiederholen Sie einen fehlgeschlagenen Serverwiderruf, bevor Sie eine gültige Anmeldedatei entfernen. Das Entfernen einer alten Datei widerruft deren Firebase-Sitzung nicht.
  • Legen Sie unter POSIX das übergeordnete Verzeichnis auf private Eigentümerschaft/Berechtigungen und die Anmeldeinformationsdatei auf 0600 fest. Verwenden Sie unter Windows einen privaten Benutzerprofilpfad, der durch Ihre ACL geschützt ist.
  • Setzen Sie für die lokale Entwicklung FABLED_API_URL auf das passende Loopback-Backend und erzeugen Sie den Code auf der lokalen Fabled-Kontoseite. Die CLI benötigt keinen Firebase-Webschlüssel. Verwenden Sie weiterhin den bei der Kopplung gewählten API-Ursprung.

Die Veröffentlichung oder Überprüfung schlägt fehl

  • 401/403: Melden Sie sich erneut an oder bestätigen Sie, dass das bereitgestellte Automatisierungstoken über Herausgeber-/Übermittlungszugriff verfügt.
  • 409: Nach einer unsicheren Antwort keine neue Anfrage-ID erfinden. Versuchen Sie dasselbe Artefakt mit der gedruckten --request-id; Ein wirklich unveränderlicher Konflikt erfordert eine neue Version oder einen korrigierten Namespace.
  • 413: Reduzieren Sie die deklarierten Vermögenswerte und verpacken Sie sie unter die 5-MiB-Zulassungsgrenze.
  • CHANGES_REQUESTED: ReviewerNote, automatisierte Ergebnisse und Warnungen im Modulstatus --json lesen, das Projekt ändern, die unveränderliche Release-Version erhöhen, validieren, packen und erneut senden.
  • Ein gültiger CLI-Befehl kann immer noch nicht verfügbar sein, während sein Beta-Service-Gate deaktiviert ist. Dies wird nicht durch Schwächung des Manifests oder der Anmeldeinformationen behoben.

Ein Modul wurde erworben, wird aber nicht ausgeführt

  • Der Erwerb gewährt nur Anspruch. Öffnen Sie die Kontobibliothek, wählen Sie „Installieren“, akzeptieren Sie die genauen angebotenen Veröffentlichungsbedingungen und wählen Sie dann „Aktivieren“ für ein geeignetes, auf das Konto ausgerichtetes Modul.
  • Wenn die Installation nicht verfügbar ist, bestätigen Sie, dass das Paket und die Version aktiv und überprüft sind, die Berechtigung aktiv ist und das Installations-Rollout-Gate aktiviert ist.
  • Wenn Activate nicht verfügbar ist, überprüfen Sie die akzeptierte Version, Hostkompatibilität, Abhängigkeiten, Laufzeitrichtlinie, Signaturen und Aktivierungs-Rollout-Gate.
  • Prüfen Sie für Community-Kampagnenmodule, ob das passende Backend bereitgestellt ist und für die genau installierte Version akzeptierte Bedingungen sowie eine aktive ADMIN_GRANT- oder FREE_ACQUISITION-Berechtigung vorliegen. Nur der genaue Kampagnenbesitzer kann Module aktivieren oder deaktivieren.