Solucionar problemas de la CLI del módulo

La validación falla

• Ejecutar validación del módulo. --json y use el código de error y el puntero JSON para encontrar el campo de manifiesto o activo.
• Si falta el manifiesto, cámbiele el nombre a fabled.module.json. Elimine el fabled-module.json heredado cuando ambos existan.
• Actualice los bytes declarados de cada activo y sha256 después de editarlos. el paquete de módulos valida esas declaraciones y calcula el resumen final del archivo; no reescribe las declaraciones fuente.
• Verifique la sintaxis de identificación del paquete/editor, las versiones semánticas exactas, las combinaciones de destino/espacio admitidas, el consentimiento de capacidad, las etiquetas de configuración regional, las referencias de contribución y las migraciones contiguas.

La inspección del archivo falla

Recrea el artefacto con el paquete de módulos. Las herramientas ZIP de uso general pueden agregar compresión, comentarios, metadatos de plataforma, enlaces, nombres duplicados/que colisionan entre casos o descriptores de datos que el perfil seguro rechaza. Mantenga el archivo por debajo de 5 MiB, cada entrada por debajo de 1 MiB y el recuento de entradas en 128 o menos.

El inicio de sesión o las credenciales guardadas fallan

• Genera un código nuevo en Cuenta → Seguridad. Los códigos caducan después de 120 segundos y funcionan una vez.
• Pega solo el URI exacto de fabled://module-cli o el código de 43 caracteres. No lo pases como un argumento.
• Cierre la sesión de la CLI y vuelva a iniciarla si ha caducado, se ha rechazado o usa el antiguo formato de versión 1. Reintente la revocación fallida en el servidor antes de eliminar un archivo de credenciales vigente. Eliminar un archivo antiguo no revoca su sesión de Firebase.
• En POSIX, fije el directorio principal en propiedad/permisos privados y el archivo de credenciales en 0600. En Windows, use una ruta de perfil de usuario privada protegida por su ACL.
• Para el desarrollo local, establezca FABLED_API_URL en el backend de bucle local correspondiente y genere el código en la página de cuenta de Fabled local. La CLI no necesita una clave web de Firebase. Mantenga el origen de la API elegido durante la vinculación.

Error al publicar o revisar

• 401/403: inicie sesión nuevamente o confirme que el token de automatización proporcionado tenga acceso de editor/envío.
• 409: no inventes una nueva identificación de solicitud después de una respuesta incierta. Vuelva a intentar el mismo artefacto con el --request-id; un verdadero conflicto inmutable necesita una nueva versión o un espacio de nombres corregido.
• 413: reducir los activos declarados y volver a empaquetar por debajo del límite de admisión de 5 MiB.
• CHANGES_REQUESTED: lea la nota del revisor, los hallazgos automatizados y las advertencias en el estado del módulo --json, cambie el proyecto, incremente la versión de lanzamiento inmutable, valide, empaquete y envíe nuevamente.
• Un comando CLI válido aún puede no estar disponible mientras su puerta de servicio beta esté cerrada. Esto no se soluciona debilitando el manifiesto o las credenciales.

Se adquiere un módulo pero no se ejecuta

• La adquisición solo otorga derechos. Abra la biblioteca de la cuenta, elija Instalar, acepte los términos de lanzamiento exactos ofrecidos y luego elija Activar para un módulo elegible dirigido a la cuenta.
• Si la instalación no está disponible, confirme que el paquete y la versión estén activos y revisados, que el derecho esté activo y que la puerta de implementación de la instalación esté habilitada.
• Si Activar no está disponible, verifique la versión aceptada, la compatibilidad del host, las dependencias, la política de tiempo de ejecución, las firmas y la puerta de implementación de la activación.
• Para activar un módulo comunitario en una campaña, confirme que el backend correspondiente esté desplegado y que la versión exacta instalada tenga sus términos aceptados y autoridad activa ADMIN_GRANT o FREE_ACQUISITION. Solo el propietario exacto de la campaña puede activar o desactivar módulos.