版本信息：

版本介绍：

本次发布HarmonyOS SDK 2.2 Beta 1，相较上一版本，API变更说明请参见【Java API差异报告（API 6 -> API 5）】和【JS API 差异报告（API 6 -> API 5）】。

● JS API差异报告（API 6 -> API 5）

手机、平板、智惹屏、智能穿戴

组件

通用

组件名称	变更类型	变更说明
通用事件	新增	新增事件绑定冒泡模式和捕获模式
通用样式	新增	新增hover伪类用于监控组件是否处于鼠标悬浮状态
资源限定与访问	新增	新增MCC和MNC、横竖屏、深色模式、设备类型
通用属性	新增	新增data-*进行相应的数据存储和读取
通用属性	新增	新增dir设置元素布局模式
通用样式	新增	min-width/min-height/max-width/max-height支持百分比
通用样式	新增	left$TABLE_COLtop$TABLE_COLright|bottom支持百分比
通用样式	新增	新增align-self设置自身在父元素交叉轴上的对齐方式
通用样式	新增	新增start|end配合position样式确定元素的偏移位置
通用样式	新增	新增z-index设置同一父节点其子节点的渲染顺序
通用样式	新增	新增image-fill为svg图片填充颜色
通用样式	新增	新增clip-path设置组件的裁剪区域
通用样式	新增	新增mask-image设置组件遮罩
通用样式	新增	新增mask-size设置遮罩尺寸
通用样式	新增	新增mask-position设置遮罩位置
通用事件	新增	BaseEvent新增deviceId属性表示触发该事件的设备ID信息
通用事件	新增	TouchInfo新增force属性表示接触力信息
通用事件	新增	SwipeEvent新增distance属性表示在滑动方向上的滑动距离
通用方法	新增	新增getBoundingClientRect方法 获取元素的大小及其相对于窗口的位置
通用方法	新增	动画接口新增direction参数设置动画的播放模式
通用方法	新增	动画接口fill参数新增backwards和both模式
通用方法	新增	动画曲线支持steps曲线
通用方法	新增	动画对象支持动画开始事件
动画样式	新增	transform-origin支持string类型赋值
动画样式	新增	支持简写属性animation
动画样式	新增	新增animtion-direction参数设置动画的播放模式
动画样式	新增	animation-fill-mode参数新增backwards和both模式
动画样式	新增	新增animation-play-state指定动画的当前状态
动画样式	新增	新增transition样式设置组件的过渡效果
动画样式	新增	支持全量W3C标准transform能力
动画样式	新增	keyframes新增background-position的支持
动画样式	新增	keyframes新增多段式配置能力
媒体查询	新增	新增dark-mode表示当前系统是否为深色模式
长度类型	新增	新增fp字体尺寸单位

容器组件

组件名称	变更类型	变更说明
badge	新增	新增label属性设置新事件提醒的文本值
div	新增	新增overflow、align-items、scrollbar-color、scrollbar-width、overscroll-effect样式/reachStart、reachEnd、reachTop、reachBottom事件/getScrollOffset、scrollBy方法
list	新增	新增scrollbaroffset、scrollbar-color、scrollbar-width样式
refresh	新增	新增timeoffset属性设置更新时间距离父组件顶部的距离
form	新增	新增form表单容器组件

基础组件

组件名称	变更类型	变更说明
chart	新增	新增animationduration属性设置占比类圆形图表展开动画时长
image	新增	src属性新增对Base64字符串的支持
image-animator	新增	新增支持设置每帧时长和启用图片预加载
input	新增	新增autofocus、selectedstart、selectedend、softkeyboardenabled、showpasswordicon属性/caret-color样式/selectchange事件/delete方法
option	新增	新增action属性
search	新增	新增caret-color样式
textarea	新增	新增word-break、caret-color样式/新增autofocus、selectedstart、selectedend、softkeyboardenabled属性/新增selectchange事件
richtext	新增	新增richtext富文本组件
web	新增	新增web网页内容展示组件
xcomponent	新增	新增xcomponent插件组件

媒体组件

组件名称	变更类型	变更说明
video	新增	新增loop、starttime、speed、direction属性/stop方法
camera	新增	新增camera照相机组件

画布组件

组件名称	变更类型	变更说明
canvas	新增	新增抗锯齿能力和toDataURL能力
CanvasRenderingContext2D对象	新增	新增ellipse()接口、Path2D能力、绘制线性渐变和径向渐变能力、图像平整度设置能力。

栅格组件

组件名称	变更类型	变更说明
grid-container	新增	新增gridtemplate属性

基本功能

全局

接口名称	变更类型	变更说明
getApp() => object	新增	-
scrollTo( ScrollPageParam param) => void	新增	-
onShow() => void	新增	-
onHide() => void	新增	-
onConfigurationUpdated( Configuration configuration ) => void	新增	-

@ohos.ability.featureAbility

接口名称	变更类型	变更说明
featureAbility.getContext	新增	获取上下文
featureAbility.getWant	新增	获取程序启动时的参数
featureAbility.startAbility	新增	启动ability

@ohos.window

接口名称	变更类型	变更说明
window.getTopWindow	新增	新增获取当前窗口的接口
window.setSystemBarProperties	新增	新增设置页面导航条颜色的接口
window.getProperties	新增	新增获取当前窗口属性的接口
window.setBackgroundColor	新增	新增动态设置窗口的背景色的接口
window.setKeepScreenOn	新增	新增设置屏幕是否常量的接口
window.setFullScreen	新增	新增设置是否全屏状态的接口
window.setBrightness	新增	新增设置屏幕亮度的接口
window.on	新增	新增开启监听键盘高度变化的接口
window.off	新增	新增关闭监听键盘高度变化的接口

@ohos.pasteboard

接口名称	变更类型	变更说明
getSystemPasteboard	新增	获取系统剪切板
createPlainTextData	新增	创建文本类型的PasteData对象
getPrimaryText	新增	获取文本数据
setPasteData	新增	写入系统剪切板内容
getPasteData	新增	读取系统剪切板内容

Context

接口名称	变更类型	变更说明
context.getCacheDir	新增	获取缓存目录
context.getFilesDir	新增	获取文件目录
context.getExternalCacheDir	新增	获取外部缓存目录

网络访问

@ohos.net.http

接口名称	变更类型	变更说明
request(url: string, callback: AsyncCallback<HttpResponse>): void; request(url: string, options: HttpRequestOptions, callback: AsyncCallback<HttpResponse>): void; request(url: string, options?: HttpRequestOptions): Promise<HttpResponse>;	新增	新增发起http网络请求
destroy(): void;	新增	新增中断请求任务
on(type: “headerReceive”, callback: AsyncCallback<Object>): void;	新增	新增打开监听HTTP Response Header 事件
off(type: “headerReceive”, callback?: AsyncCallback<Object>): void;	新增	新增取消监听HTTP Response Header 事件

@ohos.net.websocket

接口名称	变更类型	变更说明
connect(url: string, callback: AsyncCallback<boolean>): void; connect(url: string, options: WebSocketRequestOptions, callback: AsyncCallback<boolean>): void; connect(url: string, options?: WebSocketRequestOptions): Promise<boolean>;	新增	新增建立一个websocket连接
send(data: string, callback: AsyncCallback<boolean>): void; send(data: string): Promise<boolean>;	新增	新增通过websocket连接发送数据
close(options: WebSocketCloseOptions): void; close(options: WebSocketCloseOptions, callback: AsyncCallback<boolean>): void; close(options?: WebSocketCloseOptions): Promise<boolean>;	新增	新增关闭websocket连接
on(type: ‘open’, callback: AsyncCallback<Object>): void; on(type: ‘message’, callback: AsyncCallback<string>): void; on(type: ‘close’, callback: AsyncCallback<{ code: number, reason: string }>): void; on(type: ‘error’, callback: ErrorCallback): void;	新增	新增打开监听websocket连接的打开事件、接收到服务器消息事件、关闭事件和错误事件
off(type: ‘open’, callback?: AsyncCallback<Object>): void; off(type: ‘message’, callback: AsyncCallback<string>): void; off(type: ‘close’, callback?: AsyncCallback<{ code: number, reason: string }>): void; off(type: ‘error’, callback?: ErrorCallback): void;	新增	新增关闭监听websocket连接的打开事件、接收到服务器消息事件、关闭事件和错误事件

文件数据

@ohos.fileio

接口名称	变更类型	变更说明
fileio.stat	新增	基于路径获取文件状态信息（异步）
fileio.statSync	新增	基于路径获取文件状态信息（同步）
fileio.opendir	新增	打开目录（异步）
fileio.opendirSync	新增	打开目录（异步）
fileio.access	新增	获取文件存在和读写状态（异步）
fileio.accessSync	新增	获取文件存在和读写状态（同步）
fileio.closeSync	新增	关闭文件（同步）
fileio.copyFile	新增	复制文件（异步）
fileio.copyFileSync	新增	复制文件（同步）
fileio.mkdir	新增	创建目录（同步）
fileio.mkdirSync	新增	创建目录（异步）
fileio.openSync	新增	打开文件（同步）
fileio.read	新增	读文件（异步）
fileio.readSync	新增	读文件（同步）
fileio.rmdirSync	新增	删除目录（同步）
fileio.unlink	新增	删除文件（异步）
fileio.unlinkSync	新增	删除文件（同步）
fileio.write	新增	写文件（异步）
fileio.writeSync	新增	写文件（同步）
fileio.hash	新增	哈希文件（异步）
fileio.Dir.read	新增	读取下一个目录项（异步）
fileio.Dir.readSync	新增	读取下一个目录项（同步）
fileio.Dir.closeSync	新增	关闭目录（同步）
fileio.Dirent.name	新增	获取目录项名称
fileio.Dirent.isBlockDevice	新增	判断目录项是否是块设备
fileio.Dirent.isCharacterDevice	新增	判断目录项是否是字符设备
fileio.Dirent.isDirectory	新增	判断目录项是否是目录
fileio.Dirent.isFIFO	新增	判断目录项是否是FIFO
fileio.Dirent.isFile	新增	判断目录项是否是普通文件
fileio.Dirent.isSocket	新增	判断目录项是否是SOCKET
fileio.Dirent.isSymbolicLink	新增	判断目录项是否是符号链接
fileio.Stat.dev	新增	读取文件的dev
fileio.Stat.ino	新增	读取文件的INO
fileio.Stat.mode	新增	读取文件的mode
fileio.Stat.nlink	新增	读取文件的nlink
fileio.Stat.uid	新增	读取文件的uid
fileio.Stat.gid	新增	读取文件的gid
fileio.Stat.rdev	新增	读取文件的rdev
fileio.Stat.size	新增	读取文件的size
fileio.Stat.blocks	新增	读取文件的blocks
fileio.Stat.atime	新增	读取文件的atime
fileio.Stat.mtime	新增	读取文件的mtime
fileio.Stat.ctime	新增	读取文件的ctime
fileio.Stat.isBlockDevice	新增	判断文件是否是BlockDevice
fileio.Stat.isCharacterDevice	新增	判断文件是否是CharacterDevice
fileio.Stat.isDirectory	新增	判断文件是否是Directory
fileio.Stat.isFIFO	新增	判断文件是否是FIFO
fileio.Stat.isFile	新增	判断文件是否是File
fileio.Stat.isSocket	新增	判断文件是否是Socket
fileio.Stat.isSymbolicLink	新增	判断文件是否是SymbolicLink

@ohos.document

接口名称	变更类型	变更说明
document.choose	新增	通过文件管理picker选取文件，返回文件uri
document.show	新增	通过入参uri，拉起对应应用打开文件

@ohos.data.storage

接口名称	变更类型	变更说明
getStorageSync(path: string)	新增	创建或获取一个Storage实例
getStorage(path: string, callback: AsyncCallback<Storage>)	新增	创建或获取一个Storage实例
getStorage(path: string)	新增	创建或获取一个Storage实例
deleteStorageSync(path: string)	新增	删除一个Storage实例
deleteStorage(path: string, callback: AsyncCallback<void>)	新增	删除一个Storage实例
deleteStorage(path: string)	新增	删除一个Storage实例
removeStorageFromCacheSync(path: string)	新增	从缓存中移除指定的Storage实例
removeStorageFromCache(path: string, callback: AsyncCallback<void>)	新增	从缓存中移除指定的Storage实例
removeStorageFromCache(path: string)	新增	从缓存中移除指定的Storage实例
storage.getSync(key: string, defValue: ValueType)	新增	获取指定key的值
storage.get(key: string, defValue: ValueType, callback: AsyncCallback<ValueType>)	新增	获取指定key的值
storage.get(key: string, defValue: ValueType)	新增	获取指定key的值
storage.hasSync(key: string)	新增	检查指定key是否存在
storage.has(key: string, callback: AsyncCallback<boolean>)	新增	检查指定key是否存在
storage.has(key: string)	新增	检查指定key是否存在
storage.putSync(key: string, value: ValueType)	新增	添加一个指定的key-value到Storage实例中
storage.put(key: string, value: ValueType, callback: AsyncCallback<void>)	新增	添加一个指定的key-value到Storage实例中
storage.put(key: string, value: ValueType)	新增	添加一个指定的key-value到Storage实例中
storage.deleteSync(key: string)	新增	从Storage实例中删除一个指定的key-value对象
storage.delete(key: string, callback: AsyncCallback<void>)	新增	从Storage实例中删除一个指定的key-value对象
storage.delete(key: string)	新增	从Storage实例中删除一个指定的key-value对象
storage.clearSync()	新增	从Storage实例中清空所有的数据
storage.clear(callback: AsyncCallback<void>)	新增	从Storage实例中清空所有的数据
storage.clear()	新增	从Storage实例中清空所有的数据
storage.flushSync()	新增	将Storage实例持久化到文件中
storage.flush(callback: AsyncCallback<void>)	新增	将Storage实例持久化到文件中
storage.flush()	新增	将Storage实例持久化到文件中
storage.on(type: ‘change’, callback: Callback<StorageObserver>)	新增	添加数据变动的监听，当Storage实例持久化时，该回调方法会被执行
storage.off(type: ‘change’, callback: Callback<StorageObserver>)	新增	取消数据变动的监听

系统能力

@ohos.deviceInfo

接口名称	变更类型	变更说明
deviceInfo.deviceType	新增	新增设备类型
deviceInfo.manufacture	新增	新增设备厂家名称
deviceInfo.brand	新增	新增设备品牌名称
deviceInfo.marketName	新增	新增外部产品系列
deviceInfo.productSeries	新增	新增产品系列
deviceInfo.productModel	新增	新增认证型号
deviceInfo.softwareModel	新增	新增内部软件子型号
deviceInfo.hardwareModel	新增	新增硬件版本号
deviceInfo.hardwareProfile	新增	新增硬件Profile
deviceInfo.serial	新增	新增设备序列号
deviceInfo.bootloaderVersion	新增	新增Bootloader版本号
deviceInfo.abiList	新增	新增应用二进制接口（Abi）列表
deviceInfo.securityPatchTag	新增	新增安全补丁级别
deviceInfo.displayVersion	新增	新增产品版本
deviceInfo.incrementalVersion	新增	新增差异版本号
deviceInfo.osReleaseType	新增	新增系统的发布类型
deviceInfo.osFullName	新增	新增系统版本
deviceInfo.majorVersion	新增	新增Major版本号
deviceInfo.seniorVersion	新增	新增Senior版本号
deviceInfo.featureVersion	新增	新增Feature版本号
deviceInfo.buildVersion	新增	新增Build版本号
deviceInfo.sdkApiVersion	新增	新增系统软件API版本
deviceInfo.firstApiVersion	新增	新增首个版本系统软件API版本
deviceInfo.versionId	新增	新增版本ID
deviceInfo.buildType	新增	新增构建类型
deviceInfo.buildUser	新增	新增构建用户
deviceInfo.buildHost	新增	新增构建主机
deviceInfo.buildTime	新增	新增构建时间
deviceInfo.buildRootHash	新增	新增构建版本Hash

@system.sensor

接口名称	变更类型	变更说明
sensor.subscribeDeviceOrientation	新增	新增订阅设备方向传感器
sensor.unsubscribeDeviceOrientation	新增	新增取消订阅设备方向传感器
sensor.subscribeGyroscope	新增	新增订阅陀螺仪传感器
sensor.unsubscribeGyroscope	新增	新增取消订阅陀螺仪传感器

@ohos.batteryinfo

接口名称	变更类型	变更说明
batteryInfo.batterySOC	新增	新增电量属性
batteryInfo.chargingStatus	新增	新增充电状态属性
batteryInfo.healthStatus	新增	新增电池健康状态属性
batteryInfo.pluggedType	新增	新增充电器类型属性
batteryInfo.voltage	新增	新增电池电源属性
batteryInfo.technology	新增	新增电池类型属性
batteryInfo.batteryTemperature	新增	新增电池温度属性
batteryInfo.BatteryHealthState	新增	新增电池健康状态枚举
batteryInfo.BatteryPluggedType	新增	新增充电器类型枚举
batteryInfo.BatteryChargeState	新增	新增充电状态枚举

@ohos.multimedia.media

接口名称	变更类型	变更说明
createAudioPlayer(): AudioPlayer	新增	创建音频播放的实例
createAudioRecorder(): AudioRecorder	新增	创建音频录制的实例
play(): void	新增	开始播放音频资源
pause(): void	新增	暂停播放音频资源
stop(): void	新增	停止播放音频资源
seek(timeMs: number): void	新增	跳转到指定播放位置
setVolume(vol: number): void	新增	设置音量
release(): void	新增	释放音频资源
on(type: ‘play’ $TABLE_COL ‘pause’ $TABLE_COL ‘stop’$TABLE_COL ‘finish’ $TABLE_COL ‘volumeChange’, callback: () => void): void	新增	开始监听音频播放事件
on(type:‘error’, callback: ErrorCallback): void	新增	开始监听音频播放错误事件
prepare(config: AudioRecorderConfig): void	新增	录音准备
start(): void	新增	录音开始
pause(): void	新增	录音暂停
resume(): void	新增	录音恢复
stop(): void	新增	录音停止
release(): void	新增	录音释放
reset(): void	新增	录音重置
on(type: ‘prepare’ $TABLE_COL ‘start’ $TABLE_COL ‘pause’ $TABLE_COL ‘resume’ $TABLE_COL ‘stop’ $TABLE_COL ‘release’ $TABLE_COL ‘reset’, callback: () => void): void	新增	开始监听音频录制事件
on(type: ‘error’, callback: ErrorCallback): void	新增	开始监听音频录制错误事件

@ohos.multimedia.mediaLibrary

接口名称	变更类型	变更说明
getMediaLibrary()	新增	获取媒体数据管理器
storeMediaAsset(option: MediaAssetOption, callback: AsyncCallback<string>)	新增	保存媒体资源
storeMediaAsset(option: MediaAssetOption)	新增	保存媒体资源

安全

@ohos.useriam.userauth

接口名称	变更类型	变更说明
userauth.getAuthenticator	新增	新增获取认证器对象接口
userauth.Authenticator.execuate	新增	新增执行认证接口

轻量级智能穿戴

组件

通用

组件名称	变更类型	变更说明
通用样式	新增	‘left’ | 'top’支持百分比

● Java API差异报告（API 6 -> API 5）

Added Packages

Added Packages
ohos.data.file	Provides basic file access capabilities.

Added Packages

Package ohos.aafwk.ability

Added Classes and Interfaces
FormState	Enumerates the states of a form.
IAbilityStartCallback	Provides a callback to be invoked when an ability is started in installation-free mode.

Changed Classes and Interfaces
Ability	An ability is an abstraction of functionalities that a HarmonyOS application can provide.
AbilitySlice	As the fundamental unit of the Ability using the Page template, {@code AbilitySlice} provides an ability with a carrier for service logic and UI display.
AbilitySlice.FormCallback	Provides callbacks that will be invoked when a Form instance is obtained or when the {@code Form} provider is uninstalled.
IAbilityContinuation	Enables an Ability to implement migration in a distributed system.

Package ohos.aafwk.ability.continuation

Added Classes
ContinuationDeviceInfo	Defines information about the selected device.

Changed Interfaces
IContinuationDeviceCallback	Provides callbacks for listening for device connection state changes.

Package ohos.aafwk.content

Changed Classes
Intent	Provides an abstract description of an operation to be performed.

Package ohos.agp.components.webengine

Added Interfaces
ScaleChangeListener	Provides a listener that listens for scale changes.
ScaleController	Manages and observes scaling of a {@code WebView} object.

Changed Classes
WebView	Represents a component that has the web page access capability.

Package ohos.agp.window.service

Changed Classes
WindowManager.LayoutConfig	Encapsulates the layout attributes, flags, and constants used with a Window.

Package ohos.app

Changed Classes and Interfaces
AbilityContext	An abstract class that provides the application context for the current object and obtains the application environment information.
Context	Provides the context of an object in the application and obtains application environment information.

Package ohos.bundle

Changed Classes
ApplicationInfo	Obtains configuration information about an application.

Package ohos.data.distributed.file

Changed Classes
DistAgentFile	Provides methods for the file manager to perform operations on distributed agent files.
DistFile	Inherits from the {@code java.io.File} class and provides methods for the file manager to perform basic operations on distributed files or directories.
DistFiles	Provides methods for the file manager to perform operations on distributed files or directories.
DistLinkFile	Provides methods for the file manager to perform operations on distributed link files.

Package ohos.event.notification

Added Classes
ReminderHelper	Provides static methods for managing reminders, including publishing or canceling a reminder, adding or removing a notification slot, and obtaining or canceling all reminders of the current application.
ReminderManager	Define constant for background agent service function.
ReminderManager.AppLimitExceedsException	Throws this exception when the number of effective reminders of current application exceed the limit value ReminderDataManager#MAX_NUM_REMINDER_LIMIT_APP
ReminderManager.SysLimitExceedsException	Throws this exception when the number of effective reminders of the whole system exceed the limit value ReminderDataManager#MAX_NUM_REMINDER_LIMIT_SYSTEM
ReminderRequest	Base class for letting a background agent to publish reminders on behalf of a third-party application.
ReminderRequestAlarm	A ReminderRequest child class used for creating reminders for alarm clocks.
ReminderRequestCalendar	A ReminderRequest child class used for creating reminders for calendar events.
ReminderRequestTimer	A ReminderRequest child class used for creating reminders for countdown timers.

Package ohos.media.audio

Changed Classes
AudioManager	Manages audio information, controls audio devices, adjusts the volume, and manages the audio focus.

Package ohos.miscservices.download

Changed Classes
DownloadConfig.Builder	Provides {@code Builder} objects of download configuration, including methods to set parameters used to create a download session.

Package ohos.rpc

Changed Classes
MessageParcel	Inherits from the Parcel class and provides methods for managing {@code MessageParcel} objects.
RemoteProxy	Implements IRemoteObject proxy objects.

Package ohos.utils

Changed Classes
IntentConstants	Defines the ohos.aafwk.content.Intent-related constants used in the system, including the actions, entities, and flags contained in the intents passed to methods for starting an ability.