ARB de Flutter

Traduce los valores de los mensajes ARB sin alterar los metadatos de los recursos ni las definiciones de los marcadores de posición.

Un Application Resource Bundle, o ARB, almacena los mensajes de Flutter junto con sus descripciones y las definiciones de sus marcadores de posición. El procesador de archivos flutter traduce las entradas de texto de este objeto JSON plano y conserva como metadatos las claves que comienzan con @.

Mensajes y metadatos #

Por ejemplo, un mensaje de entrega puede declarar el número que recibe:

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

delivery se convierte en una unidad de traducción. La entrada @delivery.description, que está en el mismo nivel, sirve de orientación para quien traduce y se mantiene como metadatos en la salida. Las definiciones de los marcadores de posición se conservan sin traducir. El procesador no considera los objetos anidados arbitrarios como catálogos de mensajes adicionales.

Cuando existe @@locale y se proporciona un idioma de destino, la reconstrucción lo actualiza. Si @@locale no existe, no se agrega automáticamente. Las demás variables globales del paquete conservan sus valores de origen.

Valores existentes y alcance #

La versión anterior del archivo de origen permite identificar por clave los cambios en los mensajes. El archivo de destino existente puede aportar valores ya aceptados. La reconstrucción usa los metadatos del archivo de origen actual, por lo que los cambios en esos metadatos pueden reflejarse en la salida incluso si se reutiliza el texto de los mensajes.

Para los mensajes modificados, usa las actualizaciones habituales del archivo de origen. Si cambias las pautas de traducción, puedes optar por actualizar todo el archivo; consulta Alcances de la CLI. Revisa los mensajes y los metadatos resultantes antes de ejecutar la generación de recursos de Flutter.

La salida usa una sangría de dos espacios en el JSON y un salto de línea al final. Es una reconstrucción estructural: no conserva el formato del archivo de origen byte por byte.

Traduce y luego genera los recursos de Flutter #

La CLI infiere flutter a partir de .arb. Un archivo de origen como app_en.arb genera archivos por idioma, como app_de.arb; asegúrate de que estas rutas coincidan con la configuración de localización del proyecto. Usa Configuración de la CLI o GitHub para seleccionar los archivos.

Después de recuperar los archivos, ejecuta el generador de localización de Flutter del proyecto y las comprobaciones de compilación. Muestra los mensajes parametrizados con valores reales y prueba las variantes de plural en cada idioma de destino. Los metadatos conservados le indican al generador qué esperar, pero el mensaje traducido también debe usar correctamente esos marcadores de posición. Localiza una aplicación de Flutter explica cómo llevar los recursos hasta esta etapa de verificación en la aplicación.