View source for 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 的子进程功能具有以下特点：

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

== API 详解 ==

=== startNoUiChildProcess 函数 ===

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

<source lang="cpp">
static void QtOhosExtras::QOhosAppContext::startNoUiChildProcess(
    QString libraryName,
    QStringList args
);
</source>

==== 参数详解 ====

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

==== 功能机制 ====

该函数基于 HarmonyOS 的 [https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-app-ability-childprocessmanager-V5 Child Process Manager API] 实现，具有以下特点：

# '''异步启动'''：子进程启动为异步操作，不会阻塞主进程。
# '''参数转发'''：传递的参数会被转发到子进程的 main() 函数中作为命令行参数。
# '''进程隔离'''：子进程独立运行，与主进程内存空间隔离。
# '''生命周期管理'''：子进程需要自行管理生命周期。

== 手动开发步骤 ==

=== 1. 准备工作 ===

首先，确保您有：
* Qt for HarmonyOS 开发环境
* HarmonyOS 应用工程目录
* 对多进程架构的基本理解

=== 2. 创建项目结构 ===

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

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

=== 3. 子进程实现详解 ===

==== 基础子进程框架 ====

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

'''BackgroundTask/main.cpp:'''
<source lang="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();
}
</source>

=== 4. 主应用实现详解 ===

==== A. 界面头文件定义 ====

'''MainApp/mainwindow.h:'''
<source lang="cpp">
#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
</source>

==== B. 核心功能实现 ====

'''MainApp/mainwindow.cpp:'''
<source lang="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!");
}
</source>

==== C. 主应用项目配置 ====

'''MainApp/MainApp.pro:'''
<source lang="pro">
QT += core gui widgets ohosextras

SOURCES += \
    main.cpp \
    mainwindow.cpp

HEADERS += \
    mainwindow.h

FORMS += \
    mainwindow.ui
</source>

== 手动编译和部署 ==

=== 1. 编译子进程动态库 ===

<source lang="bash">
# 进入子进程目录
cd BackgroundTask

# 生成 Makefile
qmake BackgroundTask.pro

# 编译生成 .so 文件
make

# 验证生成的文件
ls -la libBackgroundTask.so
</source>

=== 2. 手动部署动态库文件 ===

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

<source lang="bash">
# 创建目标目录（如果不存在）
mkdir -p entry/libs/arm64-v8a

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

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

=== 3. 编译主应用 ===

<source lang="bash">
# 编译主应用
cd MainApp
qmake MainApp.pro
make
</source>

=== 完整部署检查清单 ===

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

== 测试验证方法 ==

=== 1. 功能测试 ===

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

=== 2. 进程状态验证 ===

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

==== 任务管理器检查 ====
在设备的任务管理器中应该能看到：
* '''主进程'''：<code>com.yourpackage.name</code>
* '''子进程'''：<code>com.yourpackage.name:QChildProcess0</code>

=== 完整测试案例 ===

以下是基于 <code>testUiLessProcess</code> 参考示例的完整测试流程：

# 编译子进程
#: <source lang="bash">cd testUiLessProcess/TestConsoleApp && qmake TestConsoleApp.pro && make</source>
# 部署动态库
#: <source lang="bash">cp libTestConsoleApp.so ../ohostemplateforqtapplication/entry/libs/arm64-v8a/</source>
# 编译运行主应用
#: <source lang="bash">cd ../mainWindowApp && qmake mainWindowApp.pro && make && ./mainWindowApp</source>
# 执行测试操作
#* 点击 "Start Child Process" 按钮。
#* 观察到 "Start UI less Child Process Successfully!" 提示。
# 验证结果
#* 任务管理器查看进程。

== 相关资源 ==

=== 官方文档 ===
* [https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-app-ability-childprocessmanager-V5 HarmonyOS Child Process Manager API] - 底层 API 参考