在本页

使用 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 选项传递给lupdatelrelease
-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 文件,供lupdatelrelease 使用:

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.