OpenHarmony 4.1 Release 版本发布

鸿蒙开发者社区官方账号

发布于 2024-4-2 15:07

浏览

1收藏

OpenHarmony 4.1 Release

版本概述

随着OpenHarmony 4.1 Release的发布，开发套件同步升级到API 11 Release。相比4.0 Release版本，新增4000多个API，应用开发能力更加丰富；应用开发的开放能力以Kit维度呈现，提供给开发者更清晰的逻辑和场景化视角；ArkUI组件开放性和动效能力得到进一步增强；Web能力持续补齐，便于开发者利用Web能力快速构建应用；分布式能力进一步增强了组网稳定性、连接安全性等；媒体支持更丰富的编码，支持更精细的播控能力等等。欢迎开发者踊跃使用并给我们提出宝贵意见。

您可以阅读本文档了解更多关键特性及能力。

SDK

SDK提供的开放能力以Kit维度呈现给开发者。开发者可按Kit查找和使用能力特性，使用场景化的开放能力，体验更清晰的编程逻辑。

与此同时，开发指南和API参考也已按照Kit粒度进行罗列，方便开发者对Kit进行更进一步的了解和使用。

ArkUI

支持自定义组件扩展需求：框架提供基础组件的Modifier，开发者可继承实现自定义的Modifier，然后通过Modifier实现链式调用和参数传递。Modifier和自定义组件配合使用解决自定义组件传参的问题。Modifier机制支持单点属性更新。
Canvas支持图形GraphicContext，提升自绘制能力和性能。
文本类控制支持属性字符串
控件接入AI增强能力，包括：Image、Video、XCopmonent和Canvas控件支持实体识别；文本内容信息识别支持提取时间（日程）、地理位置。
状态管理能力优化：
- 新增接口在保留当前接口基本功能的情况下，无需调用aboutToBeDeleted进行解注册，且不会导致内存泄漏问题；
- @StorageLink、@StorageProp、@LocalStorageLink、@LocalStorageProp支持undefined、null和联合类型；
- private的普通变量或状态变量处理策略增强；
- 支持深度观察，可对类中的属性进行观察。
弹窗类组件自定义能力增强：
- 通过调用promptAction提供的接口，支持自定义显示/退出动效；
- 配置弹框样式：设置背景色、圆角、宽度、高度、边框（颜色、宽度）、阴影（偏移、圆角、透明度、颜色）、气泡箭头大小设置；
- 显示/退出交互：所有弹框将要弹出/退出时提供回调，以及对是否允许弹框退出提供回调。
滑动场景，优化单帧平均耗时。

应用框架

应用正常退出时会清理temp目录，提升安全性并减少系统存储空间消耗。
Extension管控能力增强：新增了ServiceExtension的后台管控以及统一超时机制。
ArkTS卡片能力增强：新增了透明卡片、数据代理刷新、单色模式和锁屏卡片能力。

应用包管理

系统级HSP 支持OTA升级；
新增了模块化开发包大小优化指导。

分布式软总线

构建软总线传输QoS接口能力，更优管控底层链路资源并提供选路决策，提升分布式业务体验。
子系统规格能力持续增强，选路增加连接可靠性确认能力、支持感知资源情况动态设置连接参数等。
完成子系统DFX机制增强，如：支持互联雷达打点、支持上层分布式业务统计以及支持对组网监控事件进行业务告警。
IPC支持引用技术查询和时间戳查询的接口，以及维测能力增强。

分布式数据管理

UDMF支持数据类型标准化定义与描述、支持标准数据类型查询、支持数据访问授权与管理、支持应用自定义数据类型。
新增限制数据不打分类分级标签则不允许跨设备同步。
preferences支持uint8Array格式数据流的修改、查询和持久化。
RDB支持在应用指定的沙箱路径子目录下创建数据库。

图形图像及窗口

图形图像

系统支持可变帧率，提供API供业务接入。
支持HDR Vivid视频的渲染与显示。
图形NDK能力增强，支持为NativeImage添加OnFrameAvailableListener回调，支持为NativeWindow设置色域，新增支持opengl扩展接口，Drawing 能力进一步完善等。
支持录屏不录制特定窗口，以及隐私窗口录制成全黑帧画面的能力。
支持调整系统分辨率。
支持系统根据动画调节帧率，支持开发者调节应用业务帧率。
动效能力增强，支持硬件挖空，屏幕圆角，Navigation导航转场动画支持共享元素等。
图形渲染管线支持vulkan后端。
图形接入Drawing接口。
nativeWindow支持设置metadata，适配HDR视频场景动态元数据随帧传递。

窗口

提供Window stage可交互状态通知。
提供全局搜索窗口类型。

媒体

支持通话类应用接入媒体会话。
支持投播组件的颜色自定义和状态监听。
音视频编解码支持AVBuffer结构，支持系统数据零拷贝。
解封装新增支持AMR/MKV规格。

相机

对相机PipeLine代码进行了优化，PipeLine各流解耦，允许不同流配置不同的分辨率。
补全USB相机驱动功能，可控制USB相机自动/手动的曝光、对焦以及白平衡。
添加私有TAG通道，定义了私有TAG实现方式，允许设备厂商自己定义相机Metadata TAG。

事件通知

支持系统应用发送实况窗类型的通知。
Emitter：支持订阅字符串类型事件；发送事件时传递的数据支持可序列化类型；支持获取订阅者数量。
支持应用只接收自身发布的自定义公共事件。

公共基础类库

支持在HAR/HSP中创建Worker。
TaskPool支持在执行过程中往宿主线程发送消息。

通信与连接

NFC提供HCE卡模拟能力。
在系统设置中可显示和设置默认支付应用处理，支持识别默认支付应用的变更。
Wi-Fi提供热点类型的查询，可查询当前连接热点是否为手机热点。
支持将Wi-Fi作为热点，并支持将接入的STA设备添加到黑名单的能力。

位置

支持通过sendCommand接口删除辅助数据，用于支持冷热启动测试。
支持地理编码，逆地理编码，查询地理编码服务状态等接口。
支持在MDM管控场景下，MDM调用位置服务接口强制开启或关闭位置服务功能。

电源

对DisplayPowerManager的代码结构进行了调整，亮度管理功能模块变为独立的模块。
新增支持设备关机状态下充电动画显示，充电电量可变化更新。

安全

证书管理：支持开放用户ca证书路径、支持证书链校验和吊销检查能力、支持证书链构造的能力。
关键资产存储：针对应用开发者需要在本地加密存储关键敏感的短数据（如用户的账号密码、银行卡号等）诉求，系统提供关键资产加密存储的能力，以及相应的安全访问控制能力，包括：
- 支持关键资产写入，读取。
- 支持关键资产更新。
- 支持关键资产安全销毁。
- 支持关键资产访问控制。

程序访问控制

权限管理

支持在UIExtensionAbility界面上拉起权限弹窗。
权限使用记录增加锁屏状态记录
支持应用在使用期间弹出允许权限的选项。

DLP权限管理服务

支持以时间维度对受控文件进行访问控制。
支持文档创建者在任意场景下可离线打开文档。
支持帐号未登录状态下，弹框进行帐号登录验证。
提供沙箱应用读取原始应用数据的机制和通路。

ArkCompiler

动态import能力支持变量作为参数。
提供运行时对类方法插桩和替换的API。
支持用“#”声明类的私有成员。
支持Sendable类的跨线程序列化传输。
支持Ecmascript2022规范。

资源管理

支持module.json配置文件中通过右键菜单添加资源索引。
支持对resfile资源目录打包编译。
支持基于资源名称返回资源id。

USB

补齐USB服务设备管理能力，支持全设备、按设备类型、指定设备的禁用和解禁，并支持重启、热插拔场景下的禁用策略持久化能力。
优化USB服务鉴权方式，新增访问控制权限，细化系统服务、系统应用的USB调用权限。
修复USB服务批量传输、控制传输的接口漏洞，支持传输接口端到端可用，性能满足要求。

多模输入

支持双击按压电源键拉起ability。
支持自定义鼠标光标。
多模输入设置鼠标样式优化。
支持按键监听按优先级处理的能力。
支持光标大小、颜色的设置，支持动画光标样式。

泛Sensor

支持传感器数据精度的上报，使系统可感知不同设备传感器精度，优化应用适配。
新增传感器、振动相关能力的C API接口。
自定义振动格式进行扩展，新增支持curve字段描述复杂的连续振动效果。

设备管理

小型设备平台上支持@ohos.deviceInfo.d.ts的相关API。

测试框架

自动化测试框架arkxtest

支持模拟鼠标滚轮滑动、滑动左右键双击等模拟UI操作能力。
支持Shell命令方式进行UI模拟操作能力，支持点击、滑动、双击、文本输入等常用操作能力。
提升UI测试框架查找控件信息效率。
增强dump信息内容，新增文字大小、文字颜色信息。
增加异步监听能力，监听系统弹框事件，获取其文本信息并返回。

测试调度框架xDevice

新增单次测试过程中自动复测失败项能力，并支持配置复测次数，最终生成一份测试报告。
优化测试报告，统一轻量系统、小型系统、标准系统的测试报告头信息。
新增支持测试套测试资源本地不存在时，可配置远程下载地址。

稳定性测试工具WuKong

新增page页面和Ability页面的配置能力，支持在测试过程中配置页面屏蔽，提升测试效率。
新增单一场景压测能力，支持针对某一控件循环注入操作事件，并支持配置循环次数。

性能开发工具SmartPerf Host

新增支持hilog、hisysevent的采集、分析和展示。
新增支持hiperf event count的分析和展示。
提升抓取trace的能力，动态可暂停可调试。
新增支持线程唤醒关系树的快速跟踪。

性能测试工具 SmartPerf Device

优化已有抓取内存、CPU数据的能力。
新增启动停止采集的命令。
新增定时获取截图、分辨率和刷新率的采集能力。

DFX

提供CPU、GPU、内存、IO、网络、trace采集能力。
故障类型数据生态开放。
HiDebug支持应用运行时资源信息采集。
HiProfiler支持高功耗应用在CPU、GPS、AUDIO、DISPLAY、GPU的深入调优；支持动效场景耗时分析（启动、退出、转屏、转场、滑动）；支持ftrace数据轻量化采集。
HiProfiler/HiDumper联合提供内存进程扩展内存信息的采集与增强。
HiTrace支持轻量化及长时间采集。
HiPerf支持符号解析和栈聚合能力。

上传下载

支持多个前端模式任务与后台模式任务共享任务数量的能力。
支持监听后台任务的状态和进度。
支持任务的优先级，同样是前端（或者后台）模式的任务，也可以使用优先级来调整执行顺序。
自动使用系统级代理。

输入法框架

优化了Webview获焦场景的输入法体验。
优化了窗口焦点切换场景下的输入法体验。
新增支持安全模式输入法。
新增支持Logo键+Space切换输入法。
新增输入法切换列表控件。

时间时区

支持通过系统参数配置NTP服务器地址，最多支持配置5个。
支持通过系统参数配置时间时区自动同步开关。

全球化

支持应用语言列表的获取。
支持日期快速计算。
支持文本时间识别。
支持设置和获取应用偏好语言。
支持时段按不同国家或地区的习惯进行表达。

AI

MindSpore Lite轻量化端侧学习能力开放C API。

升级

支持差分多线程升级的能力。
增加升级过程中硬件故障重试机制，提升升级可靠性。
正常模式下的语言参数能同步更新到升级阶段使用的updater简化系统中。

Web

新增支持Web的无障碍能力。
新增页面跳转事件上报接口。
支持应用及网络代理、应用证书管理。
支持同层渲染能力（仅限xcomponent、button等部分组件）。
组件支持DOM构建完成后执行提前被注入的JS脚本。
开放RegisterJavaScriptProxy、RunJavaScript能力的C API接口。
资源拦截特性支持设置为ArrayBuffer数据类型。

配套关系

表1 版本软件和工具配套关系

软件	版本	备注
OpenHarmony	4.1 Release	NA
Public SDK	Ohos_sdk_public 4.1.7.5 (API Version 11 Release)	面向应用开发者提供，不包含需要使用系统权限的系统接口。
HUAWEI DevEco Studio（可选）	4.1 Release	OpenHarmony应用开发推荐使用。
HUAWEI DevEco Device Tool（可选）	4.1 Release	OpenHarmony智能设备集成开发环境推荐使用。

源码获取

前提条件

注册码云gitee帐号。
注册码云SSH公钥，请参考码云帮助中心。

安装git客户端和git-lfs并配置用户信息。

git config --global user.name "yourname"
git config --global user.email "your-email-address"
git config --global credential.helper store

安装码云repo工具，可以执行如下命令。

curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo  #如果没有权限，可下载至其他目录，并将其配置到环境变量中chmod a+x /usr/local/bin/repo
pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests

通过repo获取

方式一（推荐）

通过repo + ssh 下载（需注册公钥，请参考码云帮助中心）。

从版本分支获取源码。可获取该版本分支的最新源码，包括版本发布后在该分支的合入。

repo init -u git@gitee.com:openharmony/manifest.git -b OpenHarmony-4.1-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

从版本发布Tag节点获取源码。可获取与版本发布时完全一致的源码。

repo init -u git@gitee.com:openharmony/manifest.git -b refs/tags/OpenHarmony-v4.1-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

方式二

通过repo + https 下载。

从版本分支获取源码。可获取该版本分支的最新源码，包括版本发布后在该分支的合入。

repo init -u https://gitee.com/openharmony/manifest -b OpenHarmony-4.1-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

从版本发布Tag节点获取源码。可获取与版本发布时完全一致的源码。

repo init -u https://gitee.com/openharmony/manifest -b refs/tags/OpenHarmony-v4.1-Release --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'

从镜像站点获取

表2 获取源码路径

版本源码	版本信息	下载站点	SHA256校验码	软件包容量
全量代码（标准、轻量和小型系统）	4.1 Release	站点	SHA256校验码	31.6 GB
Hi3861解决方案（二进制）	4.1 Release	站点	SHA256校验码	29.2 MB
Hi3516解决方案-LiteOS（二进制）	4.1 Release	站点	SHA256校验码	318.7 MB
Hi3516解决方案-Linux（二进制）	4.1 Release	站点	SHA256校验码	215.8 MB
RK3568标准系统解决方案（二进制）	4.1 Release	站点	SHA256校验码	8.4 GB
标准系统Public SDK包（Mac）	4.1.7.5	站点	SHA256校验码	841 MB
标准系统Public SDK包（Mac-M1）	4.1.7.5	站点	SHA256校验码	897.8 MB
标准系统Public SDK包（Windows/Linux）	4.1.7.5	站点	SHA256校验码	2.2 GB

更新说明

本版本在OpenHarmony 4.1 Beta1的基础上有如下变更。

芯片及开发板适配

芯片及开发板适配状态请参考SIG-Devboard信息。

Samples

请访问Samples仓了解更多信息。

修复缺陷列表

表4 修复缺陷ISSUE列表

ISSUE单	问题描述
I8PEOF	进程com.ohos.mms有一定概率出现因为LIFECYCLE_TIMEOUT导致的sysfreeze问题。
I8QET3	进程bluetooth_servi下的OS_IPC_10_25363线程有一定概率出现因libbluetooth_server.z.so导致的cppcrash。
I8QH9S	进程com.ohos.settingsdata下的os.settingsdata线程小概率出现因libnative_appdatafwk.z.so导致的cppcrash。
I8QNI7	进程foundation由于SERVICE_BLOCK小概率出现因netsysnative导致的sysfreeze。
I8QSZ1	进程com.ohos.systemui有一定概率出现由于THREAD_BLOCK_6S卡在libsamgr_proxy.z.so导致的appfreeze。
I7TYTF等43个开源组件漏洞	内核errseq_set函数protection_fault 等43个开源组件漏洞。
I78THF	RK3568 kernel patch中的maligpu版本过旧（11.29），存在大量未修复CVE漏洞。
I83D6I	进入设置反复打开关闭蓝牙，有一定概率会导致设置出现appfreeze。
I827LU	进入设置反复打开关闭蓝牙开关会出现内存泄漏，经测试一个小时泄露15MB。
I82V2W	进入设置反复打开关闭蓝牙开关出现内存泄漏，经测试“设置”一个小时内存涨幅到180M。

遗留缺陷列表

表5 遗留缺陷列表

ISSUE	问题描述	影响	计划解决日期
I8WP8M	移动桌面一个图标使之与另一图标重叠创建大文件夹，之后选中文件夹内的一个应用移出文件夹，重复此操作，launcher出现内存泄露，操作五分钟，内存泄漏约25M，操作一次泄露约673.68KB。	泄漏达到一定程度后造成系统卡顿。<br/>规避措施：清理后台应用或重启可释放。	4月30日
I98AV0	点击设置里的位置信息开关，重复此操作，distributeddata进程出现内存泄露，操作五分钟，泄露约14M，操作一次泄露约95.57KB。	泄漏达到一定程度后造成系统卡顿。<br/>规避措施：退出当前界面内存可释放。	4月30日
I9A9NO	不停执行点击短信界面右上角新建短信和返回操作，5分钟短信应用内存上涨约50M，操作一次泄露约341.33KB。	泄漏达到一定程度后造成系统卡顿。<br/>规避措施：退出应用内存可释放。	4月30日
I8QLRO	小概率在进程bluetooth_servi下的Stack线程出现cppcrash，崩溃栈：libbtstack.z.so。	蓝牙服务出现异常后服务自动恢复，用户无异常感知。	4月30日
I8TLYJ	小概率在进程bluetooth_servi下的SaInit1线程出现cppcrash，崩溃栈：libbtstack.z.so。	蓝牙服务出现异常后服务自动恢复，用户无异常感知。	4月30日
I8TM99	小概率在进程softbus_server下的softbus_server线程出现cppcrash，崩溃栈：libbtframework.z.so。	软总线服务出现异常后服务自动恢复，用户无异常感知。	4月30日
I8VFJS	小概率在进程com.ohos.settings下出现jscrash，栈名：ObservedPropertyAbstractPU。	settings应用小概率出现闪退，退出应用内存可释放。	4月30日
I98NGO	小概率下进程com.ohos.settings由于THREAD_BLOCK_6S卡在libbtframework.z.so发生appfreeze。	settings应用小概率出现闪退，退出应用内存可释放。	4月30日
I90A2N	一定概率下，进程com.ohos.systemui由于THREAD_BLOCK_6S卡在libeventhandler.z.so出现appfreeze。	点击或滑动无响应，重新进入控制中心或通知中心可恢复。	5月30日
I963UO	一定概率下，进程com.ohos.systemui下的RSRenderThread线程导致libEGL.so出现cppcrash。	系统会自动进入锁屏界面，重新解锁可恢复。	5月30日
I9A089	中等概率下进程foundation由于SERVICE_BLOCK出现sysfreeze。	卡顿5秒后会播放1秒开机动画，然后进入锁屏。此时重新解锁可恢复。	4月15日
I9AYM2	小概率下进程com.ohos.note由于THREAD_BLOCK_6S卡在libweb_engine.so出现appfreeze。	备忘录应用界面卡顿。重启备忘录应用可恢复。	5月30日
I9CGOZ	有较高概率，进程com.ohos.camera由于THREAD_BLOCK_6S卡在libcamera_framework.z.so出现appfreeze。	相机应用拍照/预览无响应，重新打开相机应用可恢复。	4月30日
I9AEO0	小概率在进程com.ohos.settings出现APP_INPUT_BLOCK的appfreeze。	settings应用无响应，重启应用可恢复。	4月30日
I8QH9S	小概率在进程com.ohos.settingsdata下的os.settingsdata线程出现cppcrash，崩溃栈：libnative_appdatafwk.z.so。	settingsdata服务崩溃，再次访问数据时会自行启动。对用户无影响。	4月15日
I963TL	小概率因进程com.ohos.mms下的com.ohos.mms线程导致libark_jsruntime.so出现cppcrash。	短信应用无响应或自动退出，重启应用可恢复。	4月30日
I9635I	设备极小概率自动重启。	影响可控，无需规避。	4月30日
I96JJ7	小概率在进程com.ohos.note下的com.ohos.note线程出现cppcrash，崩溃栈：libace_compatible.z.so。	使用备忘录应用时可能出现闪退，重启应用可恢复。	4月30日
I993H9	一定概率下进程com.ohos.smartperf由于THREAD_BLOCK_6S卡在libglobal_resmgr.z.so出现appfreeze。	用户在使用smartperf应用测试其他应用性能数据时，触发查看实时性能数据功能时，应用有卡顿。<br/>规避措施：系统会自动清理掉应用进程，重启smartperf可恢复。	4月30日
I97U6G	小概率下进程com.ohos.certmanager由于THREAD_BLOCK_6S卡在librender_service_client.z.so出现appfreeze。	证书管理应用Freeze后系统自动退出该应用。影响可控。	4月30日
I98KIG	小概率下进程com.ohos.camera由于THREAD_BLOCK_6S卡在libcamera_framework.z.so出现appfreeze。	点击相机应用后出现卡顿。退出应用，清理内存后重新打开相机可恢复。	4月15日
I98NFR	小概率在进程com.ohos.smartperf下的ohos.smartperf线程出现cppcrash，崩溃栈：libwm.z.so。	会有很低概率导致应用退出，退出后重启应用可恢复。	4月30日
I98AWP	小概率在进程com.ohos.note下的com.ohos.note线程出现cppcrash，崩溃栈：libweb_engine.so。	备忘录可能出现闪退。重启应用可恢复。	4月30日
I96ZWB	设备组网后查不到对端设备。	OpenHarmony 4.0设备和4.1设备使用分布式音频无法兼容和互通。影响可控。	5月30日
I96CJL	轻量级设备之间组网失败。	影响可控，暂无规避措施。	5月30日

分类

OpenHarmony

标签