Flutter ARB

Traduza os valores das mensagens ARB sem alterar os metadados dos recursos nem as definições dos marcadores de posição.

Um Application Resource Bundle, ou ARB, reúne mensagens do Flutter, suas descrições e as definições dos marcadores de posição. O processador de arquivos flutter traduz as entradas de texto simples desse objeto JSON sem aninhamento e preserva como metadados as chaves que começam com @.

Mensagens e metadados #

Por exemplo, uma mensagem de entrega pode declarar o número que recebe:

json
{
  "@@locale": "en",
  "delivery": "Delivery within {days} days",
  "@delivery": {
    "description": "Checkout estimate for the latest arrival date",
    "placeholders": {
      "days": { "type": "int" }
    }
  }
}

delivery se torna uma unidade de tradução. A entrada @delivery.description, no mesmo nível, serve de orientação para o tradutor e permanece como metadado na saída. As definições dos marcadores de posição são mantidas, não traduzidas. O processador não trata objetos aninhados arbitrários como catálogos de mensagens adicionais.

Quando @@locale existe e um idioma de destino é informado, a reconstrução atualiza esse valor. Se @@locale estiver ausente, não será adicionado automaticamente. As demais propriedades globais do pacote mantêm os valores da origem.

Valores existentes e escopo #

A versão anterior da origem permite identificar alterações nas mensagens pela chave. A versão de destino existente pode fornecer valores já aceitos. A reconstrução usa os metadados da origem atual, por isso alterações nesses metadados podem aparecer na saída mesmo quando o texto da mensagem é reutilizado.

Para mensagens alteradas, use as atualizações habituais da origem. Após mudar as orientações de tradução, você pode optar por atualizar o arquivo inteiro; consulte Escopos da CLI. Confira as mensagens e os metadados resultantes antes de executar a geração de recursos do Flutter.

A saída usa indentação JSON de dois espaços e uma quebra de linha no final. É uma reconstrução estrutural: a formatação da origem não é preservada byte a byte.

Traduza e depois gere os recursos do Flutter #

A CLI infere flutter a partir de .arb. Uma origem como app_en.arb gera arquivos por idioma, como app_de.arb; ajuste esses caminhos à configuração de localização do projeto. Use Configuração da CLI ou GitHub para selecionar os arquivos.

Após obter os arquivos, execute o gerador de localização do Flutter e as verificações de compilação do projeto. Renderize as mensagens parametrizadas com valores reais e teste os casos de plural em cada idioma de destino. Os metadados preservados informam ao gerador o que esperar; a mensagem traduzida ainda precisa usar esses marcadores de posição corretamente. Localize um aplicativo Flutter acompanha o uso dos recursos até essa etapa de verificação no aplicativo.