Flutter ARB
翻译 ARB 消息值,同时保留资源元数据和占位符定义。
应用资源包(Application Resource Bundle,简称 ARB)将 Flutter 消息及其描述、占位符定义存储在一起。flutter 文件处理器会翻译这个扁平 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 应用将带你使用这些资源完成应用检查。