Dépanner la CLI du module

La validation échoue

• Exécuter la validation du module. --json et utilisez le code d'erreur et le pointeur JSON pour rechercher le champ manifeste ou actif.
• Si le manifeste est manquant, renommez-le en fabled.module.json. Supprimez l'ancien fabled-module.json lorsque les deux existent.
• Mettez à jour les octets déclarés et sha256 de chaque actif après l'édition. le module pack valide ces déclarations et calcule le résumé final de l'archive ; il ne réécrit pas les déclarations source.
• Vérifiez la syntaxe de l'identifiant du package/éditeur, les versions sémantiques exactes, les combinaisons cible/emplacement prises en charge, le consentement aux fonctionnalités, les balises de paramètres régionaux, les références de contribution et les migrations contiguës.

L'inspection des archives échoue

Recréez l'artefact avec le pack de modules. Les outils ZIP à usage général peuvent ajouter de la compression, des commentaires, des métadonnées de plate-forme, des liens, des noms en double/en collision ou des descripteurs de données que le profil sécurisé rejette. Gardez l'archive à moins de 5 Mio, chaque entrée à moins de 1 Mio et le nombre d'entrées à 128 ou moins.

Échec de la connexion ou des informations d'identification enregistrées

• Générez un nouveau code dans Compte → Sécurité. Les codes expirent après 120 secondes et fonctionnent une fois.
• Collez uniquement l'URI exact fabled://module-cli ou le code à 43 caractères. Ne le transmettez pas comme un argument.
• Déconnectez puis reconnectez la CLI si la session a expiré, a été refusée ou utilise l’ancien format de version 1. Réessayez une révocation serveur échouée avant de supprimer un fichier d’identifiants encore valide. Supprimer un ancien fichier ne révoque pas sa session Firebase.
• Sous POSIX, corrigez le répertoire parent sur la propriété/autorisations privées et le fichier d'informations d'identification sur 0600. Sous Windows, utilisez un chemin de profil utilisateur privé protégé par votre ACL.
• Pour le développement local, définissez FABLED_API_URL sur le backend local correspondant et générez le code sur la page de compte Fabled locale. La CLI n’a pas besoin de clé Web Firebase. Conservez l’origine de l’API choisie lors de l’association.

La publication ou la révision échoue

• 401/403 : reconnectez-vous ou confirmez que le jeton d'automatisation fourni dispose d'un accès éditeur/soumission.
• 409 : ne pas inventer un nouvel identifiant de requête après une réponse incertaine. Réessayez le même artefact avec le --request-id imprimé ; un véritable conflit immuable nécessite une nouvelle version ou un espace de noms corrigé.
• 413 : réduisez les actifs déclarés et reconditionnez en dessous de la limite d'admission de 5 Mio.
• CHANGES_REQUESTED : lisez la note du critique, les résultats automatisés et les avertissements dans l'état du module --json, modifiez le projet, incrémentez la version immuable, validez, emballez et soumettez à nouveau.
• Une commande CLI valide peut toujours être indisponible lorsque sa porte de service bêta est désactivée. Ce problème n’est pas résolu en affaiblissant le manifeste ou les informations d’identification.

Un module est acquis mais ne fonctionne pas

• L'acquisition accorde uniquement un droit. Ouvrez la bibliothèque de comptes, choisissez Installer, acceptez les conditions de publication exactes proposées, puis choisissez Activer pour un module éligible ciblé sur un compte.
• Si l'installation n'est pas disponible, confirmez que le package et la version sont actifs et examinés, que le droit est actif et que la porte de déploiement de l'installation est activée.
• Si Activate n'est pas disponible, vérifiez la version acceptée, la compatibilité de l'hôte, les dépendances, la politique d'exécution, les signatures et la porte de déploiement d'activation.
• Pour activer un module communautaire en campagne, vérifiez que le backend correspondant est déployé et que la version exacte installée a des conditions acceptées et un droit actif ADMIN_GRANT ou FREE_ACQUISITION. Seul le propriétaire exact de la campagne peut activer ou désactiver des modules.