Qt for HarmonyOS/user development/how to start uiless child process zh

简介

HarmonyOS 平台支持多进程架构，Qt 通过 startNoUiChildProcess API 为开发者提供了创建无 UI 子进程并传递启动参数的能力。本指南将详细说明该功能的使用方法、部署步骤，并提供完整的代码示例。

功能架构概述

在 HarmonyOS 中使用 Qt 子进程功能时，可以参考以下架构原则：

• 主应用进程
  • 负责 UI 交互和用户界面
  • 通过 QtOhosExtras 模块调用子进程 API
  • 传递启动参数给子进程
• 子进程（无 UI）
  • 接收主进程传递的启动参数
  • 执行后台任务和数据处理
  • 独立运行，不依赖主进程 UI

核心特性

Qt for HarmonyOS 的子进程功能具有以下特点：

1. 多参数传递支持：应用可以自定义传递多个启动参数，参数类型为基础类型。
2. 差异化启动能力：支持启动不同的子进程时传递不同的启动参数。
3. 无 UI 后台处理：子进程专门用于后台处理任务，不占用 UI 资源。
4. 参数自动转发：启动参数会自动转发到子进程的

   main()
   

   函数。

API 详解

startNoUiChildProcess 函数

该函数是 Qt for HarmonyOS 提供的核心子进程启动 API：

static void QtOhosExtras::QOhosAppContext::startNoUiChildProcess(
    QString libraryName,
    QStringList args
);

参数详解

参数	类型	说明
libraryName	QString	子进程的动态库名称（如 "libChildApp.so" ）
args	QStringList	要传递给子进程的参数列表

功能机制

该函数基于 HarmonyOS 的 Child Process Manager API 实现，具有以下特点：

1. 异步启动：子进程启动为异步操作，不会阻塞主进程。
2. 参数转发：传递的参数会被转发到子进程的

   main()
   

   函数中作为命令行参数。
3. 进程隔离：子进程独立运行，与主进程内存空间隔离。
4. 生命周期管理：子进程需要自行管理生命周期。

手动开发步骤

1. 准备工作

首先，确保您有：

• Qt for HarmonyOS 开发环境
• HarmonyOS 应用工程目录
• 对多进程架构的基本理解

2. 创建项目结构

典型的子进程应用需要包含主应用和子进程两部分，建议按以下结构组织：

YourProject/
├── MainApp/                # 主应用（负责UI交互）
│   ├── main.cpp
│   ├── mainwindow.cpp
│   ├── mainwindow.h
│   ├── mainwindow.ui
│   └── MainApp.pro
└── BackgroundTask/         # 子进程应用（后台任务处理）
    ├── main.cpp
    └── BackgroundTask.pro

3. 子进程实现详解

基础子进程框架

子进程的核心任务是接收和处理主进程传递的启动参数。以下是一个完整的子进程实现：

BackgroundTask/main.cpp:

#include <QCoreApplication>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);

    qDebug() << "Child process started";
    qDebug() << "Total arguments:" << argc;

    // 处理传递的参数
    for (int i = 0; i < argc; ++i) {
        qDebug() << "Argument" << i << ":" << argv[i];
    }

    // 根据参数执行不同的业务逻辑
    if (argc > 1) {
        QString command = QString::fromLocal8Bit(argv[1]);
        if (command == "task1") {
            qDebug() << "Executing task 1";
            // 执行任务1的逻辑
        } else if (command == "task2") {
            qDebug() << "Executing task 2";
            // 执行任务2的逻辑
        }
    }

    return app.exec();
}

4. 主应用实现详解

A. 界面头文件定义

MainApp/mainwindow.h:

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    void startChildProcess1();
    void startChildProcess2();

private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H

B. 核心功能实现

MainApp/mainwindow.cpp:

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QtOhosExtras/QtOhosExtras>
#include <QStringList>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::startChildProcess1()
{
    // 启动子进程并传递参数
    QtOhosExtras::QOhosAppContext::startNoUiChildProcess(
        "libBackgroundTask.so",
        QStringList{
            "task1",           // 任务类型
            "param1",          // 参数1
            "param2",          // 参数2
            "priority_high"    // 优先级
        });

    ui->statusLabel->setText("Child Process 1 Started!");
}

void MainWindow::startChildProcess2()
{
    // 启动另一个子进程实例，传递不同参数
    QtOhosExtras::QOhosAppContext::startNoUiChildProcess(
        "libBackgroundTask.so",
        QStringList{
            "task2",           // 不同的任务类型
            "config.json",     // 配置文件
            "debug_mode"       // 调试模式
        });

    ui->statusLabel->setText("Child Process 2 Started!");
}

C. 主应用项目配置

MainApp/MainApp.pro:

QT += core gui widgets ohosextras

SOURCES += \
    main.cpp \
    mainwindow.cpp

HEADERS += \
    mainwindow.h

FORMS += \
    mainwindow.ui

手动编译和部署

1. 编译子进程动态库

# 进入子进程目录
cd BackgroundTask

# 生成 Makefile
qmake BackgroundTask.pro

# 编译生成 .so 文件
make

# 验证生成的文件
ls -la libBackgroundTask.so

2. 手动部署动态库文件

在 HarmonyOS 中部署子进程动态库时，需要遵循特定的目录结构：

# 创建目标目录（如果不存在）
mkdir -p entry/libs/arm64-v8a

# 复制动态库到指定位置
cp BackgroundTask/libBackgroundTask.so entry/libs/arm64-v8a/

# 验证部署
ls -la entry/libs/arm64-v8a/libBackgroundTask.so

3. 编译主应用

# 编译主应用
cd MainApp
qmake MainApp.pro
make

完整部署检查清单

ohostemplateforqtapplication/
├── entry/
│   └── libs/
│       └── arm64-v8a/
│           ├── libBackgroundTask.so  # 子进程动态库
│           └── ... # 其他Qt相关库文件
├── MainApp/
└── BackgroundTask/

测试验证方法

1. 功能测试

1. 启动主应用：运行编译好的主应用程序。
2. 触发子进程：点击界面上的启动按钮。
3. 观察状态反馈：检查应用界面的状态提示信息。

2. 进程状态验证

通过以下方式确认进程创建成功：

任务管理器检查

在设备的任务管理器中应该能看到：

• 主进程：

  com.yourpackage.name
  

• 子进程：

  com.yourpackage.name:QChildProcess0
  

完整测试案例

以下是基于

testUiLessProcess

参考示例的完整测试流程：

1. 编译子进程

   cd testUiLessProcess/TestConsoleApp && qmake TestConsoleApp.pro && make
   

2. 部署动态库

   cp libTestConsoleApp.so ../ohostemplateforqtapplication/entry/libs/arm64-v8a/
   

3. 编译运行主应用

   cd ../mainWindowApp && qmake mainWindowApp.pro && make && ./mainWindowApp
   

4. 执行测试操作
   • 点击 "Start Child Process" 按钮。
   • 观察到 "Start UI less Child Process Successfully!" 提示。
5. 验证结果
   • 任务管理器查看进程。

相关资源

官方文档

• HarmonyOS Child Process Manager API - 底层 API 参考