鸿蒙 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 逐步复测,可以定位错误发生在父子联动还是清单计算。折叠分组和改变桌面布局也不会改变清单,只有选装操作才改变它。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐