鸿蒙 PC 上用 Qt 做组件选装,半选组怎样算出准确的安装清单
鸿蒙 PC 开发者社区 · AtomGit 鸿蒙 PC 社区 · Qt 鸿蒙移植框架仓
前言
维护台给现场工程师选装工具时,往往先按功能分组。比如「诊断工具」下面列着日志查看器、设备检查和报告导出。工程师已经取消设备检查,组名左边只剩一条横杠。此时决定该装哪几个包的,是两个仍勾着的子项。清单里多出现一个叫「诊断工具」的包,或者整组都消失,都是把树上的状态理解错了。
这个例子用 Qt Widgets 在鸿蒙 PC 上画了一棵两层树,旁边放本轮清单。我把所有组件的大小写成固定整数,以便确认哪些项进了结果。它演示清单生成,不下载或安装这些示例组件。后文安装的 HAP 是这个示范程序本身。
先对一笔 43 MiB 的清单
整组选中之后,清单里有日志查看器 18 MiB、设备检查 12 MiB、报告导出 25 MiB,加起来正好 55 MiB。我取消设备检查,右边的第二项消失,组名前变成半选,合计变为 43 MiB。真机日志此时记录 diagnostics=1,清单从三个包标识变成两个。数字改变和条目移除要一起核对。只看总数正确,仍不能排除加错了一条同样大小的组件。


紧接着在「现场资料」组选离线目录。这个项目是 28 MiB,新的合计就成了 71 MiB。两个组都显示半选,但全局清单恰好有三行。把诊断工具组折起来以后,设备检查依然不在右侧,原先的两条诊断条目没有消失。队列来自树模型的选中状态,行是否显示只是界面的展开属性。这个测试对现场有用,因为人们会折叠看完的分组,再继续浏览下一组。

窗口改成窄列后,组件树放在上面,清单放在下面。先检查 71 MiB 仍然显示,然后在窄窗里点击清空。日志中的两个组均变为 0,包标识为空,界面也回到「尚未选择组件」。清空时诊断工具组仍是折叠的,验证了隐藏的叶项同样清掉。读者复现这一步,可以试试清空后再展开组节点确认每个子项都已复位。


| 本机实际操作 | 诊断工具/现场资料 | 清单包 ID 与合计 |
| 勾选诊断工具组 | 全选/未选 | log-viewer、device-check、record-export;3 项,55 MiB |
| 取消设备检查 | 半选/未选 | log-viewer、record-export;2 项,43 MiB |
| 加选离线目录 | 半选/半选 | log-viewer、record-export、offline-catalog;3 项,71 MiB |
| 折叠诊断工具组 | 半选/半选 | 三项不变,71 MiB |
| 缩成窄窗再清空 | 未选/未选 | 空清单,0 MiB |
旧版 1.0.0 的真机和模拟器实录随文保留。上面的宽窄窗图片及清单结果来自 MateBook 14 本机重新编译、签名并安装的 1.0.1。
MateBook 14 真机组件选装实录。查看三态、跨组选装和清空。整段平均 59.99 fps,业务动作段去重后 26.56 fps。无音轨。
MateBook Pro 模拟器组件选装实录。复现 0、55、43、71、0 MiB。整段平均 3.57 fps,业务动作段去重后 3.75 fps,来自模拟器连续截图。无音轨。

树上只有叶项能代表可安装包
父节点的标识用于区分日志里的组,叶节点的另一个用途是驱动后续动作。示例用 Qt::UserRole 定义 PackageId,再用单独角色保存 SizeMiB。显示文字可以变成「查看日志」,内部仍然使用 log-viewer。若把界面上的名字当作 ID,以后重命名、翻译或者把带单位的字符串换一种拼法,都可能影响数据流。体积也直接用整数累加,不再从显示列里把单位拆掉。
父节点启用 Qt::ItemIsAutoTristate,Qt 根据子项的勾选情况更新父节点的三态。点击父节点时,多个孩子可能依次发出 itemChanged。这个版本先重启一次零毫秒的单次定时器,等当前变化处理完后统一更新预览。这样,清单不用在同一次父节点操作中先渲染一条、再渲染两条、最后渲染三条。如果工程以后把这个列表接到实际安装,只有用户确认时才应取清单并提交,刷新界面的定时器与启动下载是两件不同的事。
发生变化后,从树模型按稳定顺序重新遍历两组。外层读取分组状态供日志使用,内层只收 Qt::Checked 的叶项。有几个都可以照单核对,不会将父分组当作附加组件。遍历范围不依赖节点是否展开,折叠组后才仍能保留选中标识。项目只有两层,直接遍历够用;若以后加入版本、平台等层级,可以继续向下寻找带可装标识的数据节点,并为这种数据和展示分支加各自的测试。
#include <QApplication>
#include <QBoxLayout>
#include <QFrame>
#include <QHeaderView>
#include <QLabel>
#include <QListWidget>
#include <QPushButton>
#include <QResizeEvent>
#include <QStringList>
#include <QTimer>
#include <QTreeWidget>
#include <hilog/log.h>
#include <iterator>
namespace {
enum ComponentRole { PackageId = Qt::UserRole, SizeMiB };
struct Package {
const char *id;
const char *name;
int size;
};
const Package diagnostics[] = {
{"log-viewer", "日志查看器", 18},
{"device-check", "设备检查", 12},
{"record-export", "诊断报告导出", 25},
};
const Package fieldTools[] = {
{"offline-catalog", "离线目录", 28},
{"snapshot-review", "现场照片复核", 14},
};
QString label(const char *text)
{
return QString::fromUtf8(text);
}
class SelectionWindow final : public QWidget {
public:
SelectionWindow()
{
setWindowTitle(label("组件选装"));
setMinimumSize(500, 480);
resize(960, 640);
setStyleSheet(QStringLiteral(R"(
SelectionWindow, QWidget#root { background: #edf2f7; color: #172e43; }
QFrame#banner { background: #142e45; border-radius: 14px; }
QLabel#title { color: #ffffff; font-size: 28px; font-weight: 700; }
QLabel#subtitle { color: #bcd4e8; font-size: 14px; }
QFrame#panel { background: #ffffff; border: 1px solid #dbe6ef; border-radius: 12px; }
QLabel#section { color: #172e43; font-weight: 700; font-size: 17px; }
QLabel#total { color: #14647a; font-size: 23px; font-weight: 700; }
QLabel#footnote { color: #46647a; font-size: 13px; }
QTreeWidget, QListWidget { background: #ffffff; color: #172e43; border: 0; font-size: 15px; }
QTreeWidget::item, QListWidget::item { min-height: 30px; }
QTreeWidget::item:selected { background: #dcf0f6; color: #153e50; }
QHeaderView::section { background: #e7eef5; color: #335369; border: 0; padding: 6px; }
QPushButton { color: #145470; background: #edf6fa; border: 1px solid #c3dee9;
padding: 7px 13px; border-radius: 7px; }
QPushButton:hover { background: #d4edf6; }
QPushButton:disabled { color: #657581; }
)"));
setObjectName(QStringLiteral("root"));
auto *outer = new QVBoxLayout(this);
outer->setContentsMargins(20, 18, 20, 18);
outer->setSpacing(14);
auto *banner = new QFrame(this);
banner->setObjectName(QStringLiteral("banner"));
auto *intro = new QVBoxLayout(banner);
intro->setContentsMargins(18, 12, 18, 12);
intro->addWidget(makeLabel("组件选装", "title"));
intro->addWidget(makeLabel("现场维护工具 · 本次安装清单", "subtitle"));
outer->addWidget(banner);
auto *choices = new QFrame(this);
choices->setObjectName(QStringLiteral("panel"));
auto *choicesLayout = new QVBoxLayout(choices);
choicesLayout->setContentsMargins(14, 10, 14, 10);
choicesLayout->addWidget(makeLabel("可选组件", "section"));
tree = new QTreeWidget(choices);
tree->setHeaderLabels({label("组件"), label("大小")});
tree->header()->setSectionResizeMode(0, QHeaderView::Stretch);
tree->header()->setSectionResizeMode(1, QHeaderView::ResizeToContents);
tree->setIndentation(18);
tree->setUniformRowHeights(true);
tree->setAlternatingRowColors(true);
tree->setMinimumHeight(135);
addGroup("diagnostics", "诊断工具", diagnostics, std::size(diagnostics));
addGroup("field", "现场资料", fieldTools, std::size(fieldTools));
tree->expandAll();
choicesLayout->addWidget(tree);
auto *review = new QFrame(this);
review->setObjectName(QStringLiteral("panel"));
auto *reviewLayout = new QVBoxLayout(review);
reviewLayout->setContentsMargins(14, 10, 14, 10);
auto *heading = new QHBoxLayout();
heading->addWidget(makeLabel("清单预览", "section"), 1);
clear = new QPushButton(label("清空"), review);
heading->addWidget(clear);
reviewLayout->addLayout(heading);
total = makeLabel("", "total");
reviewLayout->addWidget(total);
selected = new QListWidget(review);
selected->setFocusPolicy(Qt::NoFocus);
selected->setSelectionMode(QAbstractItemView::NoSelection);
selected->setMinimumHeight(58);
reviewLayout->addWidget(selected);
outer->addWidget(makeLabel("勾选组名可选整组,横杠表示组内只选了部分组件。", "footnote"));
columns = new QBoxLayout(QBoxLayout::LeftToRight);
columns->setSpacing(14);
columns->addWidget(choices, 3);
columns->addWidget(review, 2);
outer->insertLayout(1, columns, 1);
refresh.setSingleShot(true);
connect(&refresh, &QTimer::timeout, this, [this] { updateManifest(); });
connect(tree, &QTreeWidget::itemChanged, this, [this](QTreeWidgetItem *, int column) {
if (column == 0) {
refresh.start(0);
}
});
connect(clear, &QPushButton::clicked, this, [this] {
for (int group = 0; group < tree->topLevelItemCount(); ++group) {
tree->topLevelItem(group)->setCheckState(0, Qt::Unchecked);
}
});
updateManifest();
}
protected:
void resizeEvent(QResizeEvent *event) override
{
QWidget::resizeEvent(event);
if (columns) {
columns->setDirection(event->size().width() >= 780
? QBoxLayout::LeftToRight : QBoxLayout::TopToBottom);
}
}
private:
QLabel *makeLabel(const char *text, const char *style)
{
auto *result = new QLabel(label(text), this);
result->setObjectName(label(style));
return result;
}
void addGroup(const char *id, const char *name, const Package *packages, size_t count)
{
auto *group = new QTreeWidgetItem(tree, {label(name)});
group->setFlags(group->flags() | Qt::ItemIsUserCheckable | Qt::ItemIsAutoTristate);
group->setData(0, PackageId, label(id));
group->setCheckState(0, Qt::Unchecked);
QFont groupFont = group->font(0);
groupFont.setBold(true);
group->setFont(0, groupFont);
for (size_t index = 0; index < count; ++index) {
const Package &pkg = packages[index];
auto *leaf = new QTreeWidgetItem(group, {label(pkg.name), QString::number(pkg.size) + " MiB"});
leaf->setFlags(leaf->flags() | Qt::ItemIsUserCheckable);
leaf->setData(0, PackageId, label(pkg.id));
leaf->setData(0, SizeMiB, pkg.size);
leaf->setCheckState(0, Qt::Unchecked);
}
}
void updateManifest()
{
selected->clear();
int size = 0;
QStringList ids;
QStringList groupStates;
for (int row = 0; row < tree->topLevelItemCount(); ++row) {
const auto *group = tree->topLevelItem(row);
groupStates.append(group->data(0, PackageId).toString() + '=' + QString::number(group->checkState(0)));
for (int index = 0; index < group->childCount(); ++index) {
const auto *leaf = group->child(index);
if (leaf->checkState(0) != Qt::Checked) {
continue;
}
ids.append(leaf->data(0, PackageId).toString());
size += leaf->data(0, SizeMiB).toInt();
selected->addItem(leaf->text(0) + QStringLiteral(" ") + leaf->text(1));
}
}
if (ids.isEmpty()) {
selected->addItem(label("尚未选择组件"));
}
total->setText(label("%1 项 · %2 MiB").arg(ids.size()).arg(size));
clear->setEnabled(!ids.isEmpty());
OH_LOG_Print(LOG_APP, LOG_INFO, 0xFF00, "ComponentTree",
"groups=%{public}s ids=[%{public}s] totalMiB=%{public}d",
qPrintable(groupStates.join(',')), qPrintable(ids.join(',')), size);
}
QTreeWidget *tree = nullptr;
QListWidget *selected = nullptr;
QLabel *total = nullptr;
QPushButton *clear = nullptr;
QBoxLayout *columns = nullptr;
QTimer refresh;
};
}
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
SelectionWindow window;
window.show();
return app.exec();
}
日志给出的三个部分正好用于排查。若勾选父项后孩子没有都变成选中,先检查三态标志及孩子可勾选配置。若两个孩子已选中但清单包含组号,问题就落在遍历或筛选。最后在预览里核对名称和整数大小,能看出同一包 ID 是否映射到了正确的展示行。Qt Maintenance Tool 的实际选装界面也用分组和组件大小帮助用户理解这一过程。Qt 组件选装界面参考
还有一个实际核对点在清单与安装任务的边界。项目预览按节点的固定顺序输出,同一组人的点击顺序可以不同,但只要最终勾选一样,列表就应一致。若把清单提交给下载任务,可以把模型中的 ID 和整数体积组成一份快照,再交给下载器。这样工程师在任务开始后折起某个分组,清单来源仍然可追溯。示例没有启动下载,因此也不会把用户清空界面解读成取消安装。
从宽窗换成窄窗的过程只设置 QBoxLayout 的方向。程序用 Qt 的窗口宽度判断是否达到 780,复用原来的 QTreeWidget 和列表对象。把这一步放在两个分组都半选之后,屏幕上仍显示三条结果,是检查布局没有重新创建组件模型的一种方式。若重建了树却没恢复选择,71 MiB 会在拖动窗口时无故归零。这次窄窗明确看到 71 MiB 保留,直到点击清空才成为 0。
将业务程序和 Qt 依赖交给鸿蒙电脑
本机把工程源码和 Qt 5.15.12 Alpha v9 ARM64 框架依赖分开放。可先取得同版本的鸿蒙 Qt 头文件、Core、Gui、Widgets 动态库和 qopenharmony 平台插件,把依赖解包到本机目录。测试里使用的是已在 MateBook 14 上解开的同版本公共框架依赖,应用自己的 C++ 与 ArkTS 仍从源码在本机编译。项目里的 prepare-qt.sh 把头文件放在 qt-headers,把三组动态库和平台插件放进 entry/libs/arm64-v8a。应用 CMake 通过本工程相对路径建立 Qt 导入目标,避免依赖另一台开发机的盘符或目录。
cmake_minimum_required(VERSION 3.16)
project(entry LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
get_filename_component(qt_headers "${CMAKE_CURRENT_SOURCE_DIR}/../../../../qt-headers" ABSOLUTE)
get_filename_component(qt_libs "${CMAKE_CURRENT_SOURCE_DIR}/../../../libs/arm64-v8a" ABSOLUTE)
add_library(entry SHARED main.cpp)
foreach(component IN ITEMS Core Gui Widgets)
add_library(Qt5::${component} SHARED IMPORTED)
set_target_properties(Qt5::${component} PROPERTIES IMPORTED_LOCATION "${qt_libs}/libQt5${component}.so")
target_include_directories(entry SYSTEM PRIVATE "${qt_headers}/Qt${component}")
endforeach()
target_include_directories(entry SYSTEM PRIVATE "${qt_headers}")
target_link_libraries(entry PRIVATE Qt5::Core Qt5::Gui Qt5::Widgets hilog_ndk.z)
原项目有双架构配置。本轮的交付验证在 ARM64 真机,模块的 abiFilters 只保留 arm64-v8a,链接设备对应的头文件和库。恢复工程和框架目录后,在鸿蒙电脑版 DevEco Studio 打开项目,打开本机终端取得命令行构建工具。首轮用 OhPM 同步,再让 Hvigor 执行 CMake、Ninja 和 HAP 打包。34 项任务共用 8.342 秒,未签名包 21,768,231 字节。包内已经带本机编译的应用库和 Qt 平台插件。
tar -xzf qt-component-tree-source.tar.gz
cd QtComponentTree
uname -m
sh prepare-qt.sh /path/to/qt-arm64
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon
第一次把未签名 HAP 装到此电脑时,安装器报 9568320,文字为 no signature file。从 IDE 输出打开签名设置,用已登录的开发者账号生成调试签名。重新运行后,IDE 使用 entry-default-signed.hap 安装并启动 EntryAbility。本次签名输出为 22,008,293 字节,安装后的包名 com.aasd23.ugcqtcomponenttree,versionName 1.0.1,versionCode 1000001。首次运行先看窗口能否打开,再用 55、43、71、0 MiB 的操作链核对业务状态。
| 环境 | 本次配置 |
| 本机开发与实测 | 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,Qt 5.15.12 Alpha v9 ARM64,C++17,目标及兼容 HarmonyOS 6.1.1(API 24),2in1 |
| 早期模拟器对照 | MateBook Pro 2in1,配置 HarmonyOS 6.1.1(API 24),运行镜像 OpenHarmony-6.1.1.125,x86_64;旧版录屏为 1.0.0 |



FAQ
树里有横杠,为什么清单还能有三项? 横杠描述的是单个组内部没有全选。多个半选组可以同时有已选的叶项。全局合计要从每个已选叶项计算。此次双半选保留两个诊断项和一个现场资料项,共 71 MiB,组本身都没有加入清单。
看见未选或半选,从代码里应检查哪一处? Qt::CheckState 的 0、1、2 分别是未选、半选、全选。先记录父项三态,再读取每个叶子的 checkState,最后对照预览 ID。如果父项的状态变了但预览没有更新,还要检查 itemChanged 是否触发,以及界面更新有没有等到同一次联动完成。
如何确认 HAP 失败发生在签名还是 Qt 库? 安装器报 no signature file 时还没启动应用,首先检查实际安装的 HAP。若已安装、退出前连窗口都没有,则需要另查 ABI、动态库和平台插件,结合本机日志确认 Qt 的入口有没有跑起来。装机成功后仍要点项目的真实功能,不能用安装完成来推断清单逻辑正确。
总结
在这棵树里,父组的状态用来反馈选择范围,叶项决定可安装组件。用同一份数据生成界面清单和日志,再用 55、43、71、0 MiB 逐步复测,可以定位错误发生在父子联动还是清单计算。折叠分组和改变桌面布局也不会改变清单,只有选装操作才改变它。
更多推荐

所有评论(0)