Java、JS API差异报告(API 6 -> API 5)

鸿蒙开发者社区官方账号
发布于 2021-7-1 13:47
浏览
3收藏

版本信息:

微信图片_20210701104648.jpg

版本介绍:

本次发布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.

分类
已于2021-7-1 13:47:25修改
4
收藏 3
回复
举报
2条回复
按时间正序
/
按时间倒序
爱吃土豆丝的打工人
爱吃土豆丝的打工人

先收藏下,看了前面几个表,对比很清晰。大赞~

回复
2021-7-1 16:01:35
jfztaq
jfztaq

要学的好多,

回复
2021-7-2 11:50:19
回复
    相关推荐