如何在iOS应用中正确嵌入Qt 5.15本地化翻译文件

假设验证 #

• 假设1：成立。Qt各版本均携带控件、系统弹窗等场景的内置文本，5.15新增了内置翻译自动检测加载逻辑，因此低版本升级到5.15后才会出现此前没有的翻译缺失警告。
• 假设2：成立。Qt生态模块众多，默认打包全量翻译会导致包体积冗余，确实需要开发者根据实际使用的模块、支持的语言范围自行指定翻译文件。
• 假设3：配置逻辑正确，但存在优化空间。

常见疑问解答 #

1. qm文件嵌入逻辑
   只要配置了CONFIG += lrelease embed_translations，TRANSLATIONS中声明的ts文件会自动被编译为qm文件并嵌入应用资源，无需手动往iOS bundle中添加文件，你此前未配置TRANSLATIONS时抛出警告正是因为缺少这步自动生成嵌入的逻辑。
   翻译缺失属于非致命错误，确实会默认fallback到Qt源码内置的美式英文基准文本，不会导致功能异常。

2. 配置简化方案
   你给出的基础配置已经可以正常运行，有两个可优化的方向：

• 官方提供的Qt翻译文件不需要你修改或更新，无需参与lupdate流程，建议放在EXTRA_TRANSLATIONS变量中而非TRANSLATIONS，避免构建时执行不必要的lupdate步骤。
• 如果你不在意包体积增加少量内容，可以直接使用整合了所有模块翻译的qt_*.ts/qt_*.qm文件，无需逐个添加qtbase、qtdeclarative等子模块的翻译文件，避免漏加用到的模块翻译。

3. lupdate和lrelease功能差异

• lupdate：扫描项目中所有tr()、qsTr()标记的自定义文本，更新到你项目专属的ts文件中，仅用于处理应用自定义内容的翻译更新，不需要作用于Qt官方的翻译文件。
• lrelease：将ts翻译源文件编译为Qt运行时可加载的二进制qm文件，对自定义翻译和官方翻译都适用。

优化后参考配置 #

# 放你自己项目的翻译文件，会参与lupdate流程
TRANSLATIONS += your_app_en.ts your_app_de.ts your_app_fr.ts

# 放Qt官方的翻译文件，仅参与lrelease流程，替换为你本地Qt安装的对应路径即可
EXTRA_TRANSLATIONS += <path_to_qt_translations>/qtbase_en.ts \
                      <path_to_qt_translations>/qtbase_de.ts \
                      <path_to_qt_translations>/qtbase_fr.ts \
                      <path_to_qt_translations>/qtdeclarative_en.ts \
                      <path_to_qt_translations>/qtdeclarative_de.ts \
                      <path_to_qt_translations>/qtdeclarative_fr.ts

CONFIG += lrelease embed_translations

内容的提问来源于stack exchange，提问作者cycollins