使用 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 文件目标中构建目标。

选择以下选项之一

构建一个目标(例如,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 公司的 商标。所有其他商标均为其各自所有者的财产。