构建工具【免费下载链接】mesonThe Meson Build System项目地址https://gitcode.com/gh_mirrors/me/meson点击查看免费下载导读i18n是 Meson 构建系统中负责国际化internationalisation与本地化localisation的内置扩展模块围绕 GNU gettext 工具链xgettext、msgfmt、msginit、msgmerge、itstool提供了一整套声明式构建集成。本文以 docs/markdown/i18n-module.md 为骨架结合 mesonbuild/modules/i18n.py 与test cases/frameworks/下的真实测试工程完整讲解i18n.gettext()、i18n.merge_file()、i18n.itstool_join()与i18n.xgettext()四个核心函数的参数语义、底层实现与实战用法。读完本文你将能够为自己的项目一键搭建可安装的.mo翻译产物、合并桌面文件/XML 文档的翻译并为维护者生成 pot/po 更新目标。模块总览与引入方式i18n模块的入口定义在 mesonbuild/modules/i18n.py 的I18nModule类中它向解释器暴露了四个方法merge_file、gettext、itstool_join和xgettext。在meson.build中引入该模块只需一行i18n import(i18n)之后四个函数就以i18n.xxx()的方式调用。变量名可以随意替换例如intl import(i18n)。注意模块本身不负责探测工具链——xgettext、msgfmt等外部程序是在各函数首次被调用时才通过find_program()惰性查找的见 mesonbuild/modules/i18n.py 的self.tools字典以及gettext()方法内部的探测逻辑。i18n.gettext()一键搭建 gettext 翻译构建i18n.gettext()是模块的核心它接受一个位置参数——gettext 模块名通常即项目包名然后自动完成 pot 生成、mo 编译、安装路径规划等全部工作并额外为维护者生成三个目标。关键字参数详解参数引入版本类型说明args早期list[str]生成 pot 文件时额外传给xgettext的参数msgfmt_args1.12.0list[str]构建翻译时额外传给msgfmt的参数data_dirs0.36.0list[str]设置GETTEXTDATADIRS环境变量的目录列表需要 gettext 0.19.8用于查找本地 ITS 文件languages0.37.0 起可选list[str]要生成的语言列表缺省时读取LINGUAS文件preset0.37.0str预置参数列表名称当前仅支持glibinstall0.43.0bool为false时不安装构建出的翻译默认trueinstall_dir0.50.0str覆盖默认安装位置默认使用localedir选项在源码层gettext()的参数校验通过TypedArgs装饰器完成mesonbuild/modules/i18n.py其中_ARGS、_MSGFMT_ARGS、_DATA_DIRS三个 KwargInfo 分别对应args、msgfmt_args、data_dirs均支持 listify把单个字符串自动转成单元素列表。presetglib 预置参数preset: glib会向xgettext注入一整套针对 GLib/GTK 生态的抽取参数定义在 mesonbuild/modules/i18n.py 的PRESET_ARGS字典中核心内容如下--from-codeUTF-8 --add-comments --keyword_ --keywordN_ --keywordC_:1c,2 --keywordNC_:1c,2 --keywordg_dcgettext:2 --keywordg_dngettext:2,3 --keywordg_dpgettext2:2c,3 --flagN_:1:pass-c-format --flagC_:2:pass-c-format --flagNC_:2:pass-c-format --flagg_dngettext:2:pass-c-format --flagg_strdup_printf:1:c-format --flagg_string_printf:2:c-format --flagg_string_append_printf:2:c-format --flagg_error_new:3:c-format --flagg_set_error:4:c-format --flagg_markup_printf_escaped:1:c-format --flagg_log:3:c-format --flagg_print:1:c-format --flagg_printerr:1:c-format --flagg_printf:1:c-format --flagg_fprintf:2:c-format --flagg_sprintf:2:c-format --flagg_snprintf:3:c-format这些参数不仅声明了 GLib 常用的翻译关键字_、N_、C_、NC_、g_dcgettext等还通过--flag精确标注了哪些参数是 C 格式字符串使xgettext能正确识别格式串校验。当同时传入自定义args时预置参数在前、自定义参数在后合并mesonbuild/modules/i18n.py因此自定义参数可以覆盖预置默认值。返回的维护者目标gettext()会为包名为project_id的翻译工程生成三个维护者目标注意这些目标输出到源码目录project_id-pot调用xgettext重新生成.pot文件project_id-update-po基于当前.pot重新生成/合并各语言的.po文件project_id-gmo仅构建翻译、不安装。这些目标的底层命令由 mesonbuild/scripts/gettext.py 实现pot子命令会读取POTFILES.in或POTFILES文件列出待抽取的源文件设置GETTEXTDATADIRS环境变量后调用xgettextmesonbuild/scripts/gettext.pyupdate_po子命令则对已有.po文件执行msgmerge -q对不存在的语言用msginit从 pot 初始化新 po 文件mesonbuild/scripts/gettext.py。返回值与安装路径自 0.60.0 起gettext()返回一个列表包含三部分构建出的.mo文件目标列表维护者-pot目标维护者-update-po目标。安装路径方面默认取构建选项localedir的值mesonbuild/modules/i18n.py每个语言的 mo 文件被安装到install_dir/lang/LC_MESSAGES/下并以packagename.mo命名。源码实现为每个语言创建独立的CustomTarget通过手动设置目标子目录来模拟重命名见 mesonbuild/modules/i18n.py 的注释说明并统一打上install_tag: i18n以便按标签过滤安装。实战示例i18n import(i18n) # 显式声明语言并给 msgfmt 传额外参数 gettext_targets i18n.gettext( intltest, languages: [fi, de, ru], msgfmt_args: [--use-fuzzy], ) mo_targets gettext_targets[0]上面的写法直接取自 test cases/frameworks/6 gettext/po/meson.build配合同目录下的LINGUAS、POTFILES与de.po、fi.po、ru.po文件即可完整运行。若省略languages模块会读取LINGUAS文件——其解析逻辑逐行去注释、按空白拆分见 mesonbuild/scripts/gettext.py。i18n.merge_file()把翻译合并进文本文件i18n.merge_file()0.37.0 加入使用msgfmt把翻译合并进文本文件例如.desktop文件或 XML 文档。除custom_target的常规关键字input、build_by_default、install等外它额外支持参数引入版本说明output0.37.0同custom_target但只接受一个条目install_dir0.37.0同custom_target但只接受一个条目install_tag0.37.0同custom_target但只接受一个条目data_dirs0.41.0ITS 文件查找目录列表语义同gettext()po_dir0.37.0相对当前目录的翻译文件目录type0.37.0文件类型合法值为xml默认和desktopargs0.51.0额外传给msgfmt的参数底层会先校验msgfmt版本desktop类型要求 GNU msgfmt 0.19xml类型要求 0.19.7mesonbuild/modules/i18n.py。随后构造一条meson --internal msgfmthelper ...命令通过 mesonbuild/scripts/msgfmthelper.py 完成实际合并data_dirs会被拼成--datadirs...冒号分隔列表传入。实战示例i18n.merge_file( input: test.desktop.in, output: BASENAME, type: desktop, po_dir: ../po, data_dirs: ../po, install: true, install_dir: join_paths(get_option(datadir), applications) )该示例来自 test cases/frameworks/6 gettext/data/meson.build展示了桌面文件翻译合并的典型写法output: BASENAME表示输出名与输入 basename 一致po_dir: ../po指向po子目录下的翻译文件合并结果安装到datadir/applications。测试工程还覆盖了多个merge_file()调用共享File对象与BASENAME输出的场景目标名冲突回归测试。注意install: true时install_dir为必填否则直接抛InvalidArgumentsmesonbuild/modules/i18n.py。i18n.itstool_join()用 itstool 合并 XML 翻译i18n.itstool_join()0.62.0 加入使用itstool把翻译合并进 XML 文件如 AppStream metainfo、GNOME 帮助文档。在custom_target常规关键字之外它接受参数说明output/install_dir/install_tag同custom_target各只接受一个条目its_files显式使用的 ITS 文件列表否则自动探测 XML 翻译规则mo_targets必填i18n.gettext()返回的 mo 生成目标实现上itstool_join()会把传入的mo_targets展开为各.mo文件的构建目录路径作为命令行参数追加到itstool join之后mesonbuild/modules/i18n.py并通过extra_dependsmo_targets声明对 mo 目标的依赖确保先编译翻译再合并。ITS 文件若为相对路径会基于源码目录解析为绝对路径再传给--its。实战示例if itstool.found() mi_translated i18n.itstool_join( input: com.mesonbuild.test.intlprog.metainfo.xml, output: com.mesonbuild.test.intlprog.metainfo.xml, mo_targets: mo_targets, its_files: [metainfo.its], install: true, install_dir: get_option(datadir) / metainfo, ) endif该示例来自 test cases/frameworks/6 gettext/data3/meson.build其中mo_targets正是前文gettext()返回列表的第一项。测试还演示了itstool -v版本探测仅当 itstool 2.0.6 时才校验合并结果以规避旧版 itstool 命令行 ITS 规则失效的已知 bug——这提示我们在实际项目中也要留意本机 itstool 的版本行为。i18n.xgettext()独立、可复用的 pot 抽取i18n.xgettext()1.8.0 加入直接调用xgettext程序从给定源文件生成.pot文件适用于gettext()工作流不适用的场景例如为每个可执行文件生成独立的.pot。其签名如下i18n.xgettext(name, sources..., args: [...], recursive: false)位置参数namestr必填生成的 pot 文件名若不以.pot结尾会自动补全sourcesarray[str|File|build_tgt|custom_tgt|custom_idx]至少 1 个源文件或构建目标可以是字符串、File、build_tgt、custom_tgt也可以是本函数先前返回的自定义目标。1.10.0 起才支持custom_tgt/custom_idx作为输入此前会被静默忽略。关键字参数参数类型说明recursivebool为true时把源目标依赖链上其他xgettext()生成的 pot 合并进最终 potinstallbool为true时把结果 pot 加入安装目标此时install_dir必填install_tagstr安装目标使用的 install taginstall_dirstr结果 pot 的安装目录argslist[str]额外传给xgettext的参数该函数返回一个custom_tgt。底层实现要点XgettextProgram.extract()mesonbuild/modules/i18n.py负责构造命令源文件会经过_get_source_files()归一化字符串转File、构建目标展开其源文件、BothLibraries取共享库部分、自定义目标取其输出文件mesonbuild/modules/i18n.py自动追加--directory源目录、--directory构建目录与--outputOUTPUT使xgettext同时能解析源码与构建目录下的文件当源文件列表导致命令行过长时会把源文件清单写入.rsp文件改用--files-fromINPUT传参mesonbuild/modules/i18n.py阈值由mesonlib.get_rsp_threshold()决定。recursive: true 的传递语义recursive: true应加在会实际读取结果.mo文件的目标上。每次调用i18n.xgettext()都会把源目标 → 生成的 pot 文件记录在XgettextProgram.pot_files字典中当recursive: true时_get_depends()会遍历源目标的依赖mesonbuild/modules/i18n.py把所有已记录的依赖 pot 文件作为输入合并进最终 pot。因此给源目标添加依赖会自动把该依赖的翻译纳入所需翻译集——递归是跨静态库、共享库链传递的。实战示例test cases/frameworks/38 gettext extractor 完整演示了这一机制# src/lib1/meson.build lib1 static_library(mylib1, lib1.c) lib1_pot i18n.xgettext(lib1, lib1, args: xgettext_args) # src/meson.buildmain 链接 lib2lib2 链接 lib1main 不直接链接 lib1 main executable(say, main.c, link_with: [lib2], include_directories: lib2_includes) main_pot i18n.xgettext(main, main, args: xgettext_args, install: true, install_dir: intl, install_tag: intl, recursive: true)测试通过verify.py断言main.pot同时包含 lib2 与经由 lib2 传递的lib1 的字符串证明recursive: true会沿依赖链传递抽取对应的共享库变体则验证了即使共享库不像静态库那样把依赖对象拉入自身递归抽取仍能穿透到shlib1。通常的最佳实践是把主构建目标与其头文件列表作为 sources 传入recursive: true用于真正消费.mo文件的目标。完整工程落地清单把i18n模块接入真实项目需要准备以下文件po/POTFILES或POTFILES.in列出所有包含可翻译字符串的源文件供gettext()的 pot 生成读取po/LINGUAS可选逐行列出语言代码#开头为注释供languages缺省时读取po/lang.po各语言翻译文件可用维护者目标project_id-update-po从 pot 初始化/合并meson.build中调用i18n.gettext()并在需要时用merge_file()/itstool_join()处理桌面文件与 XML 文档用xgettext()定制化抽取 pot。依赖的外部工具为 GNU gettext 工具链xgettext、msgfmt、msginit、msgmerge均通过find_program探测以及可选的itstoolmsgfmt属于严格依赖缺失时所有翻译目标会被忽略并给出告警见 mesonbuild/modules/i18n.py。构建产物默认安装到localedir下的lang/LC_MESSAGES/也可用install_dir整体重定向若只想构建不安装设install: false即可。小结i18n模块把 GNU gettext 的完整工作流——从 pot 抽取、po 更新、mo 编译到安装路径规划——压缩为寥寥几行声明式meson.build代码同时保留了对xgettext/msgfmt参数的完全透传能力。对于桌面应用.desktop合并、GNOME/AppStream 生态GLib preset 与 itstool join以及需要细粒度多 pot 管理的复杂工程xgettext()它分别提供了对症的解决方案是 Meson 项目中处理国际化的标准入口。赞分享构建工具【免费下载链接】mesonThe Meson Build System项目地址https://gitcode.com/gh_mirrors/me/meson点击查看免费下载相关推荐CPython gettext 模块完全指南GNU 消息目录 API 与 Python 国际化/本地化实战CPython gettext 模块完全指南GNU 消息目录 API 与 Python 国际化/本地化实战 gettext 是 CPython 标准库中提供国编程语言语言运行时解释器标准库终极微信AI助手如何用12主流AI服务打造你的智能聊天机器人终极微信AI助手如何用12主流AI服务打造你的智能聊天机器人 还在为微信消息太多而烦恼吗想要一个能够24小时自动回复消息的智能助手吗今天我要为你介绍一个AI 应用人工智能AI Agent即时通讯gettext-go 完全指南在 Go 项目中接入 GNU gettext 国际化与本地化gettext go 完全指南在 Go 项目中接入 GNU gettext 国际化与本地化 导读 gettext go 是 GNU gettext 国际化/本云原生多集群集群管理微服务上一篇Milvus Search Order By 特性设计解析用标量字段重排向量搜索结果下一篇让你的App走向全球Framework7应用国际化全攻略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
