Resolução de problemas da CLI
Resolva problemas de seleção de ficheiros, estado de referência, recolha e catálogos sem eliminar primeiro dados de estado úteis.
Tenha à mão a versão instalada, o comando, o diretório de trabalho, o erro e os caminhos afetados enquanto diagnostica uma falha. Oculte as credenciais antes de partilhar registos: os diagnósticos de arranque e de falha podem incluir argv em bruto.
Nenhum ficheiro de origem corresponde a #
Localize o .lingo/config.json mais próximo. Um comando executado num subdiretório pode usar o projeto de um diretório ascendente. Verifique include antes de pattern, pois até uma inclusão vazia se sobrepõe a este último. As exclusões aplicam-se a cada entrada; outra entrada pode, ainda assim, selecionar um ficheiro.
Utilize uma sintaxe de correspondência compatível, como docs/en/**/*, coloque os padrões de shell entre aspas e verifique a compatibilidade com os sufixos. O YAML exige a indicação explícita de yaml, yaml-root-key ou yaml-openapi; o XML do Android exige android. Um ficheiro .txt, .csv ou .properties requer um padrão que termine na respetiva extensão, ou "format": "txt", "format": "csv" ou "format": "properties"; um padrão genérico como docs/en/**/* ignora esse ficheiro, enquanto uma entrada txt, csv ou properties ignora todos os ficheiros que não tenham essa extensão. Especificar um formato não significa que todas as extensões sejam aceites.
O resultado foi guardado no local errado #
Leia os avisos de derivação de caminhos e compare o destino com o carregador da aplicação. Se não for reconhecido nenhum segmento correspondente ao idioma de origem, defina targetPath e sourceRoot em vez de depender da alternativa que insere o idioma. Mantenha os destinos fora da pesquisa de ficheiros de origem e verifique se existem colisões.
Mover os ficheiros, por si só, não atualiza o estado de referência. O XCStrings usa intencionalmente um único catálogo de origem partilhado; não segue a estrutura habitual por idioma. Consulte caminhos de saída.
Uma opção não tem efeito #
As chaves desconhecidas ao nível da raiz ou dos ficheiros geram avisos e são ignoradas. Verifique a grafia e as opções efetivamente suportadas pelo processador selecionado. As definições de caminhos do catálogo não atualizam os padrões de push, e extract e check usam, de forma independente, en como idioma de origem predefinido.
A avaliação local usa o executável lingo.config.ts, não o JSON do projeto. Uma opção de proteção de JSON não controla necessariamente o Markdown ou outro formato.
Falta um artefacto do estado de referência #
O artefacto de origem anterior identificado pelo hash do Lockfile tem de existir localmente ou no servidor. Inspecione a entrada indicada e recupere os bytes de uma versão comprovadamente válida ou um estado de referência coerente. Não invente um hash nem apague todo o Lockfile para ocultar o erro.
Quando falta o estado, um primeiro push simples guarda os bytes de origem; para os destinos normais em falta, é necessário um preenchimento retroativo. Lockfile e cache explica de que registo a operação precisa.
O pull indica um conflito #
Execute lingo pull --dry-run para inspecionar as decisões de escrita. Um destino que difira do resultado do servidor, dos bytes capturados no momento do push e do hash do Lockfile bloqueia a escrita. Fazer commit desse destino não altera a comparação.
Preserve e concilie a alteração, restaure uma versão conhecida ou escolha a opção de forçar apenas se pretender mesmo substituir o conteúdo. Não edite os destinos durante push --wait, que não volta a verificar os conflitos como o pull.
O trabalho falhou ou continua incompleto #
Inspecione os erros de cada destino e distinga entre trabalho pendente, revisão, falha e resultados em falta. Uma execução falhada faz com que push --wait e pull terminem com um código de saída diferente de zero depois de escreverem os documentos concluídos; verifique o estado e os ficheiros efetivamente criados.
Quando todos os destinos por concluir estão a aguardar revisão humana, push --wait e pull deixam de esperar e indicam esse facto. Os documentos cujos idiomas estejam todos concluídos podem ser recolhidos; volte a executar lingo pull depois de os revisores terminarem. Fazer outro push não resolve a espera por revisão.
Se a execução falhar, corrija a causa indicada e repita o comando adequado a esse trabalho. Para atualizações normais da origem, use lingo push --wait com a origem inalterada e o estado de referência preservado. Para ficheiros de destino em falta, repita o preenchimento retroativo desses ficheiros apenas depois de os destinos existentes estarem atualizados, seguindo Adicionar um idioma. Não é necessário editar a origem, usar uma opção de forçar ou eliminar o estado apenas para pedir uma nova tentativa.
O push apresenta o ID da tarefa que submete ou à qual se volta a associar. Se o push anterior nunca tiver sido recolhido e o pedido não tiver mudado, o push reutiliza esse pedido: uma tarefa ainda em execução mantém o seu ID e uma tarefa falhada é substituída por uma nova. Guarde o ID da tarefa falhada e confirme que a próxima linha Job apresentada tem um ID diferente. Isso identifica uma nova submissão, não uma tradução bem-sucedida: inspecione os resultados de cada destino, obtenha os ficheiros de saída e reveja as diferenças. Mantenha os destinos locais inalterados durante --wait; se precisar de proteger alterações locais, use push e pull em separado, com verificação de conflitos no pull.
Se o cliente instalado devolver a mesma tarefa falhada, pare de repetir as submissões e envie um e-mail para support@lingo.dev. Inclua a versão da CLI, o comando sem dados sensíveis, os IDs de execução anteriores e devolvidos, a revisão da origem, os idiomas e caminhos afetados, as datas e horas e o erro com os dados sensíveis ocultados. Não inclua na mensagem credenciais, texto de origem privado nem ficheiros de credenciais em bruto. Preserve o apontador de execução local e o Lockfile enquanto a falha é investigada.
Eliminar o apontador de execução não é uma forma fiável de pedir uma nova tradução; enquanto um push não tiver sido recolhido, o apontador mantém a identidade do pedido que impede submissões duplicadas. Se não for encontrada nenhuma execução, verifique a máquina, o caminho absoluto da raiz do projeto e se outro push substituiu o apontador.
As verificações do catálogo falham #
Execute extract com o mesmo idioma e os mesmos caminhos usados em check. Inspecione os avisos de chamadas dinâmicas ou desestruturadas antes de remover entradas órfãs. Um ficheiro de destino em falta só é assinalado quando os padrões files correspondem ao catálogo de origem; caso contrário, compare os idiomas esperados com os ficheiros existentes.
Remova apenas o que foi eliminado intencionalmente, volte a gerar as declarações e, em seguida, execute check e a compilação da aplicação. status passou para check; os nomes de serviços internos não são comandos executáveis.
Antes de eliminar seja o que for #
Purge permite pré-visualizar a eliminação de ficheiros de destino. Os filtros de ficheiros e idiomas limitam a eliminação aos destinos selecionados e às respetivas entradas no Lockfile; um purge sem filtros remove todo o Lockfile. Os catálogos XCStrings partilhados são ignorados. Use purge quando a intenção for efetivamente eliminar. A maioria das tarefas de recuperação exige uma correção específica, preservando o texto aceite e o estado recuperável.