Migre para a CLI atual
Substitua os buckets e as impressões digitais de origem legados sem perder as traduções aceitas nem comprometer o funcionamento da aplicação.
A @lingo.dev/cli atual executa operações de envio e recebimento no servidor e mantém o estado do projeto em .lingo. O pacote lingo.dev anterior usa processamento local de buckets, i18n.json e i18n.lock. Migrar significa preservar o comportamento de que o projeto precisa, não apenas mudar o nome de um comando.
Preserve um ponto de partida funcional #
Registre a versão instalada e mantenha o conteúdo de origem, as traduções de destino aceitas, a configuração e o Lockfile antigo no controle de versão. Confirme que a aplicação carrega essas traduções. Mantenha o roteador, o provedor, o seletor de idioma e o carregador de catálogos da estrutura de localização existente até que uma substituição de escopo delimitado esteja funcionando.
Registre as versões do framework e do ambiente de execução, além dos idiomas de origem, de destino e padrão necessários. Teste rotas representativas com prefixo de idioma, a detecção inicial, o fallback e a troca de idioma. Mantenha essas verificações da aplicação separadas da migração da tradução de arquivos.
Refaça a seleção de arquivos #
Crie .lingo/config.json com os idiomas de origem e de destino e entradas explícitas de arquivos. Em seguida, vincule a organização e o engine de localização para os quais você tem autorização. Não basta renomear os buckets e as impressões digitais legados para adaptá-los a esse esquema.
A configuração atual da CLI é compatível com 22 formatos, incluindo HTML (.html e .htm), texto simples (.txt, uma unidade por linha, como na v0), tabelas CSV com uma coluna para cada idioma em um único arquivo e arquivos Java .properties (uma unidade por chave, como na v0, com lockedKeys, preservedKeys e ignoredKeys seguindo as mesmas regras de correspondência da v0, e lockedPatterns na sintaxe RE2, que não aceita asserções de contexto nem referências retroativas). Antes de mover um arquivo de bucket csv da v0, confira se ele segue o layout CSV. Confira também os caminhos de um bucket properties da v0 com base em propriedades Java: um nome de arquivo [locale] como messages_[locale].properties passa a ser um padrão de origem como messages_en.properties. Buckets de CSV por idioma, MJML e outros exclusivos da versão legada exigem uma conversão validada ou outro processo de tradução. Consulte Configuração para ver os valores exatos de enumeração, os critérios de correspondência e os modelos de saída. As configurações de modelo, prompt e URL base de provedores diretos da v0 não fazem parte deste esquema de projeto.
Confira um arquivo de origem selecionado e os caminhos de destino derivados dele antes de ampliar a configuração. Para propriedades dos formatos da família Markdown, use translateComponentProps.
Adote e atualize traduções #
O planejamento atual com escopo definido ou de inicialização permite adotar traduções de destino existentes. Confira arquivos representativos e edições humanas antes de estabelecer essa base: a presença de um arquivo não comprova que seus valores correspondem ao conteúdo de origem mais recente.
O preenchimento retroativo cria arquivos comuns ausentes, enquanto a v0 normalmente preenche chaves ausentes em catálogos existentes. Para esse trabalho posterior, use as atualizações incrementais do conteúdo de origem da versão atual ou a atualização de chaves compatível. Uma chave JSON renomeada é tratada como um novo trabalho baseado em caminho, mesmo que seu texto seja igual ao de uma chave antiga; não conte com o reaproveitamento de renomeações por impressão digital de conteúdo da v0.
As edições nas traduções de destino de chaves inalteradas podem ser mantidas durante o trabalho incremental. Regras explícitas de preservação de chaves acrescentam uma decisão separada sobre quem controla essas chaves. Em formatos com arquivos separados, forçar a atualização do arquivo inteiro remove o contexto da tradução de destino atual e pode substituir textos aceitos. Por isso, não é um atalho para a adoção.
Conclua a primeira execução com a versão atual #
Siga o guia de início rápido atual até concluir o preenchimento retroativo e obter os arquivos. Um primeiro envio simples, sem uma base estabelecida, armazena os bytes do conteúdo de origem em vez de solicitar as traduções iniciais. Aguarde ou faça o recebimento antes de considerar o workflow de arquivos concluído.
Faça o commit da origem, do destino e da configuração aceitos, junto com o Lockfile atual. O ponteiro da execução mais recente fica no diretório pessoal local e não é transferido pelo Git. Um pull posterior compara os hashes; fazer o commit apenas de uma edição divergente não resolve esse conflito. lingo check substitui a antiga verificação de Lockfile congelado no nível de arquivo: o comando falha quando uma origem foi alterada desde .lingo/lock.json ou quando falta um arquivo de destino, e nunca cria um Lockfile que esteja ausente. Sem um Lockfile incluído em um commit, o comando não consegue detectar alterações na origem e verifica apenas se os arquivos de destino existem.
Migração do React #
O workflow atual do React extrai chamadas com texto literal de origem e contexto para JSONC e declarações, traduz os catálogos selecionados e, em seguida, carrega um mapa de strings em tempo de execução. Verifique o fallback, as variáveis, a troca de idioma e o texto aceito de um componente antes de ampliar a alteração.
Use Migrar mensagens existentes do React e React para o trabalho específico do pacote. O lingo guide migrate incluído no pacote reflete a versão instalada; ele não garante paridade com todas as configurações geradas anteriormente.