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, guarda as mensagens do Flutter juntamente com as respetivas descrições e definições de marcadores de posição. O processador de ficheiros flutter traduz as entradas de texto simples deste objeto JSON sem níveis de aninhamento e preserva como metadados as chaves que começam por @.

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 torna-se uma unidade de tradução. A entrada @delivery.description, ao mesmo nível, serve de orientação para quem traduz e mantém-se como metadados no resultado. As definições dos marcadores de posição são preservadas, não traduzidas. O processador não trata objetos aninhados arbitrários como catálogos de mensagens adicionais.

Quando @@locale existe e é fornecido um idioma de destino, a reconstrução atualiza o respetivo valor. Se @@locale não existir, não é adicionado automaticamente. Os restantes elementos globais do pacote mantêm os valores de origem.

Valores existentes e âmbito #

A versão anterior da origem permite identificar, por chave, as alterações nas mensagens. A versão de destino existente pode fornecer valores aceites. A reconstrução utiliza os metadados da origem atual, pelo que as alterações a esses metadados podem surgir no resultado mesmo quando o texto das mensagens é reutilizado.

Para mensagens alteradas, utilize as atualizações habituais da origem. Se alterar as orientações de tradução, opte por atualizar o ficheiro inteiro; consulte Âmbitos da CLI. Verifique as mensagens e os metadados resultantes antes de executar a geração de recursos do Flutter.

O resultado utiliza indentação JSON de dois espaços e uma quebra de linha no final. Trata-se de uma reconstrução estrutural: a formatação de origem não é preservada byte a byte.

Traduza e, em seguida, gere os recursos do Flutter #

A CLI infere flutter a partir de .arb. Uma origem como app_en.arb produz ficheiros por idioma, como app_de.arb; certifique-se de que estes caminhos correspondem à configuração de localização do projeto. Para selecionar os ficheiros, utilize a Configuração da CLI ou o GitHub.

Depois de obter os ficheiros, execute o gerador de localização do Flutter e as verificações de compilação do projeto. Apresente as mensagens parametrizadas com valores reais e teste os casos de plural em cada idioma de destino. Os metadados preservados indicam ao gerador o que esperar, mas a mensagem traduzida tem de utilizar corretamente esses marcadores de posição. O guia Localizar uma aplicação Flutter mostra como levar os recursos até esta etapa de verificação na aplicação.