鸿蒙（API 12 Beta2版）NDK开发【QoS 开发指导】线程调度

场景介绍

自多道程序及多任务操作系统问世以来，CPU、内存等有限的系统资源成为系统中所有任务的竞争对象。合理安排各个任务对系统的响应速度以及资源消耗都有非常重大的意义。相比操作系统，开发者更加清楚应用中各个任务的重要程度；根据重要程度对应用的任务进行分类，能帮助系统更好地进行任务的调度。通过本指导，开发者可以了解在HarmonyOS系统中，如何利用QoS特性及相关的接口调节任务在系统中的运行时间分配。

本文用于指导开发者基于QoS特性实现应用任务优先调度属性自定义。

基本概念

QoS

QoS(quality-of-service)，即服务质量，在HarmonyOS中QoS特性主要指任务的优先调度属性。开发者可以利用QoS对要执行的工作进行分类，以指示其与用户交互的关联程度；系统则可以根据任务设置的QoS安排各任务的运行时间和运行次序

。例如，当系统中有多个任务需要同时执行时，一些与用户交互关联程度不高的后台下载任务可以推迟到更晚的时间执行，且每次执行时分配更少的时间；而用户感知明显的动效绘制等任务则需要立即执行，并分配更多的执行时间。

QoS等级定义

目前，HarmonyOS系统一共划分如下了6个QoS等级，从上到下与用户交互的关联程度依次递增，适用于多种不同的应用场景及负载特征情况。

QoS等级	使用场景	负载特征
QOS_BACKGROUND	后台且用户不可见任务，例如数据同步、备份。	任务完成需要几分钟甚至几小时。
QOS_UTILITY	不需要立即看到响应效果的任务，例如下载或导入数据。	任务完成需要几秒到几分钟
QOS_DEFAULT	默认。	任务完成需要几秒钟。
QOS_USER_INITIATED	用户触发并且可见进展的任务，例如打开文档。	任务在几秒钟之内完成。
QOS_DEADLINE_REQUEST	越快越好的关键任务，如页面加载。	任务几乎是瞬间完成的。
QOS_USER_INTERACTIVE	用户交互任务（UI线程、刷新界面、动效）。	任务是即时的。

QoS等级定义为枚举类型QoS_level，如上表所示；枚举值定义如下。

QoS_Level声明

typedef enum QoS_Level {
    /**
     * 适用于数据同步等用户不可见的后台任务。
     */
    QOS_BACKGROUND,
    /**
     * 适用于下载等不需要立即看到响应效果的任务。
     */
    QOS_UTILITY,
    /**
     * 默认的QoS等级。
     */
    QOS_DEFAULT,
    /**
     * 适用于打开文档等用户触发并且可以看到进展的任务。
     */
    QOS_USER_INITIATED,
    /**
     * 适用于页面加载等越快越好的任务。
     */
    QOS_DEADLINE_REQUEST,
    /**
     * 适用于动效绘制等用户交互任务。
     */
    QOS_USER_INTERACTIVE,
} QoS_Level;

功能效果

QoS等级更高的任务相对等级更低的可能被分配更多的CPU时间。

下面将展示合理使用QoS对程序执行的优化效果。

QoS对线程执行的优化

优化前

线程1和线程2是某程序的两个关键线程，线程1在运行时会触发新任务线程2，等线程2执行完后会唤醒线程1继续执行。在未标记这两个线程的QoS等级之前，其优先执行顺序低于线程3和线程4；此时线程1和线程2的执行效果如上图所示：

1. 线程1等待被线程2唤醒，而线程2优先级低，长时间被抢占，导致线程1长时间睡眠；
2. 线程1优先级低，它被唤醒后等待运行时间长；
3. 线程1优先级低，运行过程中长时间被其它线程抢占。

优化后

合理标记线程1和线程2的QoS等级后，两个线程的执行优化效果如上图所示：

1. 线程2运行时间占比提高，线程1等待时间减少；
2. 线程1被线程2唤醒后，等待的时间减少；
3. 线程1运行实际占比提高，被抢占比例减少。

QoS对RN框架的优化

在RN框架中合理标记关键线程的QoS等级后，如下表所示，开源benchmark测试的性能提升了约13%。

验证场景	验证环境	Hermes引擎段时间	RN Common时间	RN框架+ArkUI原生渲染共有指令执行时间	原生渲染段时间	总计
benchmark1500view	无QoS优化	173.1 ms	24.3 ms	33.1 ms	4.03 ms	270.8 ms
benchmark1500view	使用QoS优化	144.8 ms	23.4 ms	33.7 ms	34.8 ms	236.6 ms

接口说明

接口名	描述	参数	返回值
OH_QoS_SetThreadQoS(QoS_Level level)	设置当前任务的QoS等级。	QoS_Level level	0或-1
OH_QoS_ResetThreadQoS()	取消当前任务设置的QoS等级。	无	0或-1
OH_QoS_GetThreadQoS(QoS_Level *level)	获取当前任务的QoS等级。	QoS_Level *level	0或-1

使用限制

• QoS接口只能设置本任务的QoS等级。

函数介绍

OH_QoS_SetThreadQoS

声明

int OH_QoS_SetThreadQoS(QoS_Level level);

参数

QoS_Level level

• 该参数用于描述要为任务设置的QoS等级。

返回值

• 若成功则返回0，失败则返回-1。

描述

为某个任务设置指定的QoS等级。

样例

#include <stdio.h>
#include "qos/qos.h"

int main()
{
    // 设置当前任务的QoS等级为QOS_USER_INITIATED
    int ret = OH_QoS_SetThreadQoS(QoS_Level::QOS_USER_INITIATED);
    
    if (!ret) { // ret等于0说明设置成功
        printf("set QoS Success.");
    } else { // ret不等于0说明设置失败
        printf("set QoS failed.");
    }

    return 0;
}

OH_QoS_ResetThreadQoS

声明

int OH_QoS_ResetThreadQoS();

参数

• 无。

返回值

• 若成功则返回0，失败则返回-1。

描述

取消某个任务设置的QoS等级。

样例

#include <stdio.h>
#include "qos/qos.h"

int main()
{
    // 设置当前任务的QoS等级为QOS_USER_INITIATED
    int ret = OH_QoS_SetThreadQoS(QoS_Level::QOS_USER_INITIATED);
    
    if (!ret) { // ret等于0说明设置成功
        printf("set QoS Success.");
    } else { // ret不等于0说明设置失败
        printf("set QoS failed.");
    }

    return 0;
}

OH_QoS_GetThreadQoS

声明

int OH_QoS_GetThreadQoS(QoS_Level *level);

参数

QoS_Level *level

• 该参数用于存储任务已经设置的QoS等级。

返回值

• 若成功则返回0，失败则返回-1。

描述

获取某个任务之前最近一次设置的QoS等级；如果之前未设置任何QoS等级，则返回-1。

样例

#include <stdio.h>
#include "qos/qos.h"

int main()
{
    // 重置当前任务的QoS等级
    int ret = OH_QoS_ResetThreadQoS();
    
    if (!ret) { // ret等于0说明重置成功
        printf("reset QoS Success.");
    } else { // ret不等于0说明重置失败
        printf("reset QoS failed.");
    }

    return 0;
}

开发步骤

以下步骤描述了如何使用QoS特性提供的Native API接口，调整或查询任务的QoS等级。

添加动态链接库

CMakeLists.txt中添加以下lib：

libqos.so

示例

#include <stdio.h>
#include "qos/qos.h"

int main()
{
    // 获取当前任务的QoS等级
    QoS_Level level = QoS_Level::QOS_DEFAULT;
    int ret = OH_QoS_GetThreadQoS(&level);

    if (!ret) { // ret等于0说明获取成功
        printf("get QoS level %d Success.", level);
    } else { // ret不等于0说明获取失败
        printf("get QoS level failed.");
    }

    return 0;
}

头文件

#include "qos/qos.h"

调用QoS接口

开发者根据自身需求调用相应的QoS接口调整任务的QoS等级，或者查询任务的QoS等级。

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
• 《鸿蒙生态应用开发V2.0白皮书》
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
• OpenHarmony北向、南向开发环境搭建
• 《鸿蒙开发基础》
• 《鸿蒙开发进阶》
• 《鸿蒙开发实战》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿