本页内容

使用 lupdate-pro

lupdate-pro 命令行工具可从qmake项目(.pro文件)中提取可翻译字符串,并更新TS文件。该工具专为基于qmake的项目设计,而lupdate 则适用于源文件和JSON描述文件,且不依赖于特定的构建系统。

当您拥有一个 qmake 项目,并希望根据 .pro 文件中定义的项目结构提取翻译内容时,请使用lupdate-pro 。

lupdate-pro 语法

lupdate-pro [options] [project-file]... [-ts ts-files...]

其中:

  • options 表示一个或多个lupdate-pro 选项。
  • project-file 是要处理的 .pro 文件。
  • ts-files 是要生成或更新的 TS 文件。

要查看最新帮助,请输入:

lupdate-pro -help

lupdate-pro 选项

选项操作
-help显示最新的帮助信息并退出。
-dump-json <file>生成一个不处理翻译内容的 JSON 项目描述文件。该文件可通过-project 选项传递给lupdate 或lrelease 。
-silent不显示正在执行的操作说明。
-pro <filename>.pro 文件的名称。适用于具有 .pro 文件语法但文件后缀不同的文件。将递归处理并合并项目。
-pro-out <directory>用于处理后续 .pro 文件的虚拟输出目录。
-pro-debug跟踪 .pro 文件的处理过程。如需更详细的输出,请重复指定此选项。
-ts <ts-file>...指定输出 TS 文件。此设置将覆盖 `TRANSLATIONS`。
-no-obsolete删除所有过时和已消失的字符串。
-pluralonly仅包含复数形式的消息。
-no-sort不在 TS 文件中对上下文进行排序。
-locations {absolute|relative|none}指定或覆盖在 TS 文件中保存源代码引用方式。
-no-ui-lines不在对 UI 文件的引用中记录行号。
-source-language <language>[_<region>]为新文件指定源字符串的语言。
-target-language <language>[_<region>]指定新文件的翻译语言。
-tr-function-alias <function>{+=,=}<alias>将<alias> 识别为<function> 的替代拼写形式。
-version显示lupdate-pro 的版本信息并退出。

示例

从 qmake 项目更新翻译

lupdate-pro myproject.pro

生成 JSON 项目描述

生成描述项目结构的 JSON 文件,供lupdate 或lrelease 使用:

lupdate-pro myproject.pro -dump-json project.json

然后将生成的 JSON 文件用于lupdate :

lupdate -project project.json

当您需要自定义项目描述或与其他工具集成时,这个两步工作流会非常有用。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.