diff --git a/zh-cn/release-notes/OpenHarmony-v3.1-release.md b/zh-cn/release-notes/OpenHarmony-v3.1-release.md index d3b0e103634fabbb46dfd6b155b84359779e5c1a..3a8ac6ca613ccaa2eb453d37b21f3fa6ec300ea6 100755 --- a/zh-cn/release-notes/OpenHarmony-v3.1-release.md +++ b/zh-cn/release-notes/OpenHarmony-v3.1-release.md @@ -58,10 +58,13 @@ ArkUI自定义绘制能力和Lottie动画能力、键盘、鼠标交互操作能 | 软件 | 版本 | 备注 | | -------- | -------- | -------- | -| OpenHarmony | 3.1 Release | NA | -| SDK | Ohos_sdk 3.1 Release  （API Version 8 ） | NA | -| HUAWEI DevEco Studio（可选） | 3.0 Beta3 for OpenHarmony | OpenHarmony应用开发推荐使用 | -| HUAWEI DevEco Device Tool（可选） | 3.0 Release | OpenHarmony智能设备集成开发环境推荐使用 | +| OpenHarmony | 3.1 Release | NA | +| SDK | Ohos_sdk 3.1 Release (API Version 8 Release)
Ohos_sdk 3.2 Canary (API Version 9 Canary) | NA | +| HUAWEI DevEco Studio（可选） | 3.0 Beta3 for OpenHarmony | OpenHarmony应用开发推荐使用 | +| HUAWEI DevEco Device Tool（可选） | 3.0 Release | OpenHarmony智能设备集成开发环境推荐使用 | + +>说明： Canary版本为面向特定开发者发布的早期预览版本，不承诺API稳定性。 + ## 源码获取 @@ -127,6 +130,7 @@ repo forall -c 'git lfs pull' | Hi3516轻量系统解决方案-Linux（二进制） | 3.1 Release | [站点](https://repo.huaweicloud.com/harmonyos/os/3.1-Release/hispark_taurus_linux.tar.gz) | [SHA256校验码](https://repo.huaweicloud.com/harmonyos/os/3.1-Release/hispark_taurus_linux.tar.gz.sha256) | | 标准系统SDK包（Mac） | 3.1 Release | [站点](https://repo.huaweicloud.com/harmonyos/os/3.1-Release/ohos-sdk-mac.tar.gz) | [SHA256校验码](https://repo.huaweicloud.com/harmonyos/os/3.1-Release/ohos-sdk-mac.tar.gz.sha256) | | 标准系统SDK包（Windows\Linux） | 3.1 Release | [站点](https://repo.huaweicloud.com/harmonyos/os/3.1-Release/ohos-sdk.tar.gz) | [SHA256校验码](https://repo.huaweicloud.com/harmonyos/os/3.1-Release/ohos-sdk.tar.gz.sha256) | +| 标准系统SDK包 | 3.2 Canary | 仅支持通过HUAWEI DevEco Studio加载 | NA | | 编译工具链获取清单 | - | [站点](https://repo.huaweicloud.com/harmonyos/os/2.0/tool_chain/) | - | @@ -150,25 +154,25 @@ repo forall -c 'git lfs pull' | 电源子系统 | 对于标准系统：
新增电源管理、电池管理、热管理、耗电统计的基本功能支持。
主要涉及如下需求：
I40IRO 【电源管理】支持休眠和混合睡眠模式
I412F4 【电源管理】支持省电模式
I4MBRL 【电源管理】支持显示相关的能耗调节
I4MBRM 【电源管理】支持接近光控制锁，通话时通过接近光控制亮灭屏的特性
I4OEOZ 【电源管理】监控输入亮屏输入事件，并根据输入事件进行亮、灭屏
I4OEQT 【电源管理】不亮屏检测
I4QGI0 【电源管理】长按power Key弹出关机界面
I410YD 【电池管理】支持关机充电特性
I410Y1 【电池管理】电池温度异常关机保护
I4GY9U 【热管理】支持内核温控服务
I4GYAF 【热管理】支持用户层和服务温控服务
I4GYBV 【热管理】提供温升监控接口
I4GYCD 【耗电统计】支持软件耗电统计
I4GYCN 【耗电统计】支持硬件耗电统计
I4GYDQ 【耗电统计】支持耗电详情记录 | NA | | 帐号子系统 | - 新增支持本地帐号（也称为系统帐号）的生命周期管理功能，包括本地帐号的创建、切换、删除、订阅、查询、修改等功能
- 新增分布式帐号ID派生和状态管理功能，在分布式帐号登录时派生唯一的帐号ID并将其与当前本地帐号唯一绑定，在分布式帐号登出或token失效时解除与本地帐号的绑定关系。
- 新增域帐号与本地帐号绑定功能，根据传入的域帐号信息自动创建本地帐号并与其唯一绑定。
- 新增本地帐号辅助管理工具：acm命令，可通过acm create/delete/switch/dump等命令对本地帐号进行增删改查，通过acm --help查看对应指令说明。
I4JBFB 支持分布式组网帐号状态管理
I4JBEK 支持分布式组网帐号ID的派生
I4IU6N 支持本地多用户基础信息管理
I4IU5W 支持os_account_standard部件本地多用户生命周期管理需求
I4IU5G 支持本地多用户辅助管理工具
I4IU3V 支持域帐户和本地用户关联
I4IU3B 支持本地多用户启动、停止、切换动作
I4IU33 支持本地多用户功能设置与内容修改 | NA | | 内核子系统 | - 新增内存管理功能增强特性，提高内存使用效率，包括CMA复用、内存共享接口，增强swap等。
- 新增进程调度功能增强特性，提高cpu资源的使用效率，增强滑动场景的资源供给，包括cpu热插拔及轻量级隔离，绘帧线程优先供给机制等。
- 支持最新的内核安全漏洞补丁修复，及其他安全增强机制，如支持tokenid配置及查询等。
主要涉及如下需求：
I4MBTN【新增特性】支持CMA复用特性
I4MBTO【新增特性】支持内存占用分类查询
I4LKQ0【新增特性】cpuset与cpu热插拔解耦
I4QE9K【新增特性】提供内核态驱动与用户态之间、用户态与用户态之间的内核共享能力
I4LRGQ【新增特性】OpenHarmony内核基线使能
I4RXQ3【新增特性】内存管理基础特性
I4TEGS【新增特性】F2FS末端性能优化
I4SRVK【新增特性】支持CPU轻量级隔离特性
I4SE2N【新增特性】支持按照用户维度进行内存资源管控的能力
I4VMGZ【新增特性】支持基础FPS智能感知调度功能
I4U089【新增特性】内核调度支持绘帧线程优先供给机制
I4OWTZ【外部依赖】内核实现进程的tokenID设置 | NA | -| 包管理子系统 | - 新增对多HAP安装、隐式查询、多用户、权限管理的基本功能支持。
- 新增DBMS、跨设备同步等分布式能力的支持
- 新增zlib Native SDK支持
主要涉及如下需求：
I4MBSD【新增特性】支持多hap包安装
I4MBSG【增强特性】安装包信息查询
I4PKY7【新增特性】跨设备信息同步
I4PKY8【新增特性】跨设备信息查询
I4PKYK【增强特性】启动扫描
I4PKYI【新增特性】提供清除数据的能力
I4PKYM【新增特性】支持多用户创建
I4QA3D【增强特性】新增zlib解压、压缩数据native接口
I4SIH9【新增特性】应用申请权限管理 | NA | +| 包管理子系统 | - 新增对多HAP安装、隐式查询、多用户、权限管理的基本功能支持。
- 新增DBMS、跨设备同步等分布式能力的支持
- 新增zlib Native SDK支持
主要涉及如下需求：
I4MBSD【新增特性】支持多hap包安装
I4MBSG【增强特性】安装包信息查询
I4PKY7【新增特性】跨设备信息同步
I4PKY8【新增特性】跨设备信息查询
I4PKYK【增强特性】启动扫描
I4PKYI【新增特性】提供清除数据的能力
I4PKYM【新增特性】支持多用户创建
I4QA3D【增强特性】新增zlib解压、压缩数据native接口
I4SIH9【新增特性】应用申请权限管理
(Canary) I4PKYH 【新增特性】支持对Extension的查询
(Canary) I4PKYD 【新增特性】安装能力适配config.json调整
(Canary) I4PKYB 【增强特性】schema适配配置文件重构 | NA | | 位置服务子系统 | - 新增位置服务子系统，提供位置服务框架能力。
- 位置服务框架支持GNSS基本定位、GNSS围栏、GNSS Batching、网络定位能力、地理编码转换等能力框架服务。
主要涉及如下需求：
I4XXIH 【location_gnss】供GNSS性能提升的相关辅助信息请求和注入能力
I4XXIG 【location_gnss】提供GNSS硬件功耗统计以及功耗优化能力
I4XXIF【location_gnss】提供GNSS基本定位功能
I4XXIC【location_gnss】提供GNSS Batching的能力
I4XXIB【location_gnss】支持GNSS参数设置和信息上报功能
I4XXI8【location_locator】支持位置服务的安全管理能力
I4XXI7【location_locator】提供位置服务隐私的安全保障能力
I4XXI5【location_locator】支持管理多个定位请求，支持多应用同时请求定位
I4XXI4【location_locator】支持位置服务定位管理功能
I4XXI3【location_geofence】支持GNSS芯片相关的地理围栏功能
I4XXI0【location_geocode】支持经纬度和地址互相转换
I4XXHZ【location_network】支持网络定位能力
I4XXHW【location_gnss】支持GNSS辅助协议 | NA | | 基础通信子系统 | - 新增WiFi STA、AP、P2P相关基本能力以及JS API，优化了STA、AP、P2P基本能力的连接体验。
- 新增蓝牙BR、SPP、BLE相关的能力以及JS API。
主要涉及如下需求：
**WiFi**：
I4XXFG 【新增特性】支持WiFi功耗统计以及功耗优化能力
I4XXFF 【新增特性】提供WiFi P2P基本能力
I4XXFB【新增特性】支持P2P magiclink连接特性
I4XXF7【新增特性】支持SoftAP 5G及信道自动选择
I4MBRI 【新增特性】支持SoftAP基础特性
I4MBRH【新增特性】支持STA基础特性
**蓝牙**：
I4XXGC【bluetooth_standard】支持蓝牙BR/EDR的基本能力
I4XXFT【bluetooth_standard】提供A2DP profile相关能力以及JS API
I4XXFP【bluetooth_standard】支持蓝牙BLE相关的基本能力
I4XXFL【bluetooth_standard】支持蓝牙SPP能力，提供BR的数据传输能力
| NA | -| 元能力子系统 | - 新增卡片能力、Zidl工具支持C++服务端客户端代码自动生成、元能力测试框架、命令行工具能力增强。
- 新增多用户能力、任务栈重构、部件化解耦、应用常驻进程、应用异常检测增强、环境变化通知能力。
主要涉及如下需求：
I4PCM4 【新增特性】上下文提供应用/Hap包/组件信息查询能力
I4PCPP 【新增特性】上下文适配多用户
I4PCPV 【新增特性】提供指定用户启动组件的系统接口
I4PCQP 【新增特性】支持singleuser的运行模式
I4PCQU 【新增特性】启动初始化默认用户
I4PCGY 【增强特性】新增卡片开发基类
I4PCH9 【增强特性】通过配置文件配置服务卡片
I4PCLL 【新增特性】JS提供的应用级别上下文
I4PCLN 【新增特性】Abilty的状态恢复
I4PCP1 【新增特性】应用运行信息查询
I4PCPG 【增强特性】支持系统环境变化通知
I4PCR8 【增强特性】支持常驻进程开机启动
I4PCV4 【新增特性】支持任务切换
I4PCVZ 【新增特性】支持指定displayId启动Ability
I4PCW3 【增强特性】pendingwant机制支持跨设备启动通用组件
I4PCH4 【新增特性】卡片支持多用户
I4PCM1 【新增特性】提供ce/de级上下文
I4PCVN 【新增特性】支持任务快照获取和更新
I4PPW6 【增强特性】指定窗口模式启动组件
I4PC3R 【新增特性】提供卡片开发基础能力
I4PQ0M 【增强特性】上下文提供消息发送和监听能力
II4PQ13 【增强特性】上下文提供权限校验及权限申请接口
I4PQ1E 【增强特性】支持常驻进程异常恢复
I4PQ1O 【新增特性】支持NewWant
I4PCPI 【增强特性】支持系统环境查询
I4PCRL 【新增特性】测试框架整体功能
I4PCVU 【新增特性】通用组件call调用 | NA | +| 元能力子系统 | - 新增卡片能力、Zidl工具支持C++服务端客户端代码自动生成、元能力测试框架、命令行工具能力增强。
- 新增多用户能力、任务栈重构、部件化解耦、应用常驻进程、应用异常检测增强、环境变化通知能力。
主要涉及如下需求：
I4PCM4 【新增特性】上下文提供应用/Hap包/组件信息查询能力
I4PCPP 【新增特性】上下文适配多用户
I4PCPV 【新增特性】提供指定用户启动组件的系统接口
I4PCQP 【新增特性】支持singleuser的运行模式
I4PCQU 【新增特性】启动初始化默认用户
I4PCGY 【增强特性】新增卡片开发基类
I4PCH9 【增强特性】通过配置文件配置服务卡片
I4PCLL 【新增特性】JS提供的应用级别上下文
I4PCLN 【新增特性】Abilty的状态恢复
I4PCP1 【新增特性】应用运行信息查询
I4PCPG 【增强特性】支持系统环境变化通知
I4PCR8 【增强特性】支持常驻进程开机启动
I4PCV4 【新增特性】支持任务切换
I4PCVZ 【新增特性】支持指定displayId启动Ability
I4PCW3 【增强特性】pendingwant机制支持跨设备启动通用组件
I4PCH4 【新增特性】卡片支持多用户
I4PCM1 【新增特性】提供ce/de级上下文
I4PCVN 【新增特性】支持任务快照获取和更新
I4PPW6 【增强特性】指定窗口模式启动组件
I4PC3R 【新增特性】提供卡片开发基础能力
I4PQ0M 【增强特性】上下文提供消息发送和监听能力
II4PQ13 【增强特性】上下文提供权限校验及权限申请接口
I4PQ1E 【增强特性】支持常驻进程异常恢复
I4PQ1O 【新增特性】支持NewWant
I4PCPI 【增强特性】支持系统环境查询
I4PCRL 【新增特性】测试框架整体功能
I4PCVU 【新增特性】通用组件call调用
(Canary) I4QU0P【新增特性】延迟任务调度
(Canary) I4PCRL【新增特性】测试框架整体功能
(Canary) I4PCLL【新增特性】JS提供的应用级别上下文
(Canary) I4PC3R【新增特性】提供卡片开发基础能力
(Canary) I4PCS0【新增特性】提供Ability启动停止方法
(Canary) I4PCRQ【新增特性】提供调度组件生命周期相关的功能
(Canary) I4WVBL【增强特性】【AMS】支持跨设备任务迁移
(Canary) I4PCP1【新增特性】应用运行信息查询
(Canary) I4PCPI【增强特性】支持系统环境查询
(Canary) I4PCPG【增强特性】支持系统环境变化通知
(Canary) I4PQ0K【增强特性】扩展Extension独立进程运行
(Canary) I4PPW6【增强特性】指定窗口模式启动组件
(Canary) I4PCVZ【新增特性】支持指定displayId启动Ability
(Canary) I4U457【增强特性】Uri权限校验接口
(Canary) I4S8X4【增强特性】Uri权限动态授权
(Canary) I4VUXP 支持wantAgent获取操作类型 | NA | | 无障碍软件服务子系统 | - 新增界面信息交换机制内部实现；
- 新增无障碍配置信息读取。
主要涉及如下需求：
I4X2EM【新增特性 信息交换机制】按键拦截
I4X2EN【新增特性 信息交换机制】支持上报窗口节点信息
I4X2ET【新增特性 信息交换机制】支持控件节点信息上报
I4X2EV【新增特性 信息交换机制】焦点查询
I4X2EY【新增特性 信息交换机制】无障碍事件列表
I4X2EZ【新增特性 信息交换机制】无障碍事件信息
I4X2F0【新增特性 信息交换机制】无障碍动作发起
I4X2F1【新增特性 信息交换机制】辅助应用列表查询
I4X2F2【新增特性 信息交换机制】辅助应用状态查询与监听
I4X2F3【新增特性 信息交换机制】手势模拟
I4X2F4【新增特性 信息交换机制】触摸拦截
I4X2EO【新增特性 无障碍服务管理】目标应用连接
I4X2EP【新增特性 无障碍服务管理】辅助应用连接
I4X2ER【新增特性 无障碍服务管理】辅助应用更新
I4X2ES【新增特性 无障碍服务管理】无障碍字幕配置 | NA | -| 媒体子系统 | - 新增支持本地基础音视频播放能力，支持视频硬编解码，支持主流音视频codec与封装格式，并易于生态厂商扩展。
- 新增支持相机基础预览、拍摄能力，及分布式相机能力。
主要涉及如下需求：
I4WYPP【audio_standard部件】支持蓝牙音频播放
I4WYK8【audio_standard部件】支持Opensles基础播放接口
I4WYW4【增强特性】支持相机会话管理
I4WYVE【增强特性】支持基础拍照模式下的拍照功能
I4WZ8G【新增特性】图片基础解码框架
I4X5E1【新增特性】支持视频软解功能
I4X552【新增特性】支持本地音视频播放
I4X5Q9【新增特性】分布式媒体库-缩略图同步
I4X5L5【新增特性】基础媒体数据库 | NA | +| 媒体子系统 | - 新增支持本地基础音视频播放能力，支持视频硬编解码，支持主流音视频codec与封装格式，并易于生态厂商扩展。
- 新增支持相机基础预览、拍摄能力，及分布式相机能力。
主要涉及如下需求：
I4WYPP【audio_standard部件】支持蓝牙音频播放
I4WYK8【audio_standard部件】支持Opensles基础播放接口
I4WYW4【增强特性】支持相机会话管理
I4WYVE【增强特性】支持基础拍照模式下的拍照功能
I4WZ8G【新增特性】图片基础解码框架
I4X5E1【新增特性】支持视频软解功能
I4X552【新增特性】支持本地音视频播放
I4X5Q9【新增特性】分布式媒体库-缩略图同步
I4X5L5【新增特性】基础媒体数据库
(Canary) I4WYOP 【audio_standard部件】音频焦点管理增强
(Canary) I4WZBF 【新增特性】图片接收器
(Canary) I4WYXI 【增强特性】支持相机会话管理
(Canary) I4WYVE 【增强特性】支持基础拍照模式下的拍照功能
(Canary) I4WYSW 【增强特性】支持基础拍照模式下的预览功能
(Canary) I4X59J 【新增特性】支持视频录制 | NA | | 图形子系统 | - 构建了图形RenderService新渲染框架。
- 提供了2D/3D绘制能力支持。
- 支持新的动画框架。
主要涉及如下需求：
I4MBTY【render_service部件】【新增特性】新增UI框架渲染后端特性
I4RKT3【composer部件】提供合成和送显的能力
I4ZCGG【drawing部件】提供图形Native SDK能力
I4RKSW【drawing部件】提供3D 图形能力支持Native SDK能力
I4MBTW【animation部件】提供基础动画框架 | NA | -| 窗口子系统 | - 构建了窗口管理新框架，提供更加灵活的窗口框架能力，支持全屏、分屏、窗口化形态，支持跨窗口拖拽能力。
- 提供了display管理能力，支持分屏，并增强亮灭屏管理能力。
主要涉及如下需求：
I4R308【增强特性】：提供应用窗口创建管理能力，单个应用的多个Ability实例可以创建多个主窗口
I4R309【增强特性】：提供应用窗口创建管理能力，支持启动窗口时设定窗口显示策略；提供窗口显示策略状态给应用（分屏、全屏、自由窗口）
I4R30D【新增特性】：应用主窗口支持自由窗口显示，平铺和层叠布局
I4R9P0【新增规格】：增强特性：
1. 提供Display管理能力
2. 提供通过物理屏幕插入拔出创建和销毁Display的能力
3. 提供多Display映射管理能力
I4ZEKH【新增特性】：支持亮屏灭屏流程：
1. 支持从电源管理发起的休眠、唤醒、亮屏、灭屏请求
2. 支持收到请求后调用Render Server接口实现对对应的亮屏、灭屏、调整屏幕亮度操作 | NA | +| 窗口子系统 | - 构建了窗口管理新框架，提供更加灵活的窗口框架能力，支持全屏、分屏、窗口化形态，支持跨窗口拖拽能力。
- 提供了display管理能力，支持分屏，并增强亮灭屏管理能力。
主要涉及如下需求：
I4R308【增强特性】：提供应用窗口创建管理能力，单个应用的多个Ability实例可以创建多个主窗口
I4R309【增强特性】：提供应用窗口创建管理能力，支持启动窗口时设定窗口显示策略；提供窗口显示策略状态给应用（分屏、全屏、自由窗口）
I4R30D【新增特性】：应用主窗口支持自由窗口显示，平铺和层叠布局
I4R9P0【新增规格】：增强特性：
1. 提供Display管理能力
2. 提供通过物理屏幕插入拔出创建和销毁Display的能力
3. 提供多Display映射管理能力
I4ZEKH【新增特性】：支持亮屏灭屏流程：
1. 支持从电源管理发起的休眠、唤醒、亮屏、灭屏请求
2. 支持收到请求后调用Render Server接口实现对对应的亮屏、灭屏、调整屏幕亮度操作
(Canary) I4R30B 【新增规格】增强特性：提供应用窗口创建管理能力 | NA | | 网络管理子系统 | I4XXHU【增强特性】支持TCP/UDP Socket
I4XXHT【增强特性】支持http 1.1/https/http2
I4XXHS【增强特性】支持对Wi-Fi/蜂窝网络连接的管理和切换
I4XXHP【增强特性】支持DNS解析和配置
I4XXHN【增强特性】支持网络连接状态查询和网络连接状态变化通知
I4XXHH【wpa_supplicant】提供基于NL80211的wpa、p2p能力
I4XXHG【wpa_supplicant】提供magiclink能力 | NA | | MSDP子系统 | I4WWRO【msdp】device_status部件标准化 | NA | | 全球化子系统 | - 新增支持语言区域选择。
- 新增/增强支持国际化特性（单复数、字符串排序、电话号码处理、日历&本地历法、度量衡体系和格式化、时间段格式化、字母表检索、unicode字符属性、断词断行）。
- 新增支持系统资源。
- 新增支持rawfile资源。
主要涉及如下需求：
I4MBR0 【增强特性】区域表示和属性
I4MBR1 【增强特性】单复数支持
I4MBR2 【增强特性】字符串排序
I4MBR3 【增强特性】电话号码处理
I4MBR7 【新增特性】日历&本地历法
I4MBR5 【新增特性】度量衡体系和格式化
I4MBQZ 【增强特性】时间段格式化
I4MBR4 【新增特性】字母表检索
I4MBR8 【增强特性】unicode字符属性
I4MBR9 【增强特性】断词断行
I4MBRA 【新增特性】系统资源管理
I4MBRB 【新增特性】rawfile资源管理
I4R2YA 【新增特性】新增资源管理Native SDK接口 | NA | | 软总线子系统 | - 新增对网络切换组网能力的支持
- 新增对蓝牙能力的支持
- 新增对蓝牙文件传输能力的支持
- 新增对流传输能力的支持
- 新增对P2P连接能力的支持
- 支持基于P2P连接的文件和流传输的能力
主要涉及如下需求：
I4MBS0 【新增特性】【组网】软总线支持网络切换组网
I4XXEL 【增强特性】软总线支持蓝牙
I4XXEX 【传输】文件传输（蓝牙)
I4XXEO 【增强特性】【传输】文件传输增强（NSTACK组件能力）
I4XXEV 【新增特性】【传输】流传输增强（NSTACK组件能力增强）
I4XXEN 【新增特性】【组网】软总线组网支持P2P连接
I4XXEP 【新增特性】【连接】软总线支持P2P连接
I4XXES 【新增特性】【传输】软总线支持P2P文件传输
I4XXET 【新增特性】【传输】软总线支持P2P流传输 | NA | -| ArkUI子系统 | - 新增键盘、鼠标交互操作
- 新增声明式Web组件能力
- 新增声明式XComponent组件能力
- 新增声明式Canvas2D绘制能力与OffscreenCanvas离屏绘制能力
- 新增富文本显示能力
- 新增多种功能组件
- 增强多种组件自定义能力
- 增强调测能力
主要涉及如下需求：
I4MBV7 【新增规格】滚动条样式自定义能力
I4MBVO 【新增特性】Popup组件增加内容自定义规格
I4MBVP 【新增特性】Canvas绘制能力支持
I4MBVR 【新增特性】触摸响应热区设置
I4MBVS 【新增特性】Lottie动画支持
I4MBVU 【新增特性】Menu组件增加内容自定义规格
I4MBVV 【新增特性】Swipe手势特性
I4MBV9 【新增规格】Tabs组件新增TabBar内容自定义规格
I4MBVA 【新增规格】Navigation组件新增标题栏设置规格
I4MBVC 【新增规格】工具栏组件增加内容自定义能力规格
I4WTQY 【新增特性】线性占比显示控件特性支持
I4MBV3 【新增规格】样式设置特性增加组件多态样式设置规格
I4MBV5 【新增规格】字母索引条组件增加提示菜单内容扩展规格
I4WTQ2 【新增规格】List组件增加内容拖拽能力规格
I4WTQ4 【新增规格】Grid组件增加内容拖拽能力规格
I4WYNA 【新增规格】Dialog弹窗组件特性增强：支持自定义位置弹窗
I4WTQX 【新增特性】图案密码组件特性支持
I4QC4N 【新增规格】Select组件支持
I4QC4O 【新增规格】TextInput组件能力增强
I4WTPY 【新增规格】文本组件支持鼠标拖拽选择文字规格
I4WTRS 【新增特性】XComponent组件特性支持声明式范式规格
I4WTR9 【新增特性】鼠标按键、滚轮事件支持
I4WTQI 【新增规格】拖拽能力增加鼠标拖拽规格
I4RCRC 【新增特性】样式状态编译转换支持
I4WTPS 【新增规格】新增Touch事件支持多点触控信息
I4RCRF 【新增特性】新增自定义组件支持访问子组件数据
I4X27K 【新增特性】新增侧边栏组件
I4RA0G 【新增规格】卡片支持鼠标悬停事件
I4WTQV 【新增特性】增加场景数据存储特性
I4RCRK 【DFX】ArkUI 框架超时检测机制
I4RCJ8 【IDE工具支持】渲染流水线耗时打印
I4RCRM 【IDE工具支持】交互事件回调耗时打印
I4WTR7 【新增特性】Web组件能力支持
I4WTRA 【新增特性】路由信息分布式迁移支持
I4X29K 【新增特性】ContextMenu组件支持
I4WTQJ 【新增规格】输入组件键盘快捷键支持
I4WTQK 【新增特性】鼠标双击选字
I4WTPG 【新增规格】基础动画参数配置增强
I4X26M 【新增规格】列表容器支持鼠标框选和键盘鼠标组合键多选功能
I4X26Y 【新增规格】网格容器支持鼠标框选和键盘鼠标组合键多选功能
I4WTR8 【新增特性】焦点设置支持
I4U5XM 【新增规格】ArkUI Loader支持JS文件条件编译能力
I4WTQN 【新增特性】新增RichText标签 | NA | +| ArkUI子系统 | - 新增键盘、鼠标交互操作
- 新增声明式Web组件能力
- 新增声明式XComponent组件能力
- 新增声明式Canvas2D绘制能力与OffscreenCanvas离屏绘制能力
- 新增富文本显示能力
- 新增多种功能组件
- 增强多种组件自定义能力
- 增强调测能力
主要涉及如下需求：
I4MBV7 【新增规格】滚动条样式自定义能力
I4MBVO 【新增特性】Popup组件增加内容自定义规格
I4MBVP 【新增特性】Canvas绘制能力支持
I4MBVR 【新增特性】触摸响应热区设置
I4MBVS 【新增特性】Lottie动画支持
I4MBVU 【新增特性】Menu组件增加内容自定义规格
I4MBVV 【新增特性】Swipe手势特性
I4MBV9 【新增规格】Tabs组件新增TabBar内容自定义规格
I4MBVA 【新增规格】Navigation组件新增标题栏设置规格
I4MBVC 【新增规格】工具栏组件增加内容自定义能力规格
I4WTQY 【新增特性】线性占比显示控件特性支持
I4MBV3 【新增规格】样式设置特性增加组件多态样式设置规格
I4MBV5 【新增规格】字母索引条组件增加提示菜单内容扩展规格
I4WTQ2 【新增规格】List组件增加内容拖拽能力规格
I4WTQ4 【新增规格】Grid组件增加内容拖拽能力规格
I4WYNA 【新增规格】Dialog弹窗组件特性增强：支持自定义位置弹窗
I4WTQX 【新增特性】图案密码组件特性支持
I4QC4N 【新增规格】Select组件支持
I4QC4O 【新增规格】TextInput组件能力增强
I4WTPY 【新增规格】文本组件支持鼠标拖拽选择文字规格
I4WTRS 【新增特性】XComponent组件特性支持声明式范式规格
I4WTR9 【新增特性】鼠标按键、滚轮事件支持
I4WTQI 【新增规格】拖拽能力增加鼠标拖拽规格
I4RCRC 【新增特性】样式状态编译转换支持
I4WTPS 【新增规格】新增Touch事件支持多点触控信息
I4RCRF 【新增特性】新增自定义组件支持访问子组件数据
I4X27K 【新增特性】新增侧边栏组件
I4RA0G 【新增规格】卡片支持鼠标悬停事件
I4WTQV 【新增特性】增加场景数据存储特性
I4RCRK 【DFX】ArkUI 框架超时检测机制
I4RCJ8 【IDE工具支持】渲染流水线耗时打印
I4RCRM 【IDE工具支持】交互事件回调耗时打印
I4WTR7 【新增特性】Web组件能力支持
I4WTRA 【新增特性】路由信息分布式迁移支持
I4X29K 【新增特性】ContextMenu组件支持
I4WTQJ 【新增规格】输入组件键盘快捷键支持
I4WTQK 【新增特性】鼠标双击选字
I4WTPG 【新增规格】基础动画参数配置增强
I4X26M 【新增规格】列表容器支持鼠标框选和键盘鼠标组合键多选功能
I4X26Y 【新增规格】网格容器支持鼠标框选和键盘鼠标组合键多选功能
I4WTR8 【新增特性】焦点设置支持
I4U5XM 【新增规格】ArkUI Loader支持JS文件条件编译能力
I4WTQN 【新增特性】新增RichText标签
(Canary) I4WTQV 【新增特性】增加场景数据存储特性 | NA | | 程序访问控制子系统 | - 新增对本地应用权限的定义、管理、授权、查询、鉴权功能的支持。
- 新增对分布式权限的管理、查询、鉴权、同步功能的支持。
主要涉及如下需求：
I4WVMH 【新增规格】系统的应用权限初始化预置定义
I4WVO9  【新增规格】应用权限申请列表查询
I4WVPH  【新增规格】AT同步服务基本框架
I4WVPV  【新增规格】本地权限校验接口和机制
I4WVQT  【新增规格】native的Token创建和更新机制
I4WVR3  【新增规格】应用权限的设置接口和机制
I4WVRG 【新增规格】AT管理服务基本框架
I4WVRR 【新增规格】Hap应用token查询接口
I4WVS6  【新增规格】Hap应用的Token信息删除机制
I4WVSI   【新增规格】Hap应用的Token创建和更新机制
I4TYDA  【新增规格】token信息跨设备同步
I4TYCV  【新增规格】设备上线时的native进程的token信息同步
I4V02K  【新增规格】主体设备上应用授权状态更新同步
I4V02Y  【新增规格】主体设备上应用卸载时同步
I4V032  【新增规格】应用权限管理界面实现
I4V038  【新增规格】实现通过应用权限管理界面设置应用权限
I4TYCK  【新增规格】分布式权限校验接口和机制
I4TYDO 【新增规格】设备下线时的token信息删除
I4SEZD  【新增规格】动态权限弹窗界面实现
I4SEZ7  【动态权限设置】实现动态权限授权机制 | NA | | 语言编译运行时子系统 | - 语言编译运行时：提供适应多端的基础JS工具链及运行时，端侧提供JS引擎支撑应用运行。
- TS/JS公共基础库：TS/JS公共基础类库提供基础功能及TS/JS多线程能力
- TS/JS/C/C++工具链：支持开发者开发调试调优的基本需求
- Lite Actor：轻量化Actor模型，共享字节码及虚拟机内部基础设施，优化目前JS引擎的实现，优化内存占用、提升启动性能。
- High Perf Partial GC：方舟GC支持并发标记、并行标记、懒清理，减少50%的GC停顿时间，改善用户体验。
  主要涉及如下需求：
  I4W7ZR【新增规格】内存管理分配回收功能/HPP GC性能调优
  I4P7F7【语言编译运行时，图形图像，DRF】Native SDK整体集成
  I4WWKK【增强特性】Actor轻量化1.0 | NA | | 升级服务子系统 | - 升级服务子系统各部件的标准化
- 支持syscap机制
主要涉及如下需求：
I4WXHW【部件化专项】升级服务子系统部件标准化
I4XXH6【SysCap】升级服务子系统支持SysCap机制 | NA | -| Misc软件服务子系统 | - 新增时间时区同步的支持管理能力的支持
- 新增对剪切板数据项进行进行查询、设置、删除、替换等能力的支持
- 新增对锁屏服务管理能力的支持
- 新增对静态壁纸管理能力的支持
- 新增对下载服务管理能力的支持
主要涉及如下需求：
I4U2WR 新增特性：时间时区同步管理
I4ZTTE【新增特性】剪贴板数据项-支持将剪贴板数据项强制转换为文本
I4ZTTO【新增特性】剪贴板数据-支持增加获取、删除、替换剪贴板数据中的数据项；支持查询与设置剪贴板数据属性
I4ZTTZ【新增特性】系统剪贴板-支持获取、清理、查询剪贴板的剪贴板数据；支持剪贴板内容变化通知
I4ZTZC【新增特性】锁屏管理服务-支撑多用户场景
I4ZTZT【新增特性】锁屏管理服务-支撑系统开机、亮灭屏场景
I4ZU1S【新增特性】静态壁纸
I4ZTXT【request部件】下载管理-支持新建、移除、修改、查询下载任务、支持暂停、恢复下载任务、支持监听下载任务进度、下载状态变更通知；下载管理服务，提供系统下载管理DataAbility，处理下载任务数据的持久化，提供系统下载管理服务，处理应用接口权限检查、执行http下载和处理下载异常 | NA | +| Misc软件服务子系统 | - 新增时间时区同步的支持管理能力的支持
- 新增对剪切板数据项进行进行查询、设置、删除、替换等能力的支持
- 新增对锁屏服务管理能力的支持
- 新增对静态壁纸管理能力的支持
- 新增对下载服务管理能力的支持
主要涉及如下需求：
I4U2WR 新增特性：时间时区同步管理
I4ZTTE【新增特性】剪贴板数据项-支持将剪贴板数据项强制转换为文本
I4ZTTO【新增特性】剪贴板数据-支持增加获取、删除、替换剪贴板数据中的数据项；支持查询与设置剪贴板数据属性
I4ZTTZ【新增特性】系统剪贴板-支持获取、清理、查询剪贴板的剪贴板数据；支持剪贴板内容变化通知
I4ZTZC【新增特性】锁屏管理服务-支撑多用户场景
I4ZTZT【新增特性】锁屏管理服务-支撑系统开机、亮灭屏场景
I4ZU1S【新增特性】静态壁纸
I4ZTXT【request部件】下载管理-支持新建、移除、修改、查询下载任务、支持暂停、恢复下载任务、支持监听下载任务进度、下载状态变更通知；下载管理服务，提供系统下载管理DataAbility，处理下载任务数据的持久化，提供系统下载管理服务，处理应用接口权限检查、执行http下载和处理下载异常
(Canary) I4ZTZC【新增特性】锁屏管理服务-支撑多用户场景
(Canary) I4ZTZT【新增特性】锁屏管理服务-支撑系统开机、亮灭屏场景 | NA | | 轻内核子系统 | NA | 对于轻量系统：
I4RD3H M核增加了signal、pipe、poll、select等POSIX接口
I4Q9OQ 支持Cortex-M55架构
I4Q9F2 支持动态加载机制
I4RD2M 内核部件化 | -| 文件管理子系统 | - 支持基础文件系统ext4/f2fs能力及相关工具，支持分布式文件系统跨设备文件访问能力。
- 支持设备存储管理功能，包括文件加密、空间管理与统计、多用户空间管理、外卡挂载管理等能力。
- 增强应用数据保护，建立应用沙箱隔离机制；优化用户数据管理，包括用户数据沙箱隔离安全性增强、用户文件访问框架与接口。
- 基础文件操作API能力补齐，包括statfs占用空间统计、文件访问异步接口等能力。
主要涉及如下需求：
I4RDNG【新增特性】【local_file_system】支持ext4/f2fs等用户态工具的能力
I4RFBD【新增特性】【local_file_system】支持fat/exfat/ntfs等可插拔文件系统能力
I4TTN8【新增特性】支持分布式文件系统的基础功能
I4TTNG【新增特性】支持数据分类设备分级，控制数据流转规格
I4TTGR【新增特性】【storage_manager部件】文件加密特性使能
I4TTHQ【新增特性】支持外部存储访问需求
I4TTJN【新增特性】支持外卡设备相关事件分发特性
I4TTJV【新增特性】支持卷信息查询和管理特性
I4XXIR【新增特性】响应多用户创建删除，进行用户目录创建和删除
I4XXIY【新增特性】支持应用占用空间统计特性
I4SNSU【新增特性】支持应用沙箱隔离能力
I4XXIX【新增特性】支持file picker需要的JS API文件接口需求
I4MBS2【新增特性】支持statfs API能力需求 | NA | +| 文件管理子系统 | - 支持基础文件系统ext4/f2fs能力及相关工具，支持分布式文件系统跨设备文件访问能力。
- 支持设备存储管理功能，包括文件加密、空间管理与统计、多用户空间管理、外卡挂载管理等能力。
- 增强应用数据保护，建立应用沙箱隔离机制；优化用户数据管理，包括用户数据沙箱隔离安全性增强、用户文件访问框架与接口。
- 基础文件操作API能力补齐，包括statfs占用空间统计、文件访问异步接口等能力。
主要涉及如下需求：
I4RDNG【新增特性】【local_file_system】支持ext4/f2fs等用户态工具的能力
I4RFBD【新增特性】【local_file_system】支持fat/exfat/ntfs等可插拔文件系统能力
I4TTN8【新增特性】支持分布式文件系统的基础功能
I4TTNG【新增特性】支持数据分类设备分级，控制数据流转规格
I4TTGR【新增特性】【storage_manager部件】文件加密特性使能
I4TTHQ【新增特性】支持外部存储访问需求
I4TTJN【新增特性】支持外卡设备相关事件分发特性
I4TTJV【新增特性】支持卷信息查询和管理特性
I4XXIR【新增特性】响应多用户创建删除，进行用户目录创建和删除
I4XXIY【新增特性】支持应用占用空间统计特性
I4SNSU【新增特性】支持应用沙箱隔离能力
I4XXIX【新增特性】支持file picker需要的JS API文件接口需求
I4MBS2【新增特性】支持statfs API能力需求
(Canary) I4XXIY 支持应用占用空间统计特性
(Canary) I4TTJV 支持卷信息查询和管理特性
(Canary) I4TTJN 支持外卡设备相关事件分发特性 | NA | | 事件通知子系统 | - 新增支持多用户。
- 新增支持分布式通知。
- 新增通知模板功能。
主要涉及如下需求：
I4PBOK 【新增特性】通知支持多用户
I4PBP7 【新增特性】支持应用发送模板通知（调试能力）
I4PBPE 【新增特性】支持进度条通知
I4PBPM 【增强特性】分布式通知支持流控
I4PBRM 【新增特性】支持其他设备的通知点击后在本设备跳转
I4PBRW 【新增特性】支持设备级的分布式通知使能控制
I4PBSE 【新增特性】支持通知管理应用设置和查询应用级的分布式通知使能
I4PBSP 【新增特性】支持应用设置分布式通知能力是否使能
I4PBT7 【新增特性】分布式通知同步
I4PBU3 【新增特性】分布式通知联动取消
I4PBUU 【新增规格】 支持通过config.json静态配置公共事件，支持通过wokscheduler静态拉起订阅者
I4PBV9 【新增规格】 支持静态订阅者管控
I4WTGK 【新增特性】支持模板通知注册、查询和发送
I4PBSZ 【新增特性】根据设备状态决策通知是否提醒
I4PBBV 【新增特性】事件耗时调用
I4PD0O 【特性增强】通知发送使能能力增强
I4PBQ1 【增强特性】分布式通知能力支持dump命令
I4PBR0 【新增特性】支持其他设备的通知点击后在跨设备跳转
I4PC2S 【新增特性】公共事件支持多用户特性 | NA | | 泛Sensor服务子系统 | - 新增常见传感器加速度、陀螺仪、霍尔等的数据上报。
- 新增马达振动的基本能力。
- 新增通用算法能力和地磁场算法能力。
主要涉及如下需求：
I4WWTG【miscdevice部件】Miscdevice支持周边依赖
I4WWTF【sensor部件】Sensor支持周边依赖
I4WWTD【sensor部件】支持通用的算法接口
I4MBRQ【sensor部件】地磁场水平强度、总强度
I4MBRP【sensor部件】地磁场偏角和倾角 | NA | | 分布式数据管理 | - 新增对分布式数据对象能力的支持，分布式能力覆盖内存JS对象；新增分布式关系型数据管理能力，支持直接基于关系型表数据同步
- 新增按条件数据同步&订阅能力，数据同步更精准
- 新增文件上传功能支持
- 构建数据加密和安全分级能力，完善数据流转过程的安全管控，支持多用户同步与隔离
主要涉及如下需求：
I4IBPH【distributed_kv_store】分布式数据服务缺失功能补齐
I4MBRS【distributed_kv_store】分布式数据库支持按谓词查询条件进行数据库记录的跨设备同步和订阅
I4MBRU【RDB】支持数据库加密
I4NZVP【distributed_kv_store】提供分布式数据库JS API
I4HAMI【data_share_ability】支持跨应用订阅数据库的变化
I4NZP6【RDB】增加多表查询能力
I4FZ6B【RDB】提供事务能力
I4HAMI 【data_share_ability】支持跨应用订阅数据库的变化
I4PNX7  【分布式RDB】数据存储需求
I4HAMD【data_share_ability】支持对数据访问方式的控制
I4H4FH 【distributed_kv_store】分布式数据库支持分类分级
I4H3M8【新增特性】分布式数据对象支持复杂类型
I4HAMD【data_share_ability】支持对数据访问方式的控制
I4PO00【分布式RDB】数据同步需求
I4OTW6【distributed_kv_store】分布式数据库Query支持InKeys谓词
I4RGFY【DataShare】基于ExtensionAbility新框架重构并提供单设备上跨应用数据共享能力
I4H4FR【distributed_kv_store】支持多用户数据隔离和共享
I4RGFY【DataShare】基于ExtensionAbility新框架重构并提供单设备上跨应用数据共享能力
I4XXGF【request部件】文件上传功能 | 对于轻量、小型系统：
分布式数据对象支持小型系统设备
主要涉及如下需求：
I4H3JJ分布式对象支持小型系统设备 | diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ability_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ability_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..82c68c5665774516bdfc3726a66626b8632ce0a1 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-ability_api-9-canary.md @@ -0,0 +1,197 @@ +# 元能力子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，元能力子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| AbilityContext | AbilityContext | restoreWindowStage(contentStorage: ContentStorage) : void; | 新增 | +| AbilityContext | AbilityContext | requestPermissionsFromUser(permissions: Array, requestCallback: AsyncCallback) : void;
requestPermissionsFromUser(permissions: Array) : Promise; | 新增 | +| AbilityContext | AbilityContext | setMissionLabel(label: string, callback:AsyncCallback): void;
setMissionLabel(label: string): Promise; | 新增 | +| AbilityContext | AbilityContext | disconnectAbility(connection: number, callback:AsyncCallback): void;
disconnectAbility(connection: number): Promise; | 新增 | +| AbilityContext | AbilityContext | connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number; | 新增 | +| AbilityContext | AbilityContext | connectAbility(want: Want, options: ConnectOptions): number; | 新增 | +| AbilityContext | AbilityContext | terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback): void;
terminateSelfWithResult(parameter: AbilityResult): Promise; | 新增 | +| AbilityContext | AbilityContext | terminateSelf(callback: AsyncCallback): void;
terminateSelf(): Promise; | 新增 | +| AbilityContext | AbilityContext | startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback): void;
startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void;
startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions): Promise; | 新增 | +| AbilityContext | AbilityContext | startAbilityForResult(want: Want, callback: AsyncCallback): void;
startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback): void;
startAbilityForResult(want: Want, options?: StartOptions): Promise; | 新增 | +| AbilityContext | AbilityContext | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void;
startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void;
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise; | 新增 | +| AbilityContext | AbilityContext | startAbilityByCall(want: Want): Promise; | 新增 | +| AbilityContext | AbilityContext | startAbility(want: Want, callback: AsyncCallback): void;
startAbility(want: Want, options: StartOptions, callback: AsyncCallback): void;
startAbility(want: Want, options?: StartOptions): Promise; | 新增 | +| AbilityContext | AbilityContext | config: Configuration; | 新增 | +| AbilityContext | AbilityContext | currentHapModuleInfo: HapModuleInfo; | 新增 | +| AbilityContext | AbilityContext | abilityInfo: AbilityInfo; | 新增 | +| abilityDelegator | AbilityDelegator | doAbilityBackground(ability: Ability, callback: AsyncCallback): void;
doAbilityBackground(ability: Ability): Promise; | 新增 | +| abilityDelegator | AbilityDelegator | doAbilityForeground(ability: Ability, callback: AsyncCallback): void;
doAbilityForeground(ability: Ability): Promise; | 新增 | +| abilityDelegator | AbilityDelegator | getCurrentTopAbility(callback: AsyncCallback): void;
getCurrentTopAbility(): Promise | 新增 | +| abilityDelegator | AbilityDelegator | getAbilityState(ability: Ability): number; | 新增 | +| abilityDelegator | AbilityDelegator | getAppContext(): Context; | 新增 | +| abilityDelegator | AbilityDelegator | waitAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback): void;
waitAbilityMonitor(monitor: AbilityMonitor, timeout: number, callback: AsyncCallback): void;
waitAbilityMonitor(monitor: AbilityMonitor, timeout?: number): Promise; | 新增 | +| abilityDelegator | AbilityDelegator | removeAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback): void;
removeAbilityMonitor(monitor: AbilityMonitor): Promise; | 新增 | +| abilityDelegator | AbilityDelegator | addAbilityMonitor(monitor: AbilityMonitor, callback: AsyncCallback): void;
addAbilityMonitor(monitor: AbilityMonitor): Promise; | 新增 | +| abilityMonitor | AbilityMonitor | onWindowStageDestroy?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | onWindowStageRestore?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | onWindowStageCreate?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | onAbilityDestroy?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | onAbilityBackground?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | onAbilityForeground?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | onAbilityCreate?:() => void; | 新增 | +| abilityMonitor | AbilityMonitor | abilityName: string; | 新增 | +| AbilityStageContext | AbilityStageContext | config: Configuration; | 新增 | +| AbilityStageContext | AbilityStageContext | currentHapModuleInfo: HapModuleInfo; | 新增 | +| context | AreaMode | EL2 = 1 | 新增 | +| context | AreaMode | EL1 = 0 | 新增 | +| context | Context | switchArea(mode: AreaMode): void; | 新增 | +| context | Context | createBundleContext(bundleName: string): Context; | 新增 | +| context | Context | eventHub: EventHub; | 新增 | +| context | Context | distributedFilesDir: string; | 新增 | +| context | Context | bundleCodeDir : string; | 新增 | +| context | Context | storageDir : string; | 新增 | +| context | Context | databaseDir : string; | 新增 | +| context | Context | filesDir : string; | 新增 | +| context | Context | tempDir: string; | 新增 | +| context | Context | cacheDir: string; | 新增 | +| context | Context | applicationInfo: ApplicationInfo; | 新增 | +| context | Context | resourceManager: resmgr.ResourceManager; | 新增 | +| EventHub | EventHub | emit(event: string, ...args: Object[]): void | 新增 | +| EventHub | EventHub | off(event: string, callback?: Function): void | 新增 | +| EventHub | EventHub | on(event: string, callback: Function): void | 新增 | +| ExtAbilityContext | ExtAbilityContext | currentHapModuleInfo: HapModuleInfo; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly writePermission: string; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly readPermission: string; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly enabled: boolean; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly metadata: Array; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly applicationInfo: ApplicationInfo; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly permissions: Array; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly extensionAbilityType: bundle.ExtensionAbilityType; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly isVisible: boolean; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly iconId: number; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly descriptionId: number; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly labelId: number; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly name: string; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly moduleName: string; | 新增 | +| extensionAbilityInfo | ExtensionAbilityInfo | readonly bundleName: string; | 新增 | +| ExtensionContext | ExtensionContext | config: Configuration; | 新增 | +| ExtensionContext | ExtensionContext | currentHapModuleInfo: HapModuleInfo; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | type: bundle.ExtensionAbilityType; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | clientPackage: Array; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | startTime: number; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | processName: string; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | uid: number; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | pid: number; | 新增 | +| ExtensionRunningInfo | ExtensionRunningInfo | extension: ElementName; | 新增 | +| FormExtensionContext | FormExtensionContext | updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback): void;
updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise; | 新增 | +| ohos.application.Ability | Ability | onConfigurationUpdated(config: Configuration): void; | 新增 | +| ohos.application.Ability | Ability | onNewWant(want: Want): void; | 新增 | +| ohos.application.Ability | Ability | onContinue(wantParam : {[key: string]: any}): AbilityConstant.OnContinueResult; | 新增 | +| ohos.application.Ability | Ability | onBackground(): void; | 新增 | +| ohos.application.Ability | Ability | onForeground(): void; | 新增 | +| ohos.application.Ability | Ability | onDestroy(): void; | 新增 | +| ohos.application.Ability | Ability | onWindowStageRestore(windowStage: window.WindowStage): void; | 新增 | +| ohos.application.Ability | Ability | onWindowStageDestroy(): void; | 新增 | +| ohos.application.Ability | Ability | onWindowStageCreate(windowStage: window.WindowStage): void; | 新增 | +| ohos.application.Ability | Ability | onCreate(want: Want, param: AbilityConstant.LaunchParam): void; | 新增 | +| ohos.application.Ability | Ability | callee: Callee; | 新增 | +| ohos.application.Ability | Ability | lastRequestWant: Want; | 新增 | +| ohos.application.Ability | Ability | launchWant: Want; | 新增 | +| ohos.application.Ability | Ability | context: AbilityContext; | 新增 | +| ohos.application.Ability | Callee | off(method: string): void; | 新增 | +| ohos.application.Ability | Callee | on(method: string, callback: function): void; | 新增 | +| ohos.application.Ability | Caller | onRelease(callback: function): void; | 新增 | +| ohos.application.Ability | Caller | release(): void; | 新增 | +| ohos.application.Ability | Caller | callWithResult(method: string, data: rpc.Sequenceable): Promise; | 新增 | +| ohos.application.Ability | Caller | call(method: string, data: rpc.Sequenceable): Promise; | 新增 | +| ohos.application.AbilityConstant | OnContinueResult | MISMATCH = 2 | 新增 | +| ohos.application.AbilityConstant | OnContinueResult | REJECT = 1 | 新增 | +| ohos.application.AbilityConstant | OnContinueResult | AGREE = 0 | 新增 | +| ohos.application.AbilityConstant | LastExitReason | NORMAL = 2 | 新增 | +| ohos.application.AbilityConstant | LastExitReason | ABILITY_NOT_RESPONDING = 1 | 新增 | +| ohos.application.AbilityConstant | LastExitReason | UNKNOWN = 0 | 新增 | +| ohos.application.AbilityConstant | LaunchReason | CONTINUATION = 3 | 新增 | +| ohos.application.AbilityConstant | LaunchReason | CALL = 2 | 新增 | +| ohos.application.AbilityConstant | LaunchReason | START_ABILITY = 1 | 新增 | +| ohos.application.AbilityConstant | LaunchReason | UNKNOWN = 0 | 新增 | +| ohos.application.AbilityConstant | LaunchParam | lastExitReason: LastExitReason; | 新增 | +| ohos.application.AbilityConstant | LaunchParam | launchReason: LaunchReason; | 新增 | +| ohos.application.abilityManager | abilityManager | function getExtensionRunningInfos(upperLimit: number): Promise>;
function getExtensionRunningInfos(upperLimit: number, callback: AsyncCallback>): void; | 新增 | +| ohos.application.AbilityStage | AbilityStage | onConfigurationUpdated(config: Configuration): void; | 新增 | +| ohos.application.AbilityStage | AbilityStage | onAcceptWant(want: Want): string; | 新增 | +| ohos.application.AbilityStage | AbilityStage | onCreate(): void; | 新增 | +| ohos.application.AbilityStage | AbilityStage | context: AbilityStageContext; | 新增 | +| ohos.application.Configuration | Configuration | displayId?: number; | 新增 | +| ohos.application.Configuration | Configuration | screenDensity?: ConfigurationConstant.ScreenDensity; | 新增 | +| ohos.application.Configuration | Configuration | direction?: ConfigurationConstant.Direction; | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_XXXLDPI = 640 | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_XXLDPI = 480 | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_XLDPI = 320 | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_LDPI = 240 | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_MDPI = 160 | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_SDPI = 120 | 新增 | +| ohos.application.ConfigurationConstant | ScreenDensity | SCREEN_DENSITY_NOT_SET = 0 | 新增 | +| ohos.application.ConfigurationConstant | Direction | DIRECTION_HORIZONTAL = 1 | 新增 | +| ohos.application.ConfigurationConstant | Direction | DIRECTION_VERTICAL = 0 | 新增 | +| ohos.application.ConfigurationConstant | Direction | DIRECTION_NOT_SET = -1 | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | denormalizeUri?(uri: string, callback: AsyncCallback): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | normalizeUri?(uri: string, callback: AsyncCallback): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | batchInsert?(uri: string, valueBuckets: Array, callback: AsyncCallback): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | getType?(uri: string, callback: AsyncCallback): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | "query?(uri: string, columns: Array, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void;" | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | delete?(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | "update?(uri: string, valueBucket: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void;" | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | insert?(uri: string, valueBucket: rdb.ValuesBucket, callback: AsyncCallback): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | getFileTypes?(uri: string, mimeTypeFilter: string, callback: AsyncCallback>): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | onCreate?(want: Want): void; | 新增 | +| ohos.application.DataShareExtensionAbility | DataShareExtensionAbility | context?: ExtensionContext; | 新增 | +| ohos.application.FormExtension | FormExtension | onConfigurationUpdated(config: Configuration): void; | 新增 | +| ohos.application.FormExtension | FormExtension | onDestroy(formId: string): void; | 新增 | +| ohos.application.FormExtension | FormExtension | onEvent(formId: string, message: string): void; | 新增 | +| ohos.application.FormExtension | FormExtension | onVisibilityChange(newStatus: { [key: string]: number }): void; | 新增 | +| ohos.application.FormExtension | FormExtension | onUpdate(formId: string): void; | 新增 | +| ohos.application.FormExtension | FormExtension | onCastToNormal(formId: string): void; | 新增 | +| ohos.application.FormExtension | FormExtension | onCreate(want: Want): formBindingData.FormBindingData; | 新增 | +| ohos.application.FormExtension | FormExtension | context: FormExtensionContext; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | onReconnect(want: Want): void; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | onDisconnect(want: Want): void; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | onConnect(want: Want): rpc.RemoteObject; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | onRequest(want: Want, startId: number): void; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | onDestroy(): void; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | onCreate(want: Want): void; | 新增 | +| ohos.application.ServiceExtAbility | ServiceExtAbility | context: ServiceExtAbilityContext; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onConfigurationUpdated(config: Configuration): void; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onReconnect(want: Want): void; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onDisconnect(want: Want): void; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onConnect(want: Want): rpc.RemoteObject; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onRequest(want: Want, startId: number): void; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onDestroy(): void; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | onCreate(want: Want): void; | 新增 | +| ohos.application.ServiceExtension | ServiceExtension | context: ServiceExtensionContext; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onConfigurationUpdated(config: Configuration): void; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onReconnect(want: Want): void; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onDisconnect(want: Want): void; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onConnect(want: Want): rpc.RemoteObject; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onRequest(want: Want, startId: number): void; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onDestroy(): void; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | onCreate(want: Want): void; | 新增 | +| ohos.application.ServiceExtensionAbility | ServiceExtensionAbility | context: ServiceExtensionContext; | 新增 | +| ohos.application.StartOptions | StartOptions | displayId?: number; | 新增 | +| ohos.application.StartOptions | StartOptions | windowMode?: number; | 新增 | +| ohos.application.uriPermissionManager | uriPermissionManager | function verifyUriPermission(uri: string, flag: wantConstant.Flags, accessTokenId: number, callback: AsyncCallback): void;
function verifyUriPermission(uri: string, flag: wantConstant.Flags, accessTokenId: number): Promise; | 新增 | +| ohos.wantAgent | wantAgent | function getOperationType(agent: WantAgent, callback: AsyncCallback): void;
function getOperationType(agent: WantAgent): Promise; | 新增 | +| PermissionRequestResult | PermissionRequestResult | authResults: Array; | 新增 | +| PermissionRequestResult | PermissionRequestResult | permissions: Array; | 新增 | +| ServiceExtAbilityContext | ServiceExtAbilityContext | disconnectAbility(connection: number, callback:AsyncCallback): void;
disconnectAbility(connection: number): Promise; | 新增 | +| ServiceExtAbilityContext | ServiceExtAbilityContext | connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number; | 新增 | +| ServiceExtAbilityContext | ServiceExtAbilityContext | connectAbility(want: Want, options: ConnectOptions): number; | 新增 | +| ServiceExtAbilityContext | ServiceExtAbilityContext | terminateSelf(callback: AsyncCallback): void;
terminateSelf(): Promise; | 新增 | +| ServiceExtAbilityContext | ServiceExtAbilityContext | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void;
startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void;
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise; | 新增 | +| ServiceExtAbilityContext | ServiceExtAbilityContext | startAbility(want: Want, callback: AsyncCallback): void;
startAbility(want: Want, options: StartOptions, callback: AsyncCallback): void;
startAbility(want: Want, options?: StartOptions): Promise; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | disconnectAbility(connection: number, callback:AsyncCallback): void;
disconnectAbility(connection: number): Promise; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | connectAbilityWithAccount(want: Want, accountId: number, options: ConnectOptions): number; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | connectAbility(want: Want, options: ConnectOptions): number; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | terminateSelf(callback: AsyncCallback): void;
terminateSelf(): Promise; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback): void;
startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback): void;
startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions): Promise; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | startAbility(want: Want, callback: AsyncCallback): void;
startAbility(want: Want, options: StartOptions, callback: AsyncCallback): void;
startAbility(want: Want, options?: StartOptions): Promise; | 新增 | +| ServiceExtensionContext | ServiceExtensionContext | extensionAbilityInfo: ExtensionAbilityInfo; | 新增 | +| want | Want | extensionAbilityType?: number; | 新增 | +| want | Want | extensionAbilityName?: string; | 新增 | diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-bundle_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-bundle_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..5bb6ee87638ff2d3c9a44d23f074927c251d68a2 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-bundle_api-9-canary.md @@ -0,0 +1,32 @@ +# 包管理子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，包管理子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| bundleInfo | BundleInfo | readonly extensionAbilityInfo: Array; | 新增 | +| hapModuleInfo | HapModuleInfo | readonly metadata: Array; | 新增 | +| hapModuleInfo | HapModuleInfo | readonly extensionAbilityInfo: Array; | 新增 | +| hapModuleInfo | HapModuleInfo | readonly mainElementName: string; | 新增 | +| metadata | Metadata | resource: string; | 新增 | +| metadata | Metadata | value: string; | 新增 | +| metadata | Metadata | name: string; | 新增 | +| ohos.bundle | bundle | function queryExtensionAbilityInfosByWant(want: Want, extensionFlags: number, userId: number, callback: AsyncCallback>): void;
function queryExtensionAbilityInfosByWant(want: Want, extensionFlags: number, callback: AsyncCallback>): void;
function queryExtensionAbilityInfosByWant(want: Want, extensionFlags: number, userId?: number): Promise>; | 新增 | +| ohos.bundle | ExtensionAbilityType | UNSPECIFIED = 9 | 新增 | +| ohos.bundle | ExtensionAbilityType | WALLPAPER = 8 | 新增 | +| ohos.bundle | ExtensionAbilityType | STATIC_SUBSCRIBER = 7 | 新增 | +| ohos.bundle | ExtensionAbilityType | FILE_SHARE = 6 | 新增 | +| ohos.bundle | ExtensionAbilityType | DATA_SHARE = 5 | 新增 | +| ohos.bundle | ExtensionAbilityType | ACCESSIBILITY = 4 | 新增 | +| ohos.bundle | ExtensionAbilityType | SERVICE = 3 | 新增 | +| ohos.bundle | ExtensionAbilityType | INPUT_METHOD = 2 | 新增 | +| ohos.bundle | ExtensionAbilityType | WORK_SCHEDULER = 1 | 新增 | +| ohos.bundle | ExtensionAbilityType | FORM = 0 | 新增 | +| ohos.bundle | ExtensionFlag | GET_EXTENSION_INFO_WITH_METADATA = 0x00000020 | 新增 | +| ohos.bundle | ExtensionFlag | GET_EXTENSION_INFO_WITH_APPLICATION = 0x00000004 | 新增 | +| ohos.bundle | ExtensionFlag | GET_EXTENSION_INFO_WITH_PERMISSION = 0x00000002 | 新增 | +| ohos.bundle | ExtensionFlag | GET_EXTENSION_INFO_DEFAULT = 0x00000000 | 新增 | +| ohos.bundle | BundleFlag | GET_BUNDLE_WITH_EXTENSION_ABILITY = 0x00000020 | 新增 | + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-data_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-data_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..53f2107aff4ec9e4678d31af6f1215842f546b5b --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-distributed-data_api-9-canary.md @@ -0,0 +1,21 @@ +# 分布式数据管理子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，分布式数据管理子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| ohos.data.dataShare | DataShareHelper | notifyChange(uri: string, callback: AsyncCallback): void;
notifyChange(uri: string): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | denormalizeUri(uri: string, callback: AsyncCallback): void;
denormalizeUri(uri: string): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | normalizeUri(uri: string, callback: AsyncCallback): void;
normalizeUri(uri: string): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | getFileTypes(uri: string, mimeTypeFilter:string, callback: AsyncCallback>): void;
getFileTypes(uri: string, mimeTypeFilter: string): Promise>; | 新增 | +| ohos.data.dataShare | DataShareHelper | getType(uri: string, callback: AsyncCallback): void;
getType(uri: string): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | batchInsert(uri: string, values: Array, callback: AsyncCallback): void;
batchInsert(uri: string, values: Array): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | update(uri: string, value: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void;
update(uri: string, value: rdb.ValuesBucket, predicates: dataAbility.DataAbilityPredicates): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | query(uri: string, columns: Array, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void;
query(uri: string, columns: Array, predicates: dataAbility.DataAbilityPredicates): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | delete(uri: string, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback): void;
delete(uri: string, predicates: dataAbility.DataAbilityPredicates): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | insert(uri: string, value: rdb.ValuesBucket, callback: AsyncCallback): void;
insert(uri: string, value: rdb.ValuesBucket): Promise; | 新增 | +| ohos.data.dataShare | DataShareHelper | off(type: 'dataChange', uri: string, callback?: AsyncCallback): void; | 新增 | +| ohos.data.dataShare | DataShareHelper | on(type: 'dataChange', uri: string, callback: AsyncCallback): void; | 新增 | +| ohos.data.dataShare | dataShare | function createDataShareHelper(context: Context, want: Want, uri: string): DataShareHelper; | 新增 | diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-event-and-notification_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-event-and-notification_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..f0a8548a251577295639f4c4592da095f4413bef --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-event-and-notification_api-9-canary.md @@ -0,0 +1,15 @@ +# 事件通知子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，事件通知子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| commonEventSubscriber | CommonEventSubscriber | finishCommonEvent(callback: AsyncCallback): void;
finishCommonEvent(): Promise; | 新增 | +| ohos.commonEvent | Support | COMMON_EVENT_VOLUME_EJECT = "usual.event.data.VOLUME_EJECT" | 新增 | +| ohos.commonEvent | Support | COMMON_EVENT_VOLUME_BAD_REMOVAL = "usual.event.data.VOLUME_BAD_REMOVAL" | 新增 | +| ohos.commonEvent | Support | COMMON_EVENT_VOLUME_MOUNTED = "usual.event.data.VOLUME_MOUNTED" | 新增 | +| ohos.commonEvent | Support | COMMON_EVENT_VOLUME_UNMOUNTED = "usual.event.data.VOLUME_UNMOUNTED" | 新增 | +| ohos.commonEvent | Support | COMMON_EVENT_VOLUME_REMOVED = "usual.event.data.VOLUME_REMOVED" | 新增 | + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-file-management_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-file-management_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..1303270ddb85fcc8df976832b419bab62c0351d5 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-file-management_api-9-canary.md @@ -0,0 +1,22 @@ +# 文件管理子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，文件管理子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| ohos.storageStatistics | storageStatistics | function getBundleStats(packageName: string, callback: AsyncCallback): void;
function getBundleStats(packageName: string): Promise; | 新增 | +| ohos.storageStatistics | BundleStats | dataSize: number; | 新增 | +| ohos.storageStatistics | BundleStats | cacheSize: number; | 新增 | +| ohos.storageStatistics | BundleStats | appSize: number; | 新增 | +| ohos.volumeManager | volumeManager | function unmount(volumeId: string, callback: AsyncCallback): void;
function unmount(volumeId: string): Promise; | 新增 | +| ohos.volumeManager | volumeManager | function mount(volumeId: string, callback: AsyncCallback): void;
function mount(volumeId: string): Promise; | 新增 | +| ohos.volumeManager | volumeManager | function getAllVolumes(callback: AsyncCallback>): void;
function getAllVolumes(): Promise>; | 新增 | +| ohos.volumeManager | Volume | path: string; | 新增 | +| ohos.volumeManager | Volume | state: number; | 新增 | +| ohos.volumeManager | Volume | removable: boolean; | 新增 | +| ohos.volumeManager | Volume | description: string; | 新增 | +| ohos.volumeManager | Volume | uuid: string; | 新增 | +| ohos.volumeManager | Volume | id: string; | 新增 | + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-misc_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-misc_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..2ec8d94273ce9c2098e8a19ef8999ae5275efd30 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-misc_api-9-canary.md @@ -0,0 +1,34 @@ +# 杂散软件服务子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，杂散软件服务子系统的API变更如下: + +## 接口变更 + +| 模块名* | 类名 | 函数* | 变更类型 | +|---|---|---|---| +| ohos.screenLock | screenLock | function sendScreenLockEvent(event: String, parameter: number, callback: AsyncCallback): void;
function sendScreenLockEvent(event: String, parameter: number): Promise; | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | "function off(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation' \| 'screenlockEnabled' \| 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void;" | 新增 | +| ohos.screenLock | screenLock | function on(type: 'screenlockEnabled', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginSleep' \| 'endSleep' \| 'changeUser', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | +| ohos.screenLock | screenLock | function on(type: 'beginWakeUp' \| 'endWakeUp' \| 'beginScreenOn' \| 'endScreenOn' \| 'beginScreenOff' \| 'endScreenOff' \| 'unlockScreen' \| 'beginExitAnimation', callback: Callback): void; | 新增 | + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multimedia_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multimedia_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..e3789726f74ffc155ea7176da3db9530631bbc96 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-multimedia_api-9-canary.md @@ -0,0 +1,175 @@ +# 媒体子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，媒体子系统的API变更如下: + +## 接口变更 + + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| ohos.multimedia.audio | AudioRenderer | on(type: 'interrupt', callback: Callback): void; | 新增 | +| ohos.multimedia.audio | InterruptEvent | hintType: InterruptHint; | 新增 | +| ohos.multimedia.audio | InterruptEvent | forceType: InterruptForceType; | 新增 | +| ohos.multimedia.audio | InterruptEvent | eventType: InterruptType; | 新增 | +| ohos.multimedia.audio | InterruptForceType | INTERRUPT_SHARE | 新增 | +| ohos.multimedia.audio | InterruptForceType | INTERRUPT_FORCE = 0 | 新增 | +| ohos.multimedia.camera | VideoOutputError | code: VideoOutputErrorCode; | 新增 | +| ohos.multimedia.camera | VideoOutputErrorCode | ERROR_UNKNOWN = -1 | 新增 | +| ohos.multimedia.camera | VideoOutput | on(type: 'error', callback: ErrorCallback): void; | 新增 | +| ohos.multimedia.camera | VideoOutput | on(type: 'frameEnd', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | VideoOutput | on(type: 'frameStart', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | VideoOutput | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.camera | VideoOutput | stop(callback: AsyncCallback): void;
stop(): Promise; | 新增 | +| ohos.multimedia.camera | VideoOutput | start(callback: AsyncCallback): void;
start(): Promise; | 新增 | +| ohos.multimedia.camera | camera | function createVideoOutput(surfaceId: string, callback: AsyncCallback): void;
function createVideoOutput(surfaceId: string): Promise; | 新增 | +| ohos.multimedia.camera | PhotoOutputError | code: PhotoOutputErrorCode; | 新增 | +| ohos.multimedia.camera | PhotoOutputErrorCode | ERROR_UNKNOWN = -1 | 新增 | +| ohos.multimedia.camera | CaptureEndInfo | frameCount: number; | 新增 | +| ohos.multimedia.camera | CaptureEndInfo | captureId: number; | 新增 | +| ohos.multimedia.camera | FrameShutterInfo | timestamp: number; | 新增 | +| ohos.multimedia.camera | FrameShutterInfo | captureId: number; | 新增 | +| ohos.multimedia.camera | PhotoOutput | on(type: 'error', callback: ErrorCallback): void; | 新增 | +| ohos.multimedia.camera | PhotoOutput | on(type: 'captureEnd', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | PhotoOutput | on(type: 'frameShutter', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | PhotoOutput | on(type: 'captureStart', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | PhotoOutput | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.camera | PhotoOutput | capture(callback: AsyncCallback): void;
capture(setting: PhotoCaptureSetting, callback: AsyncCallback): void;
capture(setting?: PhotoCaptureSetting): Promise; | 新增 | +| ohos.multimedia.camera | PhotoCaptureSetting | rotation?: ImageRotation; | 新增 | +| ohos.multimedia.camera | PhotoCaptureSetting | quality?: QualityLevel; | 新增 | +| ohos.multimedia.camera | QualityLevel | QUALITY_LEVEL_LOW | 新增 | +| ohos.multimedia.camera | QualityLevel | QUALITY_LEVEL_MEDIUM | 新增 | +| ohos.multimedia.camera | QualityLevel | QUALITY_LEVEL_HIGH = 0 | 新增 | +| ohos.multimedia.camera | ImageRotation | ROTATION_270 = 270 | 新增 | +| ohos.multimedia.camera | ImageRotation | ROTATION_180 = 180 | 新增 | +| ohos.multimedia.camera | ImageRotation | ROTATION_90 = 90 | 新增 | +| ohos.multimedia.camera | ImageRotation | ROTATION_0 = 0 | 新增 | +| ohos.multimedia.camera | camera | function createPhotoOutput(surfaceId: string, callback: AsyncCallback): void;
function createPhotoOutput(surfaceId: string): Promise; | 新增 | +| ohos.multimedia.camera | PreviewOutputError | code: PreviewOutputErrorCode; | 新增 | +| ohos.multimedia.camera | PreviewOutputErrorCode | ERROR_UNKNOWN = -1 | 新增 | +| ohos.multimedia.camera | PreviewOutput | on(type: 'error', callback: ErrorCallback): void; | 新增 | +| ohos.multimedia.camera | PreviewOutput | on(type: 'frameEnd', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | PreviewOutput | on(type: 'frameStart', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | PreviewOutput | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.camera | camera | function createPreviewOutput(surfaceId: string, callback: AsyncCallback): void;
function createPreviewOutput(surfaceId: string): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSessionError | code: CaptureSessionErrorCode; | 新增 | +| ohos.multimedia.camera | CaptureSessionErrorCode | ERROR_UNKNOWN = -1 | 新增 | +| ohos.multimedia.camera | CaptureSession | on(type: 'error', callback: ErrorCallback): void; | 新增 | +| ohos.multimedia.camera | CaptureSession | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | stop(callback: AsyncCallback): void;
stop(): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | start(callback: AsyncCallback): void;
start(): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | removeOutput(previewOutput: PreviewOutput, callback: AsyncCallback): void;
removeOutput(previewOutput: PreviewOutput): Promise;
removeOutput(photoOutput: PhotoOutput, callback: AsyncCallback): void;
removeOutput(photoOutput: PhotoOutput): Promise;
removeOutput(videoOutput: VideoOutput, callback: AsyncCallback): void;
removeOutput(videoOutput: VideoOutput): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | removeInput(cameraInput: CameraInput, callback: AsyncCallback): void;
removeInput(cameraInput: CameraInput): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | addOutput(previewOutput: PreviewOutput, callback: AsyncCallback): void;
addOutput(previewOutput: PreviewOutput): Promise;
addOutput(photoOutput: PhotoOutput, callback: AsyncCallback): void;
addOutput(photoOutput: PhotoOutput): Promise;
addOutput(videoOutput: VideoOutput, callback: AsyncCallback): void;
addOutput(videoOutput: VideoOutput): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | addInput(cameraInput: CameraInput, callback: AsyncCallback): void;
addInput(cameraInput: CameraInput): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | commitConfig(callback: AsyncCallback): void;
commitConfig(): Promise; | 新增 | +| ohos.multimedia.camera | CaptureSession | beginConfig(callback: AsyncCallback): void;
beginConfig(): Promise; | 新增 | +| ohos.multimedia.camera | camera | function createCaptureSession(context: Context, callback: AsyncCallback): void;
function createCaptureSession(context: Context): Promise; | 新增 | +| ohos.multimedia.camera | FocusState | FOCUS_STATE_UNFOCUSED | 新增 | +| ohos.multimedia.camera | FocusState | FOCUS_STATE_FOCUSED | 新增 | +| ohos.multimedia.camera | FocusState | FOCUS_STATE_SCAN = 0 | 新增 | +| ohos.multimedia.camera | FocusMode | FOCUS_MODE_LOCKED | 新增 | +| ohos.multimedia.camera | FocusMode | FOCUS_MODE_AUTO | 新增 | +| ohos.multimedia.camera | FocusMode | FOCUS_MODE_CONTINUOUS_AUTO | 新增 | +| ohos.multimedia.camera | FocusMode | FOCUS_MODE_MANUAL = 0 | 新增 | +| ohos.multimedia.camera | FlashMode | FLASH_MODE_ALWAYS_OPEN | 新增 | +| ohos.multimedia.camera | FlashMode | FLASH_MODE_AUTO | 新增 | +| ohos.multimedia.camera | FlashMode | FLASH_MODE_OPEN | 新增 | +| ohos.multimedia.camera | FlashMode | FLASH_MODE_CLOSE = 0 | 新增 | +| ohos.multimedia.camera | CameraInputError | code: CameraInputErrorCode; | 新增 | +| ohos.multimedia.camera | CameraInputErrorCode | ERROR_UNKNOWN = -1 | 新增 | +| ohos.multimedia.camera | CameraInput | on(type: 'error', callback: ErrorCallback): void; | 新增 | +| ohos.multimedia.camera | CameraInput | on(type: 'focusStateChange', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | CameraInput | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | setZoomRatio(zoomRatio: number, callback: AsyncCallback): void;
setZoomRatio(zoomRatio: number): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | getZoomRatio(callback: AsyncCallback): void;
getZoomRatio(): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | getZoomRatioRange(callback: AsyncCallback>): void;
getZoomRatioRange(): Promise>; | 新增 | +| ohos.multimedia.camera | CameraInput | setFocusMode(afMode: FocusMode, callback: AsyncCallback): void;
setFocusMode(afMode: FocusMode): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | getFocusMode(callback: AsyncCallback): void;
getFocusMode(): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | isFocusModeSupported(afMode: FocusMode, callback: AsyncCallback): void;
isFocusModeSupported(afMode: FocusMode): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | setFlashMode(flashMode: FlashMode, callback: AsyncCallback): void;
setFlashMode(flashMode: FlashMode): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | getFlashMode(callback: AsyncCallback): void;
getFlashMode(): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | isFlashModeSupported(flashMode: FlashMode, callback: AsyncCallback): void;
isFlashModeSupported(flashMode: FlashMode): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | hasFlash(callback: AsyncCallback): void;
hasFlash(): Promise; | 新增 | +| ohos.multimedia.camera | CameraInput | getCameraId(callback: AsyncCallback): void;
getCameraId(): Promise; | 新增 | +| ohos.multimedia.camera | Size | width: number; | 新增 | +| ohos.multimedia.camera | Size | height: number; | 新增 | +| ohos.multimedia.camera | Camera | readonly connectionType: ConnectionType; | 新增 | +| ohos.multimedia.camera | Camera | readonly cameraType: CameraType; | 新增 | +| ohos.multimedia.camera | Camera | readonly cameraPosition: CameraPosition; | 新增 | +| ohos.multimedia.camera | Camera | readonly cameraId: string; | 新增 | +| ohos.multimedia.camera | ConnectionType | CAMERA_CONNECTION_REMOTE | 新增 | +| ohos.multimedia.camera | ConnectionType | CAMERA_CONNECTION_USB_PLUGIN | 新增 | +| ohos.multimedia.camera | ConnectionType | CAMERA_CONNECTION_BUILT_IN = 0 | 新增 | +| ohos.multimedia.camera | CameraType | CAMERA_TYPE_TRUE_DEPTH | 新增 | +| ohos.multimedia.camera | CameraType | CAMERA_TYPE_TELEPHOTO | 新增 | +| ohos.multimedia.camera | CameraType | CAMERA_TYPE_ULTRA_WIDE | 新增 | +| ohos.multimedia.camera | CameraType | CAMERA_TYPE_WIDE_ANGLE | 新增 | +| ohos.multimedia.camera | CameraType | CAMERA_TYPE_UNSPECIFIED = 0 | 新增 | +| ohos.multimedia.camera | CameraPosition | CAMERA_POSITION_FRONT | 新增 | +| ohos.multimedia.camera | CameraPosition | CAMERA_POSITION_BACK | 新增 | +| ohos.multimedia.camera | CameraPosition | CAMERA_POSITION_UNSPECIFIED = 0 | 新增 | +| ohos.multimedia.camera | CameraStatusInfo | status: CameraStatus; | 新增 | +| ohos.multimedia.camera | CameraStatusInfo | camera: Camera; | 新增 | +| ohos.multimedia.camera | CameraManager | on(type: 'cameraStatus', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.camera | CameraManager | createCameraInput(cameraId: string, callback: AsyncCallback): void;
createCameraInput(cameraId: string): Promise;
createCameraInput(position: CameraPosition, type: CameraType, callback: AsyncCallback): void;
createCameraInput(position: CameraPosition, type: CameraType): Promise; | 新增 | +| ohos.multimedia.camera | CameraManager | getCameras(callback: AsyncCallback>): void;
getCameras(): Promise>; | 新增 | +| ohos.multimedia.camera | CameraStatus | CAMERA_STATUS_UNAVAILABLE | 新增 | +| ohos.multimedia.camera | CameraStatus | CAMERA_STATUS_AVAILABLE | 新增 | +| ohos.multimedia.camera | CameraStatus | CAMERA_STATUS_DISAPPEAR | 新增 | +| ohos.multimedia.camera | CameraStatus | CAMERA_STATUS_APPEAR = 0 | 新增 | +| ohos.multimedia.camera | camera | function getCameraManager(context: Context, callback: AsyncCallback): void;
function getCameraManager(context: Context): Promise; | 新增 | +| ohos.multimedia.image | ImageReceiver | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.image | ImageReceiver | on(type: 'imageArrival', callback: AsyncCallback): void; | 新增 | +| ohos.multimedia.image | ImageReceiver | readNextImage(callback: AsyncCallback): void;
readNextImage(): Promise; | 新增 | +| ohos.multimedia.image | ImageReceiver | readLatestImage(callback: AsyncCallback): void;
readLatestImage(): Promise; | 新增 | +| ohos.multimedia.image | ImageReceiver | getReceivingSurfaceId(callback: AsyncCallback): void;
getReceivingSurfaceId(): Promise; | 新增 | +| ohos.multimedia.image | ImageReceiver | readonly format: ImageFormat; | 新增 | +| ohos.multimedia.image | ImageReceiver | readonly capacity: number; | 新增 | +| ohos.multimedia.image | ImageReceiver | readonly size: Size; | 新增 | +| ohos.multimedia.image | Image | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.image | Image | getComponent(componentType: ComponentType, callback: AsyncCallback): void;
getComponent(componentType: ComponentType): Promise; | 新增 | +| ohos.multimedia.image | Image | readonly format: number; | 新增 | +| ohos.multimedia.image | Image | readonly size: Size; | 新增 | +| ohos.multimedia.image | Image | clipRect: Region; | 新增 | +| ohos.multimedia.image | image | function createImageReceiver(width: number, height: number, format: number, capacity: number): ImageReceiver; | 新增 | +| ohos.multimedia.image | Component | readonly byteBuffer: ArrayBuffer; | 新增 | +| ohos.multimedia.image | Component | readonly pixelStride: number; | 新增 | +| ohos.multimedia.image | Component | readonly rowStride: number; | 新增 | +| ohos.multimedia.image | Component | readonly componentType: ComponentType; | 新增 | +| ohos.multimedia.image | ComponentType | JPEG = 4 | 新增 | +| ohos.multimedia.image | ComponentType | YUV_V = 3 | 新增 | +| ohos.multimedia.image | ComponentType | YUV_U = 2 | 新增 | +| ohos.multimedia.image | ComponentType | YUV_Y = 1 | 新增 | +| ohos.multimedia.image | ImageFormat | JPEG = 2000 | 新增 | +| ohos.multimedia.image | ImageFormat | YCBCR_422_SP = 1000 | 新增 | +| ohos.multimedia.media | VideoRecorderConfig | location?: Location; | 新增 | +| ohos.multimedia.media | VideoRecorderConfig | rotation?: number; | 新增 | +| ohos.multimedia.media | VideoRecorderConfig | url: string; | 新增 | +| ohos.multimedia.media | VideoRecorderConfig | profile: VideoRecorderProfile; | 新增 | +| ohos.multimedia.media | VideoRecorderConfig | videoSourceType: VideoSourceType; | 新增 | +| ohos.multimedia.media | VideoRecorderConfig | audioSourceType: AudioSourceType; | 新增 | +| ohos.multimedia.media | VideoSourceType | VIDEO_SOURCE_TYPE_SURFACE_ES = 1 | 新增 | +| ohos.multimedia.media | VideoSourceType | VIDEO_SOURCE_TYPE_SURFACE_YUV = 0 | 新增 | +| ohos.multimedia.media | AudioSourceType | AUDIO_SOURCE_TYPE_MIC = 1 | 新增 | +| ohos.multimedia.media | AudioSourceType | AUDIO_SOURCE_TYPE_DEFAULT = 0 | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly videoFrameRate: number; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly videoFrameHeight: number; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly videoFrameWidth: number; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly videoCodec: CodecMimeType; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly videoBitrate: number; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly fileFormat: ContainerFormatType; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly audioSampleRate: number; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly audioCodec: CodecMimeType; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly audioChannels: number; | 新增 | +| ohos.multimedia.media | VideoRecorderProfile | readonly audioBitrate: number; | 新增 | +| ohos.multimedia.media | VideoRecorder | readonly state: VideoRecordState; | 新增 | +| ohos.multimedia.media | VideoRecorder | on(type: 'error', callback: ErrorCallback): void; | 新增 | +| ohos.multimedia.media | VideoRecorder | reset(callback: AsyncCallback): void;
reset(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | release(callback: AsyncCallback): void;
release(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | stop(callback: AsyncCallback): void;
stop(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | resume(callback: AsyncCallback): void;
resume(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | pause(callback: AsyncCallback): void;
pause(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | start(callback: AsyncCallback): void;
start(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | getInputSurface(callback: AsyncCallback): void;
getInputSurface(): Promise; | 新增 | +| ohos.multimedia.media | VideoRecorder | prepare(config: VideoRecorderConfig, callback: AsyncCallback): void;
prepare(config: VideoRecorderConfig): Promise; | 新增 | +| ohos.multimedia.media | media | function createVideoRecorder(callback: AsyncCallback): void;
function createVideoRecorder(): Promise; | 新增 | diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-resource-scheduler_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-resource-scheduler_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..5e1c6296318de10290c024c48718454c37ec0cf7 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-resource-scheduler_api-9-canary.md @@ -0,0 +1,48 @@ +# 资源调度子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，资源调度子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| ohos.workScheduler | StorageRequest | STORAGE_LEVEL_LOW_OR_OKAY | 新增 | +| ohos.workScheduler | StorageRequest | STORAGE_LEVEL_OKAY | 新增 | +| ohos.workScheduler | StorageRequest | STORAGE_LEVEL_LOW = 0 | 新增 | +| ohos.workScheduler | BatteryStatus | BATTERY_STATUS_LOW_OR_OKAY | 新增 | +| ohos.workScheduler | BatteryStatus | BATTERY_STATUS_OKAY | 新增 | +| ohos.workScheduler | BatteryStatus | BATTERY_STATUS_LOW = 0 | 新增 | +| ohos.workScheduler | ChargingType | CHARGING_PLUGGED_WIRELESS | 新增 | +| ohos.workScheduler | ChargingType | CHARGING_PLUGGED_USB | 新增 | +| ohos.workScheduler | ChargingType | CHARGING_PLUGGED_AC | 新增 | +| ohos.workScheduler | ChargingType | CHARGING_PLUGGED_ANY = 0 | 新增 | +| ohos.workScheduler | NetworkType | NETWORK_TYPE_ETHERNET | 新增 | +| ohos.workScheduler | NetworkType | NETWORK_TYPE_WIFI_P2P | 新增 | +| ohos.workScheduler | NetworkType | NETWORK_TYPE_BLUETOOTH | 新增 | +| ohos.workScheduler | NetworkType | NETWORK_TYPE_WIFI | 新增 | +| ohos.workScheduler | NetworkType | NETWORK_TYPE_MOBILE | 新增 | +| ohos.workScheduler | NetworkType | NETWORK_TYPE_ANY = 0 | 新增 | +| ohos.workScheduler | workScheduler | function isLastWorkTimeOut(workId: number, callback: AsyncCallback): boolean;
function isLastWorkTimeOut(workId: number): Promise; | 新增 | +| ohos.workScheduler | workScheduler | function stopAndClearWorks(): boolean; | 新增 | +| ohos.workScheduler | workScheduler | function obtainAllWorks(callback: AsyncCallback): Array;
function obtainAllWorks(): Promise>; | 新增 | +| ohos.workScheduler | workScheduler | function getWorkStatus(workId: number, callback: AsyncCallback): void;
function getWorkStatus(workId: number): Promise; | 新增 | +| ohos.workScheduler | workScheduler | function stopWork(work: WorkInfo, needCancel?: boolean): boolean; | 新增 | +| ohos.workScheduler | workScheduler | function startWork(work: WorkInfo): boolean; | 新增 | +| ohos.workScheduler | WorkInfo | idleWaitTime?: number; | 新增 | +| ohos.workScheduler | WorkInfo | isDeepIdle?: boolean; | 新增 | +| ohos.workScheduler | WorkInfo | repeatCount?: number; | 新增 | +| ohos.workScheduler | WorkInfo | isRepeat?: boolean; | 新增 | +| ohos.workScheduler | WorkInfo | repeatCycleTime?: number; | 新增 | +| ohos.workScheduler | WorkInfo | storageRequest?: StorageRequest; | 新增 | +| ohos.workScheduler | WorkInfo | batteryStatus?: BatteryStatus; | 新增 | +| ohos.workScheduler | WorkInfo | batteryLevel?: number; | 新增 | +| ohos.workScheduler | WorkInfo | chargerType?: ChargingType; | 新增 | +| ohos.workScheduler | WorkInfo | isCharging?: boolean; | 新增 | +| ohos.workScheduler | WorkInfo | networkType?: NetworkType; | 新增 | +| ohos.workScheduler | WorkInfo | isPersisted?: boolean; | 新增 | +| ohos.workScheduler | WorkInfo | abilityName: string; | 新增 | +| ohos.workScheduler | WorkInfo | bundleName: string; | 新增 | +| ohos.workScheduler | WorkInfo | workId: number; | 新增 | +| ohos.WorkSchedulerExtensionAbility | WorkSchedulerExtensionAbility | onWorkStop(work: workScheduler.WorkInfo): void; | 新增 | +| ohos.WorkSchedulerExtensionAbility | WorkSchedulerExtensionAbility | onWorkStart(work: workScheduler.WorkInfo): void; | 新增 | + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-v3.2-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-v3.2-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..2075f661cd28f20a4a43ca836fcf500523f7ccc3 --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-v3.2-canary.md @@ -0,0 +1,13 @@ +# JS API Diff (API Version 9 Canary) + +OpenHarmony 3.2 Canary版本在OpenHarmony 3.1 Release版本的基础上，变更的接口清单如下： +- [元能力](js-apidiff-ability_api-9-canary.md) +- [包管理](js-apidiff-bundle_api-9-canary.md) +- [分布式数据管理](js-apidiff-distributed-data_api-9-canary.md) +- [事件通知](js-apidiff-event-and-notification_api-9-canary.md) +- [文件管理](js-apidiff-file-management_api-9-canary.md) +- [Misc软件服务](js-apidiff-misc_api-9-canary.md) +- [OS媒体软件](js-apidiff-multimedia_api-9-canary.md) +- [资源调度](js-apidiff-resource-scheduler_api-9-canary.md) +- [窗口管理](js-apidiff-window_api-9-canary.md) + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-window_api-9-canary.md b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-window_api-9-canary.md new file mode 100644 index 0000000000000000000000000000000000000000..1dd5b263435135a38a1255ae9be00d877bf9083b --- /dev/null +++ b/zh-cn/release-notes/api-change/v3.1-Release/js-apidiff-window_api-9-canary.md @@ -0,0 +1,17 @@ +# 窗口管理子系统JS API变更 + +OpenHarmony 3.2 Canary1版本相较于OpenHarmony 3.1 Release版本，窗口管理子系统的API变更如下: + +## 接口变更 + +| 模块名 | 类名 | 方法/属性/枚举/常量 | 变更类型 | +|---|---|---|---| +| ohos.window | WindowStage | loadContent(path: string, storage: ContentStorage, callback: AsyncCallback): void;
loadContent(path: string, storage?: ContentStorage): Promise;
loadContent(path: string, callback: AsyncCallback): void; | 新增 | +| ohos.window | WindowStage | getSubWindow(): Promise>;
getSubWindow(callback: AsyncCallback>): void; | 新增 | +| ohos.window | WindowStage | createSubWindow(name: string): Promise;
createSubWindow(name: string, callback: AsyncCallback): void; | 新增 | +| ohos.window | WindowStage | getMainWindow(): Promise;
getMainWindow(callback: AsyncCallback): void; | 新增 | +| ohos.window | WindowStageEventType | BACKGROUND | 新增 | +| ohos.window | WindowStageEventType | INACTIVE | 新增 | +| ohos.window | WindowStageEventType | ACTIVE | 新增 | +| ohos.window | WindowStageEventType | FOREGROUND = 1 | 新增 | + diff --git a/zh-cn/release-notes/api-change/v3.1-Release/readme.md b/zh-cn/release-notes/api-change/v3.1-Release/readme.md index ff32c890be0131cc6915432b6c9e89b92a0ca48f..ca69ac422e485e04f319ae9dcddabf66012a99dd 100644 --- a/zh-cn/release-notes/api-change/v3.1-Release/readme.md +++ b/zh-cn/release-notes/api-change/v3.1-Release/readme.md @@ -4,3 +4,7 @@ - [JS API差异报告](js-apidiff-v3.1-release.md) - [Native API差异报告](native-apidiff-v3.1-release.md) + +此外，本次还发布了OpenHarmony 3.2 Canary （API Version 9 Canary）版本： +[JS API差异报告（API Version 9 Canary）](js-apidiff-v3.2-canary.md) +