使用 ltext2id

ltext2id 命令行工具可将使用基于文本翻译的项目转换为使用基于 ID 的翻译。它会扫描项目树，更新源代码以调用基于 ID 的翻译 API，并相应调整相关的TS 文件。如果转换失败，源代码将在失败位置标注//ltext2id error: 。

为获得最佳效果，请将源文件和TS 文件都包含在传递给工具的项目根目录中，以便代码和翻译之间的更新保持一致。

ltext2id 语法

ltext2id [options] [project-root]

其中：

• options 指一个或多个ltext2id 选项。
• project-root 是要递归处理的目录。

要查看最新帮助，请输入

ltext2id -help

ltext2id 选项

示例

将项目转换为基于 ID 的翻译

在项目根目录下运行该工具。该目录下的源代码和TS 文件将就地更新。

ltext2id path/to/project

只生成 ID 建议（不修改代码）

使用-only-meta-id 注入元字符串 ID 建议，而无需重写对基于 ID 的 API 的调用。因此，翻译调用会以'//~ meta-id <id>'（cpp）元字符串注释，指定建议的 ID（元 ID）。

ltext2id -only-meta-id path/to/project

禁用标签生成

如果不想在Qt Linguist 中将上下文镜像为标签，则应阻止标签生成：

ltext2id -no-labels path/to/project

避免自动生成 ID

对于缺少元 ID 的调用，即已经使用元字符串"//~ meta-id <id>"（cpp）指定了 ID 的调用，跳过自动生成：

ltext2id -no-auto-id path/to/project

处理 UTF-16 源文件

如果您的源文件是 UTF-16 编码，请启用该选项：

ltext2id -source-utf16 path/to/project

退出状态

ltext2id 会在失败时（例如，在转换文件时遇到无法恢复的错误）返回一个非零的退出代码。检查标有//ltext2id error: 的就地源代码注释，修复其余问题。