使用 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的API调用情况下，注入元字符串ID建议。因此，翻译调用会被标注为'//~ 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>' 指定了ID的调用），请跳过自动生成（C++）：

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

处理 UTF-16 源文件

如果您的源文件采用 UTF-16 编码，请启用以下选项：

ltext2id -source-utf16 path/to/project

退出状态

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