鸿蒙 PC 的 Qt 巡检值班表,切换界面语言时保留当前工位
Qt鸿蒙框架AtomGit仓 · 巡检值班表完整源码 · 鸿蒙 PC 开发者社区
交班前,把分拣台页面直接换成中文
巡检值班表左边是工位,右边是这班要交接的事项。早班在英文界面里打开了分拣台,负责接班的人习惯看中文。这时可以让早班切一下语言,接班的人继续看原来的事项。要是菜单一按,应用把选择重置到第一行,详情就会从「下午巡检前确认电源状态」跳成收货区的侧门检查。现场两条备注都很合理,接班人未必会立刻发现自己拿错了工位。
我这次拿工位编号当检查点。第一个动作是在 MateBook 14 的英文窗口里选中第二行。左边显示 Sorting desk,右边是 ST-27,备注是 Verify power before the afternoon round. 随后只点「简体中文」,不再碰工位列表。系统窗口标题和应用内标题先后刷新,左边第二行变成分拣台,右边仍然显示 ST-27,正文变成「下午巡检前确认电源状态。」下两张全屏图保留了程序坞和同一张工位表,正好可以逐项对照。


再按一次 English,原来的英文备注恢复,第二行继续高亮。之后特意改选第三行,再切中文,详情改成 MT-31 的「交接前记录最后一次读数。」这一步让验收有了反例。如果代码只是把 ST-27 固定写在详情里,前面那组截图也可能看起来对,到了第三行就露出问题。回看的时候要同时盯当前行、右侧编号、备注和顶部语言按钮,单靠标题变化只检查了很小一段。
| MateBook 14 上的操作 | 当前编号 | 屏幕中的备注 |
| 英文界面选第二行 | ST-27 | Verify power before the afternoon round. |
| 只点简体中文 | ST-27 | 下午巡检前确认电源状态。 |
| 只点 English | ST-27 | Verify power before the afternoon round. |
| 选第三行后再切中文 | MT-31 | 交接前记录最后一次读数。 |
换语言的日志和画面各有用途。应用打印 locale 与编号,几秒内作了多次切换也能定位每次事件。详情标签由 LanguageChange 更新,日志里随后还有对应的 display selection。中文备注和选中底色由屏幕截图复核,日志行本身没有记录这两项。
locale=zh_CN selection=ST-27
locale=en_US selection=ST-27
locale=zh_CN selection=MT-31
词条怎么替换,列表为什么还认得自己的那一行
工位用三份记录描述,各自包含编号、可翻译的名称以及备注源串。列表构造时,每份记录只创建一个 QListWidgetItem,把编号另存到 Qt::UserRole,名称稍后才写入显示文本。所以哪怕一个地址在英文显示为 Sorting desk,在中文显示为分拣台,业务侧取到的都是 ST-27。打开文件、传递参数或日后联动其他页面时也能使用同一个值,避免再去拆显示字符串里的分隔符。
换语言按钮的回调负责准备翻译器。切中文先试读目录,失败会显示错误并恢复按钮选中态。在确认能加载中文目录后,才把 QTranslator 安装到 QApplication 上。切回英文则移除这个翻译器,由 QCoreApplication::translate 回退到原来的英文源串。按钮检查状态和窗口文案分开管理,连点当前语言时,回调可以在同步按钮状态后直接返回。
Qt 在翻译器变更后让窗口处理 LanguageChange。这个窗口收到事件,把标题、栏头、字段名改成目标语言,同时对原来的每个列表项调用 setText。代码没有调用 clear,没有新插入一组同名项目,也没有再设一次当前行。末尾单独调用 showCurrent,以当前行取编号和备注源串。这样即使切换时列表没有再发 currentRowChanged,原来那条备注也一定会随着语言变更重查一次。
这里仍有一个必须讲清的前提。三个工位以业务顺序摆放,未按译文重排。showCurrent 用当前行索引取同一数组的备注,在这种固定顺序下成立。如果项目要按本地化名称排序,应把用于查找工位记录的标识也改成稳定编号。排序之前留好编号,刷新后按编号找新的所在行。只保存旧行号,在中英文排序结果不同的情况下会把详情指到另一项。
void retranslate()
{
setWindowTitle(translated("Inspection Roster"));
title->setText(translated("Inspection Roster"));
kicker->setText(translated("Depot handover"));
listHeading->setText(translated("Work stations"));
detailsHeading->setText(translated("Shift details"));
codeHeading->setText(translated("Station code"));
noteHeading->setText(translated("Shift note"));
for (size_t i = 0; i < std::size(stations); ++i) {
list->item(static_cast<int>(i))->setText(
QString::fromLatin1(stations[i].code) + QStringLiteral(" · ") + translated(stations[i].name));
}
syncButtons();
showCurrent();
}
void showCurrent()
{
const int row = list->currentRow();
if (row < 0) {
codeValue->clear();
noteValue->setText(translated("No station selected"));
return;
}
codeValue->setText(list->item(row)->data(Qt::UserRole).toString());
noteValue->setText(translated(stations[row].note));
OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "RosterLocale", "display selection=%{public}s",
qPrintable(codeValue->text()));
}
下面保留修订前已录的真机和模拟器操作,便于连续观看语言按钮、选中项和详情的变化。上面的截图来自本次鸿蒙电脑本机编译并签名安装的 1.0.1。
MateBook 14 真机工位语言切换。从收货区切到分拣台,中英文来回切换,再选电表房。录屏平均 59.99 fps,动作段去重后 28.80 fps,无音轨。
MateBook Pro 模拟器工位语言切换。平均 3.42 fps,动作段有效帧率 3.39 fps,无音轨。切回英文后的过渡中有一帧窗口空白,后续正常呈现,完整英文画面另有独立截图。
新增实录从英文ST-27开始,只按简体中文,当前行和详情编号都没有跳走。再按English,仍是同一工位的英文备注。最后主动选择MT-31再切中文,详情才成为电表房的最后一次读数要求。两次工位对照可以排除把ST-27备注固定写在界面里的实现。

原始采集约60.09 fps,GIF按原时间戳保留466帧、7.76秒,约60.05 fps。静态停留会录到相同画面,不能将采集速率解读为每秒60次译文变化;转制没有添加帧或插帧。模拟器已启动,但当前1.0.1工程仅构建ARM64,原有1.0.0的x86视频继续按历史范围保留。
在鸿蒙电脑把翻译目录从源码生成
旧工程把中文 QM 文件放在资源目录里,同时保留供维护的 TS。要证明这次的包是从源文件重做,我在解包时去掉了旧 QM 和引用它的资源表,留下面向翻译人员的 TS 和真正处理事件的 C++。工程直接在 MateBook 14 的 DevEco Studio 中导入。准备 Qt 时只拷贝框架的 Core、Gui、Widgets 头文件和 ARM64 库,以及负责连接系统窗口的 Qt 平台插件。工程的 C++、翻译目录和 HAP 都分别在 MateBook 本机生成。Qt 框架自身的构建和应用构建是两件事。
这份工程只有 Roster 一个翻译上下文,十四条完成的普通文本,没有复数和同文异义。附带的 Node 脚本读 TS 的上下文、原文与译文,先生成 Qt 5 能读取的目录字节,再把它们写进 C++ 头文件。它会拒绝当前项目不支持的消息形态。长度和偏移按大端序写入,译文用大端 UTF-16,索引按 Qt 查询顺序排列。应用用 QTranslator 的内存加载重载读取这组字节,缓冲区是静态数组,翻译器使用期间一直有效。脚本的格式可对照 Qt 5 QM 写入实现 和 Qt 5 目录读取实现。
这一步在本机终端打印了十四条消息、990 字节。旧文件只留作旁路校验,编译输入里没有它。这里给出本次依赖准备、语言包生成和打包命令。命令在解出的工程根目录执行。读者要改自己的词条,先生成头文件,再重新编译安装。需要复数、消歧义或完整的 Qt Linguist 工具链时,用 Qt 自带的 lrelease,项目里的简化脚本只覆盖这份词条。
uname -m
node --version
sh prepare-qt.sh ../../ugc-native-36/qt-deps
node tools/compile-roster-qm.mjs entry/src/main/cpp/i18n/roster_zh.ts entry/src/main/cpp/roster_zh_qm.h
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon
ls -l entry/build/default/outputs/default/*.hap
第一次运行安装时,日志显示 9568320 和 no signature file。这次已经完成编译并得到未签名 HAP,设备是在安装流程拒绝了它。进入本机 DevEco 的项目结构,给 default 生成调试签名,再运行同一个目标。部署日志显示安装 entry-default-signed.hap 后启动 EntryAbility。我再从系统包管理器读回 com.aasd23.ugcqtlivelocale 的版本,记录为 1.0.1、版本号 1000001。这个 HAP 是本轮做界面检查的包。

| 复现条件 | 本次记录 |
| 鸿蒙电脑 | HUAWEI MateBook 14(MNTXM-24B),HarmonyOS 7.0.0,软件版本 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64 |
| 本机工具 | DevEco Studio 26.0.0.220,Node.js 24.18.1,Qt 5.15.12 Alpha v9,ARM64 |
| 工程目标 | HarmonyOS 6.1.1(API 24),2in1,arm64-v8a |
| 本机构建 | Hvigor 34 项任务,8.650 秒。未签名 HAP 21,744,587 字节,签名 HAP 21,982,789 字节 |
| 模拟器 | MateBook Pro 2in1,管理器配置HarmonyOS6.1.1(API24);实际软件6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。模拟器已启动;文章保留1.0.0历史视频。本轮1.0.1只编译ARM64,不声称当前x86构建通过。 |


收窄以后还是这一张表
把已经选中电表房的窗口收窄,原来的左右两栏改成上下两个区块。布局方向变了,原来的列表和详情对象继续显示。上方仍高亮 MT-31,下方给出对应编号和中文备注。备注支持自动换行,左右并排时和上下排列时都会交给实际布局宽度处理。这个测试应该放在切过语言之后做。只在默认英文里试宽窄,容易漏掉中文选中行和详情在布局变化时有没有留下来。

FAQ|复测时从哪儿查
改了词条之后,窗口还在显示旧文字。 先看目录生成命令是否确实重新运行,再查它的输入是否是工程中这份 roster_zh.ts。这个工程文件已生成到 C++ 目录,需打包安装后再看。若新译文仅有一处没生效,检查该处查词时传入的上下文和英文源串。固定输入不走同一个查词入口,即使目录编对也不会显示。
标题能换,为什么有时改造自己的项目只有右侧详情不动。 检查详情是否只连接了 currentRowChanged。这里特意用「选好以后手离开列表,只点两次语言」复验。语言变化不会要求用户再点行,详情更新得从 LanguageChange 的刷新路径进来。若两个语言按钮上的选中状态本身也错,应再查安装或移除翻译器前后回调和界面状态的顺序。
调试 HAP 安装后是否已上架。 本次到本机签名、安装和真机业务实测为止。应用商店流程没有在本项目中验证。复现场景中看到 9568320 时,先核实安装的究竟是哪份 HAP,再查 default 产品是否启用了调试签名,以及包名、签名配置和安装目标是否对应。
交回给现场的检法
我会留一张英文 ST-27 和一张中文 ST-27 当交接样例。标题、工位名和备注都需各读一遍,然后换成 MT-31,再按一次语言按钮。这样既能发现上一条记录残留,也能发现丢掉当前工位。项目代码按词条与业务数据分别处理,现场人员只需要看自己的任务有没有继续留在原处。
修订工程已公开在文首固定版本目录。框架入口用于查看Qt鸿蒙适配与发行依赖,完整工程入口用于取得本篇业务、TS词条和构建说明;两者用途分别标明。
更多推荐


所有评论(0)