Obtainium 如何用 standardize.mjs 同步各语言翻译文件的键【免费下载链接】ObtainiumGet Android app updates straight from the source.项目地址: https://gitcode.com/GitHub_Trending/ob/ObtainiumObtainium 是一个 FlutterAndroid-first应用用easy_localization做国际化用户界面文案全部走tr()/plural()键定义在assets/translations/下的各语言 JSON 文件里见 DEVELOPER_GUIDE.md 第 1 节与技术栈表。当你在en.json里新增、重排或调整了键之后各语言文件会逐渐和英文模板脱节——缺键、键序不一致、多出不该存在的键。assets/translations/目录下的 standardize.mjs 就是为此准备的脚本它以en.json为模板强制所有其他翻译文件使用与模板相同的键、相同的顺序。本文说明这个脚本的运行机制和正确用法。脚本做了什么先弄清standardize.mjs的行为边界再运行它。根据 standardize.mjs 源码它对assets/translations/目录做如下处理模板文件固定为en.json脚本以en.json读取到的键及顺序作为基准第 12–18 行。扫描目标文件读取该目录下所有.json文件排除en.json本身、以及文件名以package开头的文件第 14–16 行因此同目录的package.json、package-lock.json不会被误处理。按模板重建每个目标文件第 20–25 行输出文件的键完全按en.json的键、以en.json中的顺序排列目标文件中已有的翻译值会保留目标文件缺少的键用en.json中对应的英文文案补上。模板中不存在的键会被丢弃第 26–33 行脚本会通过console.error输出类似...: keys missing from template will be dropped: key1, key2的提示列出每个文件中被丢弃的键及文件名。原子写回新内容先写入file.tmp再renameSync覆盖原文件第 34–36 行避免中途失败留下半个文件。两点值得注意脚本不依赖运行位置。它用import.meta.dirname取脚本自身所在目录作为翻译目录第 12 行所以在仓库任何位置执行node assets/translations/standardize.mjs结果都一样。它不碰翻译本身。已有的译文值原样保留它只保证键集合和键顺序与en.json一致。运行步骤前提本机有 Node.js脚本只用到fs、path内置模块不需要额外依赖。备份翻译文件。standardize.mjs 第 5–6 行明确警告运行前先备份翻译文件以便标准化的输出有误时能恢复之前的翻译。脚本会直接覆盖原文件且模板中不存在的键会被永久丢弃备份是脚本自己要求的前置步骤。在仓库根目录执行把该目录复制一份到仓库外cp -r assets/translations /path/to/backup/translations_backup/path/to/backup替换为你机器上任意仓库外的备份位置。确认en.json是最新的模板。标准化的结果完全由 en.json 决定如果你新加的用户界面文案还没有写进en.json运行脚本也不会给其他语言文件补上这个键。按 DEVELOPER_GUIDE.md 第 7 节的约定所有用户可见字符串的键都必须至少存在于en.json。运行脚本node assets/translations/standardize.mjs脚本对每个语言文件都是静默重写的唯一的输出是第 4 点提到的console.error提示。验证结果检查标准错误输出运行后如果没有任何console.error输出说明所有语言文件的键都包含在en.json中如果出现keys missing from template will be dropped: ...行说明对应文件里有模板外的键。这些键已经被丢弃——如果你确认它们不该存在例如旧键重命名后遗留可以直接忽略如果是误删的键用第 1 步的备份恢复该文件并先修改en.json补上或对齐键名再重新运行。抽查文件结构对照 en.json 和任意一个语言文件如 zh.json两者的键应当完全一致且顺序相同zh.json中原本没有的键位置值应当是en.json里对应的英文文案。确认没有残留临时文件assets/translations/下不应有*.json.tmp文件。跑项目检查按 DEVELOPER_GUIDE.md 第 8 节的惯例提交前执行flutter analyze # must be clean dart format --set-exit-if-changed .限制与边界脚本只处理assets/translations/下的 JSON 文件其他目录的翻译文件不在处理范围内。它的粒度是顶层键对嵌套对象如apk、apps这类带one/other的复数键键名相同即视为同一键整体沿用目标文件的值不会深入到对象内部逐层对齐。同目录的 package.json 只是声明了translate依赖与标准化工具无关脚本会跳过它。键的取舍完全由en.json说了算任何你认为各语言应该有而模板没有的键都先改en.json再运行脚本。完成以上步骤后各语言翻译文件即与en.json的键集合和顺序完全一致可以随代码一起提交。【免费下载链接】ObtainiumGet Android app updates straight from the source.项目地址: https://gitcode.com/GitHub_Trending/ob/Obtainium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Obtainium 如何用 standardize.mjs 同步各语言翻译文件的键？
Obtainium 如何用 standardize.mjs 同步各语言翻译文件的键【免费下载链接】ObtainiumGet Android app updates straight from the source.项目地址: https://gitcode.com/GitHub_Trending/ob/ObtainiumObtainium 是一个 FlutterAndroid-first应用用easy_localization做国际化用户界面文案全部走tr()/plural()键定义在assets/translations/下的各语言 JSON 文件里见 DEVELOPER_GUIDE.md 第 1 节与技术栈表。当你在en.json里新增、重排或调整了键之后各语言文件会逐渐和英文模板脱节——缺键、键序不一致、多出不该存在的键。assets/translations/目录下的 standardize.mjs 就是为此准备的脚本它以en.json为模板强制所有其他翻译文件使用与模板相同的键、相同的顺序。本文说明这个脚本的运行机制和正确用法。脚本做了什么先弄清standardize.mjs的行为边界再运行它。根据 standardize.mjs 源码它对assets/translations/目录做如下处理模板文件固定为en.json脚本以en.json读取到的键及顺序作为基准第 12–18 行。扫描目标文件读取该目录下所有.json文件排除en.json本身、以及文件名以package开头的文件第 14–16 行因此同目录的package.json、package-lock.json不会被误处理。按模板重建每个目标文件第 20–25 行输出文件的键完全按en.json的键、以en.json中的顺序排列目标文件中已有的翻译值会保留目标文件缺少的键用en.json中对应的英文文案补上。模板中不存在的键会被丢弃第 26–33 行脚本会通过console.error输出类似...: keys missing from template will be dropped: key1, key2的提示列出每个文件中被丢弃的键及文件名。原子写回新内容先写入file.tmp再renameSync覆盖原文件第 34–36 行避免中途失败留下半个文件。两点值得注意脚本不依赖运行位置。它用import.meta.dirname取脚本自身所在目录作为翻译目录第 12 行所以在仓库任何位置执行node assets/translations/standardize.mjs结果都一样。它不碰翻译本身。已有的译文值原样保留它只保证键集合和键顺序与en.json一致。运行步骤前提本机有 Node.js脚本只用到fs、path内置模块不需要额外依赖。备份翻译文件。standardize.mjs 第 5–6 行明确警告运行前先备份翻译文件以便标准化的输出有误时能恢复之前的翻译。脚本会直接覆盖原文件且模板中不存在的键会被永久丢弃备份是脚本自己要求的前置步骤。在仓库根目录执行把该目录复制一份到仓库外cp -r assets/translations /path/to/backup/translations_backup/path/to/backup替换为你机器上任意仓库外的备份位置。确认en.json是最新的模板。标准化的结果完全由 en.json 决定如果你新加的用户界面文案还没有写进en.json运行脚本也不会给其他语言文件补上这个键。按 DEVELOPER_GUIDE.md 第 7 节的约定所有用户可见字符串的键都必须至少存在于en.json。运行脚本node assets/translations/standardize.mjs脚本对每个语言文件都是静默重写的唯一的输出是第 4 点提到的console.error提示。验证结果检查标准错误输出运行后如果没有任何console.error输出说明所有语言文件的键都包含在en.json中如果出现keys missing from template will be dropped: ...行说明对应文件里有模板外的键。这些键已经被丢弃——如果你确认它们不该存在例如旧键重命名后遗留可以直接忽略如果是误删的键用第 1 步的备份恢复该文件并先修改en.json补上或对齐键名再重新运行。抽查文件结构对照 en.json 和任意一个语言文件如 zh.json两者的键应当完全一致且顺序相同zh.json中原本没有的键位置值应当是en.json里对应的英文文案。确认没有残留临时文件assets/translations/下不应有*.json.tmp文件。跑项目检查按 DEVELOPER_GUIDE.md 第 8 节的惯例提交前执行flutter analyze # must be clean dart format --set-exit-if-changed .限制与边界脚本只处理assets/translations/下的 JSON 文件其他目录的翻译文件不在处理范围内。它的粒度是顶层键对嵌套对象如apk、apps这类带one/other的复数键键名相同即视为同一键整体沿用目标文件的值不会深入到对象内部逐层对齐。同目录的 package.json 只是声明了translate依赖与标准化工具无关脚本会跳过它。键的取舍完全由en.json说了算任何你认为各语言应该有而模板没有的键都先改en.json再运行脚本。完成以上步骤后各语言翻译文件即与en.json的键集合和顺序完全一致可以随代码一起提交。【免费下载链接】ObtainiumGet Android app updates straight from the source.项目地址: https://gitcode.com/GitHub_Trending/ob/Obtainium创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考