使用 lrelease
命令行工具 lrelease 从 TS 文件中生成 QM 文件。QM 文件格式是本地化应用程序使用的紧凑二进制格式,它可以对翻译提供极快的查找速度。
在用 qmake 构建时,请指定在命令行或 .pro 文件中要处理的文件。
在用 CMake 构建时,使用 CMake 命令 添加创建或更新 TS 文件并将它们转换为 QM 文件的目标到 CMakeLists.txt 文件中,然后编译这些目标。在构建目标时,使用 选项 运行 lrelease 工具。
每当您想要发布应用程序时,请运行 lrelease,从原始测试版本到最终发布版本。应用程序不需要 QM 文件即可运行,但如果它们可用,应用程序会自动检测并使用它们。
注意: lrelease 工具仅包含标记为 完成 的翻译。否则,它将使用原始文本。
lrelease 语法
lrelease [options] -project project-file lrelease [options] ts-files [-qm qm-file]
其中
选项意味着一个或多个 lrelease 选项。project-file是项目配置文件。ts-files是用于作为 QM 文件输入的 TS 文件。qm-file是要生成的 QM 文件名。
注意: 将 .pro 文件传递给 lrelease 已被弃用。当使用 qmake 时,请使用 lrelease-pro 工具或 lrelease.prf 功能。
要查看最新帮助,请输入
lrelease -help
lrelease 选项
| 选项 | 动作 |
|---|---|
-help | 显示最新帮助信息并退出。 |
-idbased | 使用 ID 而非源字符串进行消息标记。 |
-compress | 压缩 QM 文件。 |
-nounfinished | 不包含未完成的翻译。 |
-removeidentical | 如果翻译的文本与源文本相同,排除该消息。 |
-markuntranslated <prefix> | 如果消息没有实际翻译,则使用以给定文本前缀的源文本。 |
-project <filename> | 包含项目描述的 JSON 格式文件的名称。您可以使用 lprodump 工具从 .pro 文件生成该文件。 |
-silent | 不解释将要进行的操作。 |
-version | 显示 lrelease 的版本并退出。 |
示例
使用 CMake
当用 CMake 构建时,在 CMakeLists.txt 文件中添加目标翻译,然后在 CMakeLists.txt 文件目标中构建目标。
选择以下选项之一
- 在目标上使用 qt_add_translations,例如 app。这将调用 qt_add_lupdate 和 qt_add_lrelease。
- 在目标上使用
qt_add_lrelease。
构建一个目标(例如,app_lrelease),以更新其 .qm 文件。要更新所有目标的 .qm 文件,构建目标 release_translations。
使用 lrelease 与 qmake
要在不指定项目文件的情况下运行 lrelease
lrelease.exe main_en.ts languages\main_fr.ts
© 2024 Qt 公司。本文件中包含的文档贡献者是各自版权的拥有者。本文件提供的文档是根据 Free Software Foundation 发布的 GNU 自由文档许可第 1.3 版 的条款提供的。Qt 及其相应标志是芬兰和/或世界其他国家的 Qt 公司的 商标。所有其他商标均为其各自所有者的财产。