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 paquete de recursos de aplicación, o ARB, almacena los mensajes de Flutter junto con sus descripciones y las definiciones de sus marcadores de posición. El gestor de archivos flutter traduce las entradas de texto simple de este objeto JSON plano y conserva como metadatos las claves que empiezan por @.

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, situada al mismo nivel, ofrece una indicación para quien traduce y se conserva como metadatos en la salida. Las definiciones de los marcadores de posición se mantienen sin traducir. El gestor no interpreta cualquier objeto anidado como un catálogo de mensajes adicional.

Si existe @@locale y se proporciona un idioma de destino, se actualiza durante la reconstrucción. Si @@locale no existe, no se añade automáticamente. Las demás propiedades globales del paquete conservan sus valores de origen.

Valores existentes y alcance #

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

Para los mensajes modificados, utiliza las actualizaciones habituales del contenido de origen. Si cambias las indicaciones 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.

El JSON de salida utiliza una sangría de dos espacios y un salto de línea al final. Se reconstruye la estructura, pero no se conserva el formato de origen byte a byte.

Traduce y después genera los recursos de Flutter #

La CLI deduce 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. Utiliza Configuración de la CLI o GitHub para seleccionar los archivos.

Tras obtener 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 los casos de plural en cada idioma de destino. Los metadatos conservados indican al generador qué debe esperar, pero el mensaje traducido también debe utilizar correctamente esos marcadores de posición. Localizar una aplicación de Flutter te guía desde el trabajo con los recursos hasta esta comprobación en la aplicación.