Solucionar problemas da CLI do módulo

Falha na validação

• Execute a validação do módulo. --json e use o código de erro e o ponteiro JSON para localizar o manifesto ou campo de ativo.
• Se o manifesto estiver faltando, renomeie-o para fabled.module.json. Remova o legado fabled-module.json quando ambos existirem.
• Atualize os bytes declarados de cada ativo e sha256 após a edição. module pack valida essas declarações e calcula o resumo final do arquivo; ele não reescreve as declarações de origem.
• Verifique a sintaxe do ID do pacote/editor, versões semânticas exatas, combinações de destino/slot suportadas, consentimento de capacidade, tags de localidade, referências de contribuição e migrações contíguas.

Falha na inspeção de arquivo

Recrie o artefato com o pacote de módulos. Ferramentas ZIP de uso geral podem adicionar compactação, comentários, metadados de plataforma, links, nomes duplicados/que colidem entre casos ou descritores de dados que o perfil seguro rejeita. Mantenha o arquivo abaixo de 5 MiB, cada entrada abaixo de 1 MiB e a contagem de entradas em 128 ou menos.

Falha no login ou nas credenciais salvas

• Gere um novo código em Conta → Segurança. Os códigos expiram após 120 segundos e funcionam uma vez.
• Cole apenas o URI fabled://module-cli exato ou o código de 43 caracteres. Não passe isso como um argumento.
• Termine e reinicie a sessão da CLI se esta tiver expirado, tiver sido rejeitada ou usar o formato antigo da versão 1. Repita uma revogação falhada no servidor antes de remover um ficheiro de credenciais ainda válido. Remover um ficheiro antigo não revoga a sua sessão do Firebase.
• No POSIX, corrija o diretório pai para propriedade/permissões privadas e o arquivo de credencial para 0600. No Windows, use um caminho de perfil de usuário privado protegido por sua ACL.
• Para desenvolvimento local, defina FABLED_API_URL para o backend local correspondente e gere o código na página de conta do Fabled local. A CLI não precisa de uma chave web do Firebase. Continue a usar a origem da API escolhida no emparelhamento.

Falha na publicação ou revisão

• 401/403: faça login novamente ou confirme se o token de automação fornecido tem acesso de editor/envio.
• 409: não invente um novo ID de solicitação após uma resposta incerta. Tente novamente o mesmo artefato com o --request-id impresso; um conflito verdadeiro e imutável precisa de uma nova versão ou namespace corrigido.
• 413: reduzir os ativos declarados e reembalar abaixo do limite de admissão de 5 MiB.
• CHANGES_REQUESTED: leia reviewerNote, AutomatedFindings e avisos no status do módulo --json, altere o projeto, incremente a versão de lançamento imutável, valide, empacote e envie novamente.
• Um comando CLI válido ainda pode estar indisponível enquanto seu portão de serviço beta estiver desativado. Isso não é resolvido enfraquecendo o manifesto ou as credenciais.

Um módulo foi adquirido, mas não está em execução

• A aquisição concede apenas direitos. Abra a biblioteca de contas, escolha Instalar, aceite os termos de lançamento exatos oferecidos e escolha Ativar para um módulo qualificado direcionado à conta.
• Se a instalação não estiver disponível, confirme se o pacote e a versão estão ativos e revisados, se o direito está ativo e se a porta de implementação da instalação está habilitada.
• Se o Activate não estiver disponível, verifique a versão aceita, a compatibilidade do host, as dependências, a política de tempo de execução, as assinaturas e a porta de implementação da ativação.
• Para ativar um módulo da comunidade numa campanha, confirme que o backend correspondente está implementado e que a versão exata instalada tem os termos aceites e autoridade ativa ADMIN_GRANT ou FREE_ACQUISITION. Só o proprietário exato da campanha pode ativar ou desativar módulos.