Risolvere i problemi relativi alla CLI del modulo

La convalida non riesce

• Esegui la convalida del modulo. --json e utilizza il codice di errore e il puntatore JSON per trovare il campo manifest o asset.
• Se il manifest è mancante, rinominarlo in fabled.module.json. Rimuovi il file legacy fabled-module.json quando esistono entrambi.
• Aggiorna i byte dichiarati e lo sha256 di ogni risorsa dopo la modifica. il module pack convalida tali dichiarazioni e calcola il digest finale dell'archivio; non riscrive le dichiarazioni di origine.
• Controlla la sintassi dell'ID pacchetto/editore, le versioni semantiche esatte, le combinazioni target/slot supportate, il consenso alla funzionalità, i tag locali, i riferimenti ai contributi e le migrazioni contigue.

L'ispezione dell'archivio non riesce

Ricrea l'artefatto con il pacchetto di moduli. Gli strumenti ZIP generici possono aggiungere compressione, commenti, metadati della piattaforma, collegamenti, nomi duplicati/in conflitto di casi o descrittori di dati rifiutati dal profilo sicuro. Mantieni l'archivio sotto i 5 MiB, ogni voce sotto 1 MiB e il conteggio delle voci a 128 o meno.

L'accesso o le credenziali salvate non sono riuscite

• Genera un nuovo codice in Account → Sicurezza. I codici scadono dopo 120 secondi e funzionano una volta.
• Incolla solo l'URI esatto fabled://module-cli o il codice di 43 caratteri. Non prenderlo come argomento.
• Esci dalla CLI e accedi di nuovo se la sessione è scaduta, è stata rifiutata o usa il vecchio formato di versione 1. Riprova una revoca sul server fallita prima di rimuovere un file di credenziali ancora valido. Eliminare un vecchio file non revoca la sua sessione Firebase.
• Su POSIX, correggi la directory principale su proprietà/autorizzazioni private e il file delle credenziali su 0600. Su Windows, utilizza un percorso del profilo utente privato protetto dal tuo ACL.
• Per lo sviluppo locale, imposta FABLED_API_URL sul backend locale corrispondente e genera il codice nella pagina dell’account Fabled locale. La CLI non richiede una chiave web Firebase. Mantieni l’origine API scelta durante l’associazione.

La pubblicazione o la revisione non riescono

• 401/403: accedi di nuovo o conferma che il token di automazione fornito abbia accesso editore/invio.
• 409: non inventare un nuovo ID di richiesta dopo una risposta incerta. Riprova lo stesso artefatto con il --request-id stampato; un vero conflitto immutabile necessita di una nuova versione o di uno spazio dei nomi corretto.
• 413: ridurre gli asset dichiarati e reimballarli al di sotto del limite di ammissione di 5 MiB.
• CHANGES_REQUESTED: leggi la nota del revisore, i risultati automatizzati e gli avvisi nello stato del modulo --json, modifica il progetto, incrementa la versione di rilascio immutabile, convalida, comprime e invia di nuovo.
• Un comando CLI valido può ancora non essere disponibile mentre il gate del servizio beta è disattivato. Ciò non viene risolto indebolendo il manifest o le credenziali.

Un modulo è acquisito ma non è in esecuzione

• L'acquisizione garantisce solo il diritto. Apri la libreria dell'account, scegli Installa, accetta gli esatti termini di rilascio offerti, quindi scegli Attiva per un modulo idoneo mirato all'account.
• Se l'installazione non è disponibile, conferma che il pacchetto e la versione sono attivi e rivisti, il diritto è attivo e il cancello di implementazione dell'installazione è abilitato.
• Se Attiva non è disponibile, controlla la versione accettata, la compatibilità dell'host, le dipendenze, la politica di runtime, le firme e il cancello di implementazione dell'attivazione.
• Per attivare un modulo della community in una campagna, verifica che il backend corrispondente sia distribuito e che la versione esatta installata abbia termini accettati e autorità attiva ADMIN_GRANT o FREE_ACQUISITION. Solo il proprietario esatto della campagna può attivare o disattivare moduli.