使用 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 公司的 商标。所有其他商标均为其各自所有者的财产。