Flutter ARB

翻译 ARB 消息值,同时保留资源元数据和占位符定义。

应用资源包(Application Resource Bundle,简称 ARB)将 Flutter 消息及其描述、占位符定义存储在一起。flutter 文件处理器会翻译这个扁平 JSON 对象中的纯字符串条目,并将以 @ 开头的键保留为元数据。

消息与元数据 #

例如,一条配送消息可以声明它接收的数字参数:

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

delivery 会成为一个翻译单元。同级的 @delivery.description 是提供给译者的提示,在输出中仍作为元数据保留。占位符定义会原样保留,不参与翻译。处理器不会将任意嵌套对象视为额外的消息目录。

如果 @@locale 存在且指定了目标语言区域,重建时就会更新它。如果 @@locale 不存在,则不会自动添加。资源包中的其他全局项会保留源值。

现有值与作用范围 #

通过对照先前的源文件,按键识别消息变更。现有目标文件可提供已认可的译文。重建时使用当前源文件的元数据,因此即使沿用已有译文,源元数据的变更仍可能体现在输出中。

消息有变更时,按常规流程更新源文件;修改翻译指导后,也可以有意刷新整个文件,参见 CLI 作用范围。运行 Flutter 生成步骤前,请检查输出的消息和元数据。

输出的 JSON 使用两个空格缩进,并以换行符结尾。这是按结构重建文件,而非逐字节保留源文件格式。

先翻译,再生成 Flutter 资源 #

CLI 会根据 .arb 推断 flutter。以 app_en.arb 为例,这样的源文件会生成各语言区域对应的文件,例如 app_de.arb;请确保这些路径与项目的本地化配置一致。可通过 CLI 配置或 GitHub 选择文件。

获取文件后,运行项目的 Flutter 本地化生成器和构建检查。使用真实值渲染带参数的消息,并在每个目标语言区域中测试各种复数情形。保留的元数据会告知生成器预期的参数定义,但译文仍需正确使用这些占位符。本地化 Flutter 应用将带你使用这些资源完成应用检查。