Zen Browser 如何同步 Firefox 语言包到仓库download-language-packs.sh 与 copy_language_pack.py 的流程【免费下载链接】desktopWelcome to a calmer internet项目地址: https://gitcode.com/GitHub_Trending/desktop70/desktop如果你在维护 Zen Browser 的 desktop 仓库需要把浏览器的各语言文件刷新到与 Firefox 上游一致完整链路就在仓库里download-language-packs.sh 负责从 Mozilla 的firefox-l10n语言仓库拉取每个受支持语言的文件进locales/再由 copy_language_pack.py 把这些文件分发到构建时实际消费的engine/browser/locales/语言代码/。本文按“更新同步基点 → 全量同步 → 单语言补跑 → 验证结果”的顺序走一遍并把脚本对仓库和环境产生的每个副作用提前说清楚。流程涉及哪些文件文件作用download-language-packs.sh主入口克隆语言仓库、按语言刷新locales/并逐语言调用 copy_language_pack.pycopy_language_pack.py把locales/语言/的文件复制到engine/browser/locales/语言代码/supported-languages同步范围每行一个语言当前 40 个从ar到zh-TW不含en-USlanguage-maps语言 ID 到语言仓库目录名的映射当前只有一行nb:nb-NOl10n-last-commit-hash同步基点当前仓库内值为b6d45eac914fd4886c9b6e5f1447f613771228ffupdate_ff.py--just-l10n参数下只更新上面的同步基点主脚本的执行分四步若设置了ZEN_L10N_CURR_DIR先cd进去。脚本之后所有路径./locales/...、./build/...、scripts/...都是相对路径所以这个变量必须指向含locales/、build/、scripts/的目录即仓库根目录。读取build/firefox-cache/l10n-last-commit-hash作为同步点rm -rf旧的locales/firefox-l10n把 Mozilla 的firefox-l10n语言仓库克隆到locales/下再git checkout到记录的 commit。遍历supported-languages把locales/firefox-l10n/代码/的内容拷进locales/语言/。有rsync时用rsync -av --progress ../firefox-l10n/代码/ . --exclude .git没有时用cp -r。先执行python3 scripts/copy_language_pack.py en-US再循环对每个受支持语言各执行一次把文件搬到engine/browser/locales/代码/。脚本开头有set -x会回显每一条执行的命令在检测 rsync 之后有set -e任何一步出错立即停止。运行前的准备本地已检出 desktop 仓库系统上有bash、git、python3rsync可选。缺省时脚本打印rsync not found, using cp instead并改用cp有则打印rsync found!需要网络访问脚本会完整克隆firefox-l10n语言仓库。运行前值得先核对的三个输入文件cat build/firefox-cache/l10n-last-commit-hash cat locales/supported-languages cat locales/language-mapslanguage-maps处理的是“语言 ID 与语言仓库目录名不一致”的情况shell 脚本的get_code_for_language和 Python 脚本的get_language_code都会以^langId:在这份文件里查找查不到就回退为直接使用语言 ID。当前只有nb:nb-NO一条即nb从语言仓库的nb-NO目录取文件其余语言按自身名称取。运行前必须知道脚本的副作用以下全部来自脚本源码逐条列出git config --global init.defaultBranch main与git config --global fetch.prune true——会修改你的用户级全局 git 配置不只是本仓库sed -i s/\r$// ./locales/supported-languages——原地重写该文件去掉行尾\r脚本注释说明这一步失败也无妨rm -rf locales/firefox-l10n——每次同步前删除旧的克隆目录同步完成后对每个语言执行find ./locales/lang -type f -not -name zen* -delete——删除各语言目录下所有不以zen开头的文件。Firefox 译文此后只存在于engine/browser/locales/代码/locales/lang/只保留 Zen 自己的本地化文件清理阶段执行rm -rf ~/tools与rm -rf ~/.git-cinnabar中途还会把~/tools/git-cinnabar加入PATH——这是仓库外的删除操作如果~/tools里存有其他工具请先自行备份或知悉其会被删掉copy_language_pack.py对非en-US语言会先shutil.rmtree整个已存在的engine/browser/locales/代码/再全量拷入。先更新同步基点可选同步点固定在 l10n-last-commit-hash。如果想同步到firefox-l10n主分支的最新 commit 而不是仓库记录的那一个package.json 提供了只干这一件事的入口npm run sync:l10n它执行python3 scripts/update_ff.py --just-l10nupdate_ff.py 中该参数的说明是 Only update the l10n last commit hash浅克隆语言仓库到临时目录l10n-temp把main分支的最新 commit 写入 hash 文件再删除临时克隆。跳过这一步时download-language-packs.sh就按仓库里记录的 hash 同步。执行全量同步在仓库根目录bash scripts/download-language-packs.sh如果从仓库外调用脚本先用ZEN_L10N_CURR_DIR指定仓库根目录替换为你本地检出的实际绝对路径ZEN_L10N_CURR_DIR/path/to/desktop-repo bash scripts/download-language-packs.sh运行过程中每个语言刷新前会打印Updating 代码nb这一行显示的是映射后的nb-NOPython 阶段则打印Creating directory: engine/browser/locales/代码以及每个文件的Copying 源 to 目标行。结合set -x回显可以确认脚本走到了哪一步。单语言补跑copy_language_pack.py 的独立入口copy_language_pack.py 也可以单独使用脚本内的用法提示为Usage: python script.py LANG参数是语言 IDpython3 scripts/copy_language_pack.py fr需要在仓库根目录运行相对路径locales/与engine/browser/locales。它的行为分两个分支en-US先删除目标目录中所有以zen开头的文件再从./locales/en-US/browser/拷入。en-US不在 supported-languages 中不参与 firefox-l10n 下载循环它的语言文件直接来自仓库内的locales/en-US/browser/其他语言若engine/browser/locales/代码/已存在则整体删除再从./locales/langId/递归拷入保留目录结构并用shutil.copy2保留文件元数据。源目录不存在时会抛出FileNotFoundError消息形如Source path ... does not exist.入口捕获异常后打印Error: e并以退出码 1 结束。验证结果以下判断依据都来自脚本自身的输出与清理逻辑脚本最后打印Cleaning up随后删除locales/firefox-l10n。跑完后该目录应不再存在。每个语言目录只剩zen前缀文件——这正是脚本清理时使用的条件可以去掉-delete用同一条件核对find ./locales/fr -type f -not -name zen*正常同步后无输出。语言文件落在engine/browser/locales/代码/。注意代码映射nb对应目录是engine/browser/locales/nb-NO/其余语言目录名与语言 ID 相同。Python 阶段打印的逐文件Copying行可以直接对照目标位置。某个语言复制失败时找copy_language_pack.py的Error:行和退出码 1shell 脚本的set -e会让整次运行在此中断后续语言不会继续处理。限制与边界同步范围由清单固定同步哪些语言完全由 supported-languages 决定。仓库另提供 update-supported-languages.sh 用于重新生成清单在locales/目录下运行它会扫描子目录排除assets/、.github/与en-US/并重写该文件。同步点是固定 commit语言文件永远取自 hash 文件记录的 commit而不是语言仓库最新状态要换基点先跑npm run sync:l10n。映射规则被两个脚本共用shell 脚本与 Python 脚本都读 language-maps。新增一个语言 ID 与语言仓库目录名不一致的语言时需要在其中补一行langId:代码下载阶段与复制目标才会使用新代码。Zen 自己的文案另行管理同步清理后locales/lang/只保留zen*文件而这些 Zen 专属文案zen-*.ftl系列正是 crowdin.yml 中列出的、以locales/en-US/browser/browser/下文件为源文本的翻译条目。删除非 zen 文件这一步清理的是本次同步进来的 Firefox 译文不影响 Zen 自身文案的翻译工作。【免费下载链接】desktopWelcome to a calmer internet项目地址: https://gitcode.com/GitHub_Trending/desktop70/desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考