版本更新说明

接入账号服务

• 新增“小程序转快应用2.0”接入账号服务文档。

详情请参见“开发指南 > 小程序转快应用2.0 > 接入账号服务”。

接入h5支付

• 新增“小程序转快应用2.0”接入h5支付文档。

详情请参见“开发指南 > 小程序转快应用2.0 > 接入h5支付”。

账号

• 新增“小程序转快应用2.0”账号API文档。

详情请参见“API > 小程序转快应用2.0 > 账号”。

小程序转快应用2.0

• 新增“小程序转快应用2.0”开发指导。

详情请参见“开发准备 > 小程序转快应用2.0”。

设备信息

device.getSerial(OBJECT):获取设备序列号接口下线。

详情请参见“API > 系统能力 > 设备信息”。

安装开发工具

• "快应用官方示例"、“快应用研发助手”打开入口集成到加载器中。

详情请参见“开发准备 > 安装开发工具”。

华为快应用加载器使用指导

• "快应用官方示例"、“快应用研发助手”使用指导。

详情请参见“附录 > 华为快应用加载器使用指导”。

ad-view

• 不支持padding、padding-left、padding-right、padding-top、padding-bottom、background、background-image、background-color样式。

详情请参见“组件 > ad-view”。

shortcut-button

• 不支持border、border-[left|top|right|bottom]、border-style、border-width、border-[left|top|right|bottom]-width、border-color、border-[left|top|right|bottom]-color、border-[top|bottom]-[left|right]-radius样式。

详情请参见“组件 > shortcut-button”。

AI

ai.detectScene(OBJECT):场景检测能力下架。

详情请参见“API > 华为服务 > AI”。

ad-native-view

• ad-button在ad-native-view内部使用，必须绑定相同的adid。
• 新增默认背景颜色，当背景颜色不设置时，会默认为白色或黑色（跟随系统深色模式设置）。

详情请参见“组件 > ad-native-view”

ad-template

• ad-template组件新增默认圆角样式border-radius。

详情请参见“组件 > ad-template”

shortcut-button

• 该组件必须完整对用户可见，不可被任何元素覆盖或遮挡（含透明元素），否则会影响您的计费。
• 该组件必须完全在屏幕范围内。

详情请参见“组件 > shortcut-button”

ad-view

• 该组件必须完整对用户可见，不可被任何元素覆盖或遮挡（含透明元素），否则会影响您的计费。
• 该组件必须完全在屏幕范围内。

详情请参见“组件 > ad-view”。

web

• 新增whiteDomain属性，用于检查加载url的域。

详情请参见“组件 > web”。

应用配置

接口configuration.getFoldableState增加三折屏状态值。

详情请参见“API > 系统能力 > 应用配置”。

ad-template

• ad-template组件新增广告曝光事件adimpression。
• 该组件必须完全在屏幕范围内。

详情请参见“组件 > ad-template”

ad-native-view

• 该组件必须完全在屏幕范围内。

详情请参见“组件 > ad-native-view”

小程序ad-button

• 该组件必须完全在屏幕范围内，否则无法触发下载。

详情请参见“组件 > 小程序ad-button”

ad-button

• 该组件必须完全在屏幕范围内，否则无法触发下载。

详情请参见“组件 > ad-button”

video

• video组件新增两个属性preCacheUrl，showLoading。

详情请参见“组件 > video”。

swiper

• swiper子组件不支持position:fixed，1116版本开始，swiper子组件设置position:fixed会自动转换成position:relative。

详情请参见“组件 > swiper”。

ad-template

• ad-template新增广告点击事件adclick。

详情请参见“组件 > ad-template”。

ad-native-view

• ad-native-view的一级子组件image/video组件设置position:fixed无效。

• ad-native-view的一级子组件image/video组件设置transform:scale/scaleX/scaleY，范围限制为0.8~1.2。

详情请参见“组件 > ad-native-view”。

ad-button

• 动画缩放样式transform:scale/scaleX/scaleY限制范围0.8~1.2。

• 该组件必须完整对用户可见，不可被任何元素覆盖或遮挡（含透明元素），否则无法触发下载。

详情请参见“组件 > ad-button”。

小程序 ad-button

该组件必须完整对用户可见，不可被任何元素覆盖或遮挡（含透明元素），否则组件无法触发下载。

详情请参见“组件 > 小程序ad-button”。

ad-template

新增组件ad-template——展示鲸鸿动能原生模板广告内容的组件。

详情请参见“组件 > ad-template”。

后台调用管控

禁止后台调用router.push等用户可以感知的接口

广告ad

接口nativeAd.onLoad增加了一个ext参数

详情请参见“API > 华为服务 > 广告”。

广告ad(小程序)

接口nativeAd.onLoad增加了一个ext参数

详情请参见“API > 华为服务 > 广告”。

ad-native-view

新增组件ad-native-view——展示广告内容组件。

详情请参见“组件 > ad-native-view”。

image

image组件新增adfield、adIndex两个属性。

详情请参见“组件 > image”。

video

video组件新增adIndex属性。

详情请参见“组件 > video”。

广告ad

接口nativeAd.load、rewardedVideoAd.load、interstitialAd.load、bannerAd.show都增加了一个extra参数

详情请参见“API > 华为服务 > 广告”。

manifest文件

新增exit属性，支持退出应用时返回快应用首页。

详情请参见“框架 > manifest文件”。

动画样式

transform新增translateZ和translate3d参数。

详情请参见“组件 > 通用设置 > 动画样式”。

<list>

scroll事件新增topIndex和bottomIndex参数。

详情请参见“组件 > list”。

<scroll-view>

新增组件scroll-view——滚动视图组件。

详情请参见“组件 > scroll-view”。

<text>

font-weight样式新增了适用的类型。

详情请参见“组件 > text”。

<web>

• 新增支持加载本地网页。
• 新增intercepturl属性，用于设置需要拦截的url。
• 新增shouldoverrideurl事件，用于限制URL加载到当前WebView。
• 新增intercepturl事件，用于检测被拦截的URL。

详情请参见“组件 > web”。

剪贴板 clipboard

新增fail返回错误码201。

详情请参见“组件 > 系统能力 > 剪贴板”。

设备信息 device

• 新增device.isCodecSupported(codecName)方法，用于检查设备是否支持指定参数的编解码器。
• device.getInfo接口的deviceType参数新增取值foldable，表示可折叠设备。

详情请参见“组件 > 系统能力 > 设备信息”。

录音 record

• record.start接口的format参数取值新增pcm。
• record.start接口新增frameSize参数。
• record.start接口新增fail返回错误码202。
• 新增record.onframerecorded = function(OBJECT)接口，用于监听指定帧大小文件的录制情况。

详情请参见“组件 > 系统能力 > 录音”。

动画 animation

transform新增translateZ和translate3d参数。

详情请参见“组件 > 图形图像 > 动画”。

manifest文件

新增fitWideScreenMode参数，用于指定适用于宽屏设备上的显示模式。

详情请参见“框架 > manifest文件”。

<video>

• 新增speed等属性、renderedfirstframe事件和getSupportedVideoCodecs方法。
• pause、error和wait事件新增返回参数。

详情请参见“组件 > video”。

应用配置 configuration

新增getWideScreenFitMode方法，用于获取折叠屏展开时应用内容的居中或满屏状态。

详情请参见“API > 系统能力 > 应用配置”。

账号 account

接口account.authorize的scope参数配置新增scope.baseId。

详情请参见“API > 华为服务 > 账号”。

manifest文件

• config中新增permissionAdapted属性。
• menuBarData中的shareCurrentPage属性修改默认值为true。
• 新增exitDesc，可配置退出页面提示信息。

详情请参见“框架 > manifest文件”。

script脚本

页面方法新增enableAlertBeforeUnload和disableAlertBeforeUnload。

详情请参见“框架 > script脚本”。

页面路由 router

router.push接口新增hap://settings/permissions，跳转到快应用的权限管理页面。

详情请参见“API>基本功能>页面路由”。

通知消息 notification

notification.show新增成功回调和失败回调参数。

详情请参见“API>界面交互>通知消息”。

Deeplink

Deeplink链接新增支持__WINDOW_STYLE__参数，可控制从原生应用或者快应用中打开的快应用是否半屏显示。

详情请参见“Deeplink”。

<ad-button>

• 优化valuetype属性的描述。
• 新增open-type属性。

详情请参见“组件 > ad-button”。

<shortcut-button>

新增add-type属性。

详情请参见“组件 > shortcut-button”。

<ad-button>（小程序）

小程序转快应用规范中，优化了ad-button组件：

• 优化valuetype属性的描述。
• 新增open-type属性。

详情请参见“小程序转快应用规范 > 广告组件 > ad-button”。

广告 ad

• nativeAd.onLoad的广告item说明新增应用相关的参数。
• nativeAd.reportAdClick的clickInfo参数中新增upX、upY等参数，并修改creativeSize参数说明。
• 新增nativeAd.showAppDetailPage()接口：跳转应用详情页。
• 新增nativeAd.onRewardActive(function callback)接口：监听原生广告激励产生事件，仅AGD类广告返回。
• 新增nativeAd.offRewardActive()接口：移除原生广告激励产生监听。
• 新增1005、1106等错误码。

详情请参见“API>华为服务>广告”。

qa.disableAlertBeforeUnload（小程序）

小程序转快应用规范中，新增接口qa.disableAlertBeforeUnload。

详情请参见“小程序转快应用规范>API>界面>交互>qa.disableAlertBeforeUnload”。

qa.enableAlertBeforeUnload（小程序）

小程序转快应用规范中，新增接口qa.enableAlertBeforeUnload。

详情请参见“小程序转快应用规范>API>界面>交互>qa.enableAlertBeforeUnload”。

数据交换（小程序）

小程序转快应用规范中，新增数据交换接口。

详情请参见“小程序转快应用规范>API>数据>数据交换”。

广告（小程序）

• nativeAd.onLoad的广告item说明新增应用相关的参数。
• nativeAd.reportAdClick的clickInfo参数中新增upX、upY等参数，并修改creativeSize参数说明。
• 新增nativeAd.showAppDetailPage()接口：跳转应用详情页。
• 新增nativeAd.onRewardActive(function callback)接口：监听原生广告激励产生事件，仅AGD类广告返回。
• 新增nativeAd.offRewardActive()接口：移除原生广告激励产生监听。

详情请参见“小程序转快应用规范>API>开放接口>华为服务>广告”。

qa.addPhoneCalendar（小程序）

小程序转快应用规范中，新增接口qa.addPhoneCalendar。

详情请参见“小程序转快应用规范>API>设备>日历>qa.addPhoneCalendar”。

qa.addPhoneRepeatCalendar（小程序）

小程序转快应用规范中，新增接口qa.addPhoneRepeatCalendar。

详情请参见“小程序转快应用规范>API>设备>日历>qa.addPhoneRepeatCalendar”。

<shortcut-button>

• 新增不支持的通用样式。
• 修改color和background的默认颜色。
• 新增font-size取值范围为20~112.5px。

详情请参见“组件 > shortcut-button”。

应用上下文

• 新增app. getUpdateManager()，获取应用更新管理器对象。
• 新增UpdateManager.applyUpdate()，强制重启快应用并使用新版本。
• 新增UpdateManager. onCheckForUpdate(function listener)，用于监听快应用检查更新的结果。
• 新增UpdateManager.onUpdateReady(function listener)，新版本下载成功时进行回调。
• 新增UpdateManager.onUpdateFailed(function listener)，新版本下载失败时进行回调。

详情请参见“API > 基本功能 > 应用上下文”。

多媒体 media

media.setRingtone的title字段新增限制说明。

详情请参见“API > 图形图像 > 多媒体”。

广告 ad

reportAdClick接口新增clickInfo参数。

详情请参见“API>华为服务>广告”。

广告（小程序）

小程序转快应用规范中，reportAdClick接口新增clickInfo参数。

详情请参见“小程序转快应用规范>API>开放接口>华为服务>广告”。

qa.getExtConfig（小程序）

小程序转快应用规范中，新增接口qa.getExtConfig。

详情请参见“小程序转快应用规范>API>第三方平台>qa.getExtConfig”。

qa.getExtConfigSync（小程序）

小程序转快应用规范中，新增接口qa.getExtConfigSync。

详情请参见“小程序转快应用规范>API>第三方平台>qa.getExtConfigSync”。

广告 ad

• 原生广告、模板广告、互推盒子广告和互推盒子横划榜单广告接口新增channel字段。
• 修复了nativeAd.onLoad的desc参数内容不为广告描述的问题。

详情请参见“API>华为服务>广告”。

广告（小程序）

小程序转快应用规范中，优化了广告接口：

• 原生广告、互推盒子广告和互推盒子横划榜单广告接口新增channel字段。
• 修复了nativeAd.onLoad的desc参数内容不为广告描述的问题。

详情请参见“小程序转快应用规范>API>开放接口>华为服务>广告”。

<ad-button>

• 优化了一些描述和示例代码。
• 新增install-text-value和open-text-value属性。
• 新增opacity、border-radius、color、background-color、progressbar-color、progressbar-background-color、progressbar-text-color样式。

详情请参见“组件 > ad-button”。

<shortcut-button>

• 优化了value属性、height和color样式的描述。
• 新增background-color和opacity样式。
• 优化了示例代码。

详情请参见“组件 > shortcut-button”。

<ad-button>（小程序）

小程序转快应用规范中，优化了ad-button组件：

• 优化了一些描述和示例代码。
• 新增install-text-value、open-text-value、progressbar-color、progressbar-background-color、progressbar-text-color属性。
• 新增border-radius、color、background-color样式。

详情请参见“小程序转快应用规范 > 广告组件 > ad-button”。

日志回传 feedback

新增feedback.getLogFiles接口，用于获取本地缓存的console日志。返回的uri参数可用于file.get，以获取本地文件信息。

详情请参见“API>基本功能>日志回传”。

页面路由 router

router.push接口新增hap://settings/feedback，跳转到统一菜单下的“问题与建议”页面。

详情请参见“API>基本功能>页面路由”。

画布 canvas

onload事件新增参数{target: bitmap}。

详情请参见“API>图形图像>画布”。

H5点击组件跳转快应用

快应用新增章节《H5点击组件跳转快应用》。

H5点击组件跳转快应用是指通过在H5页面中使用快应用官方推荐的点击组件，在用户主动点击时，可以发起跳转到指定快应用的请求。

详情请参见“H5点击组件跳转快应用”。

推送 push

新增push.requestSubscribeMessage接口，用于调起订阅消息界面，返回用户订阅消息的操作结果。

详情请参见“API>华为服务>推送”。

接入服务消息

快应用新增章节《接入服务消息》。

服务消息是以用户为主导的消息推送能力，帮助开发者实现产品服务闭环，提供更优质的用户体验。

详情请参见“接入服务消息”。

manifest文件

display新增fitCutout属性，是否在异形区域绘制内容。

详情请参见“框架 > manifest文件”。

通用属性

新增无障碍模式相关属性aria-label和aria-unfocusable。

详情请参见“组件 > 通用设置 > 通用属性”。

<ad-button>

• 优化了一些描述和示例代码。
• 1101版本开始，不支持设置color样式。
• 样式新增取值范围。
• height样式的默认值修改为“60px”。
• click事件的响应结果新增-3：无网络。

详情请参见“组件 > ad-button”。

<ad-button>（小程序）

小程序转快应用规范中，新增ad-button组件。

详情请参见“小程序转快应用规范 > 广告组件 > ad-button”。

<ad-view>

新增组件ad-view——广告视图组件。

详情请参见“组件 > ad-view”。

<video>

新增1101规范的属性和事件。

详情请参见“组件 > video”。

桌面图标 shortcut

• 新增widget查询接口shortcut.hasWidget(OBJECT)。
• 新增widget添加接口shortcut.addWidget(OBJECT)。

详情请参见“API > 系统能力 > 桌面图标”。

广告 ad

• 新增模板广告接口。
  • ad.createTemplateAd(OBJECT)：创建 Template 广告组件，如果已经创建过 Template 广告组件，则返回已创建的广告。

    添加了信息流和应用榜单的建议宽高值。

  • templateAd.load(OBJECT)：加载模板广告。
  • templateAd.destroy()：销毁模板广告。
• 新增互推盒子广告接口。
• 新增互推盒子横划榜单广告接口。

详情请参见“API > 华为服务 > 广告”。

广告 ad（小程序）

小程序转快应用规范中，新增原生广告接口、互推盒子广告接口和互推盒子横划榜单广告接口。

详情请参见“小程序转快应用规范>API>开放接口>华为服务>广告”。

接入AGD Pro服务

快应用新增章节《接入AGD Pro服务》。

详情请参见“接入AGD Pro服务”。

接入广告服务（小程序）

小程序转换快应用新增章节《接入广告服务》。

详情请参见“接入广告服务”。

接入AGD Pro服务（小程序）

小程序转换快应用新增章节《接入AGD Pro服务》。

详情请参见“接入AGD Pro服务”。

manifest文件

config新增grayMode属性，用于设置灰色模式。

详情请参见“框架 > manifest文件”。

template模板

for指令支持固定值。

详情请参见“框架 > template模板”。

script脚本

• 自定义组件新增externalClasses属性，增加父组件覆盖子组件样式能力。
• 新增公共方法$nextTick，获取更新后的DOM。

详情请参见“框架 > script脚本”。

灰色模式

新增支持灰色模式。

详情请参见“框架 > 灰色模式”。

动画样式

新增支持transition过渡动画。

详情请参见“组件 > 通用设置 > 动画样式”。

font-face样式

font-face组件通过local支持系统字体。

详情请参见“组件 > 通用设置 > font-face样式”。

<a>

新增支持image子组件。

详情请参见“组件 > a”。

<ad-button>

新增原生广告组件，用于下载原生广告中的广告主App。

详情请参见“组件 > ad-button”。

<image>

a、span、text组件支持image作为子组件使用。

详情请参见“组件 > image”。

<input>

新增属性model:value，支持双向绑定 model指令。

详情请参见“组件 > input”。

<list-item>

新增点击事件拦截控制属性disallowintercept。

详情请参见“组件 > list-item”。

<lottie>

新增组件。

详情请参见“组件 > lottie”。

<share-button>

新增组件。

详情请参见“组件 > share-button”。

<span>

新增支持image子组件。

详情请参见“组件 > span”。

<text>

• 新增支持image子组件。
• letter-spacing样式新增取值normal。

详情请参见“组件 > text”。

<textarea>

新增属性model:value，支持双向绑定 model指令。

详情请参见“组件 > textarea”。

<video>

新增视频截屏方法snapshot。

详情请参见“组件 > video”。

<web>

• postMessage方法新增success与fail回调，增加与H5双向通信时的异常处理逻辑。
• 快应用引擎新增jssdk接口。

详情请参见“组件 > web”。

设备信息 device

接口device.getInfo的返回值新增screenRefreshRate字段，获取屏幕当前显示的刷新率。

详情请参见“API > 系统能力 > 设备信息”。

应用配置 configuration

新增configuration.setGrayMode接口，用于设置灰色模式。

详情请参见“API > 系统能力 > 应用配置”。

截屏 screenshot

新增接口。

详情请参见“API > 系统能力 > 截屏”。

表单输入绑定

新增支持双向绑定 model指令。

详情请参见“表单输入绑定”。

自定义指令

新增支持自定义指令。

详情请参见“自定义指令”。

manifest文件

menuBarData新增shareCurrentPage和shareParams等参数，配置页面的分享。

详情请参见“框架 > manifest文件”。

script脚本

• 新增页面方法setMenubarData，动态设置menuBarData数据。
• 公共对象新增$attrs、$listeners属性。
• 页面方法新增setMeta属性。

详情请参见“框架 > script脚本”。

动画样式

• animation-timing-function新增支持类型。
• 新增animation-direction支持。
• @keyframes参数说明新增background-position。

详情请参见“组件 > 通用设置 > 动画样式”。

<camera>

新增startRecord和stopRecord方法。

详情请参见“组件 > camera”。

<image>

• 新增filter样式，支持模糊滤镜。
• 新增alt-object-fit样式，配置占位图片的缩放模式。

详情请参见“组件 > image”。

<refresh2>

新增组件。

详情请参见“组件 > refresh2”。

<refresh-footer>

新增组件。

详情请参见“组件 > refresh-footer”。

<refresh-header>

新增组件。

详情请参见“组件 > refresh-header”。

<section-list>

新增组件。

详情请参见“组件 > section-list”。

<section-group>

新增组件。

详情请参见“组件 > section-group”。

<section-header>

新增组件。

详情请参见“组件 > section-header”。

<section-item>

新增组件。

详情请参见“组件 > section-item”。

<slide-view>

新增组件。

详情请参见“组件 > slide-view”。

<web>

新增支持html5页面中input标签的capture属性。

详情请参见“组件 > web”。

应用上下文 app

新增 app.createQuickAppQRCode，可生成当前应用的分享二维码。

详情请参见“API > 基本功能 > 应用上下文”。

文件存储 file

接口copyFileToPublicDir新增错误码：303、304。

详情请参见“API > 文件数据 > 文件存储”。

锁屏 keyguard

新增接口。

详情请参见“API > 系统能力 > 锁屏”。

设备信息 device

device.getInfo(OBJECT)接口中新增返回deviceType参数。

详情请参见“API > 系统能力 > 设备信息”。

动画 animation

• style类型说明新增backgroundPosition参数。
• easing有效值新增steps动画。

详情请参见“API > 图形图像 > 动画”。

manifest文件

新增menuBar参数，用于定义菜单栏是否可见。

详情请参见“框架 > manifest文件”。

script脚本

onConfigurationChanged属性新增支持的参数值themeMode、orientation、foldScreenMode。

详情请参见“框架 > script脚本”。

<shortcut-button>

新增组件，用于添加桌面按钮。

详情请参见“组件 > shortcut-button”。

数据请求 fetch

fetch接口新增PATCH方法支持。

详情请参见“API > 网络访问 > 数据请求”。

设备信息 device

新增device.isFoldable方法，用于检测设备是否为可折叠设备。

详情请参见“API > 系统功能 > 设备信息”。

应用配置 configuration

• 新增getThemeMode方法，用于获取应用当前的主题模式。
• 新增getFoldableState方法，用于获取折叠屏的状态。
• 新增getScreenOrientation方法，用于获取屏幕当前的横竖屏状态。

详情请参见“API > 系统功能 > 应用配置”。

manifest文件

• 新增permissionDesc属性，用于描述获取权限的理由。
• 权限配置增加WRITE_EXTERNAL_STORAGE。
• 统一菜单中国大陆固定，海外策略保持不变。

详情请参见“框架 > manifest文件”。

ux文件

app.ux支持定义样式，并全局生效。

详情请参见“框架 > ux文件”。

script脚本

• 新增setSecure方法，用于设置是否设置防截屏。
• setStatusBar方法新增参数visible，新增setNavigationBar方法。
• 应用生命周期新增onScreenChange。
• 新增3个页面生命周期接口：onReachTop、onPageScroll和onReachBottom。

详情请参见“框架 > script脚本”。

通用样式

• border-radius/border-[top|bottom]-[left|right]-radius 支持设置百分比样式。
• 新增background-size样式在1080及以上版本的默认值auto。
• 新增min-width、max-width、min-height、max-height样式。

详情请参见“组件 > 通用设置 > 通用样式”。

<camera>

• 去除autoorientation属性。
• 新增cropimage方法，用于设置是否对拍照生成的照片按camera组件大小进行裁剪。
• 新增 framesize、autoexposurelock 和 autowhitebalancelock 属性。
• 新增 cameraframe 和 camerainitdone 事件。
• 新增 setPreviewFpsRange、getSupportedPreviewFpsRange、getPreviewFpsRange、setExposureCompensation、getExposureCompensationRange 、getExposureCompensation 和 getSupportedSceneModes 方法。

详情请参见“组件 > camera”。

<custommarker>

新增<map>组件的子组件。

详情请参见“组件 > custommarker”。

<div>

新增enablevideofullscreencontainer属性，支持全屏显示自定义组件。

详情请参见“组件 > div”。

<drawer>

新增组件。

详情请参见“组件 > drawer”。

<drawer-navigation>

新增组件。

详情请参见“组件 > drawer-navigation”。

<image>

• 新增autoplay属性。
• 新增startAnimation和stopAnimation方法。

详情请参见“组件 > image”。

<map>

新增setMaxAndMinScaleLevel方法，用于自定义缩放级别。

详情请参见“组件 > map”。

<rating>

新增isFromUser参数，表示当前变化是否由用户拖动触发。

详情请参见“组件 > rating”。

<refresh>

• 增加“低于1040版本不支持click事件。”的限制说明。
• 新增enable-refresh属性。默认值为true，如果该参数未设置，按默认值处理。

详情请参见“组件 > refresh”。

<slider>

• 增加“低于1040版本不支持click事件。”的限制说明。
• 新增isFromUser参数，表示当前变化是否由用户拖动触发。

详情请参见“组件 > slider”。

<swiper>

• 取消子组件数量大于2时loop才生效的限制。
• 新增previousmargin和nextmargin属性，用于设置前边距和后边距。
• 新增enableswipe属性。
• 新增页面切换动画。

详情请参见“组件 > swiper”。

<video>

• 新增titlebar和title属性，用于设置全屏播放时，是否显示顶栏，以及顶栏的标题。
• 增加“低于1040版本点击视频播放控制条不会触发click事件。”的限制说明。
• 新增playcount属性，用于控制播放次数。
• 新增支持全屏显示自定义组件（1080+）特性。

详情请参见“组件 > video”。

<web>

• 增加“低于1040版本不支持click事件。”的限制说明。
• 增加initialscale属性，用于设置初始化网页缩放比例。
• 增加renamejsinterface属性，用于修改web组件和H5通信接口名称，以避免接口冲突。
• 新增pagestart事件的返回参数。
• 新增error事件的返回参数。

详情请参见“组件 > web”。

页面路由 router

router.push接口新增hap://settings/5g，通过router.push跳转到5G开关设置页面。

详情请参见“API > 基本功能 > 页面路由”。

文本解码 decode

新增接口。

详情请参见“API > 基本功能 > 文本解码”。

弹窗 prompt

新增showLoading和hideLoading，用于显示和关闭loading提示框。

详情请参见“API > 界面交互 > 弹窗”。

打开网页 webview

• 新增CCT能力。
• 新增launchFlag参数，用于设置打开浏览器customTabs页面的模式。

详情请参见“API > 界面交互 > 打开网页”。

数据请求 fetch

引擎在header中强制增加Referer信息。

详情请参见“API > 网络访问 > 数据请求”。

上传下载 request

token类型由number变成string。

详情请参见“API > 网络访问 > 上传下载”。

上传任务 uploadtask

新增接口，用于创建一个上传请求，监听上传过程。

详情请参见“API > 网络访问 > 上传任务”。

下载任务 downloadtask

新增接口，用于创建一个下载请求，监听下载过程。

详情请参见“API > 网络访问 > 下载任务”。

请求任务 requesttask

新增接口，用于创建一个网络请求，监听请求过程。

详情请参见“API > 网络访问 > 请求任务”。

文件存储 file

• 新增copyFileToPublicDir，用于复制文件到系统公共目录。
• 为file.list、file.get和file.access新增应用资源文件夹访问方法。

详情请参见“API > 文件数据 > 文件存储”。

交换数据 exchange

exchange接口新增支持授权应用的写入和删除。

详情请参见“API > 文件数据 > 交换数据”。

地理位置 geolocation

• 新增geocodeQuery，用于获取地理位置对应的经纬度。
• 新增reverseGeocodeQuery，用于获取位置对应的省份、城市等信息。

详情请参见“API > 系统功能 > 地理位置”。

网络状态 network

新增getNetworkOperator，用于获取SIM卡的拜访地信息。

详情请参见“API > 系统功能 > 网络状态”。

设备信息 device

• 新增toLocaleDateTimeString、toLocaleDateString和toLocaleTimeString，用于将时间戳转换为和系统时间格式相同的字符串。
• device.getId从3.1.2.310版本开始mac返回值有所不同。
• 在device.getInfo(OBJECT)接口中新增返回vendorOsName和vendorOsVersion参数。

详情请参见“API > 系统功能 > 设备信息”。

系统音量 volume

setMediaValue方法传入参数与联盟对齐，也支持value。

详情请参见“API > 系统能力 > 系统音量”。

蓝牙 bluetooth

新增getDevicesBattery，用于查询华为蓝牙耳机的电量。

详情请参见“API > 系统能力 > 蓝牙”。

文本转音频 texttoaudio

新增接口。

详情请参见“API > 系统能力 > 文本转音频”。

通信 telecom

新增接口。

详情请参见“API > 系统能力 > 通信”。

多媒体 media

saveToPhotosAlbum方法中新增folderName参数。

详情请参见“API > 图形图像 > 多媒体”。

动画 animation

easing有效值新增cubic-bezier动画。

详情请参见“API > 图形图像 > 动画”。

画布 canvas

• clearRect接口清除画布内容时，建议大于画布的大小。
• shadowBlur参数在1078版本前后处理机制有所不同。
• globalCompositeOperation属性如果设置，将不支持抗锯齿的绘制PDF Canvas。

详情请参见“API > 图形图像 > 画布”。

视频 Video

新增接口，用于对视频的操作。

详情请参见“API > 图形图像 > 视频”。

密码算法 cipher

• 新增getRandomValues，用于获取随机数。
• cipher.aes(OBJECT)新增input、secretKey和initialVector 3个参数和output返回值。

详情请参见“API > 安全 > 密码算法”。

账号 account

account.authorize(OBJECT)新增参数forceLogin。

详情请参见“API > 华为服务 > 账号”。

应用内支付3.0 pay

• 新增接口，支持订阅能力和沙盒测试。
• Fail回调返回的data参数由Object型改成String型。

详情请参见“API > 华为服务 > 应用内支付3.0”。

AI ai

• bug修复。
• detectLabel新增图片分辨率建议，category新增16。
• labelContent新增128~308的内容。
• superTextImageResolution删除scale，修改示例代码。
• detectBarcode的languageType固定返回为1。
• getWordSegment的type类型由Number变成String。
• getWordPos的type类型由Number变成String，增加备注。

详情请参见“API > 华为服务 > AI”

广告 ad

• 新增接口，用于在应用中实现原生广告和激励广告。
• 新增consent接口。
• nativeAd.onLoad新增source参数，用于标识广告的来源。
• 新增startDownload,resumeDownload,pauseDownload,cancelDownload，getDownloadProgress，getAppStatus，onStatusChanged，offStatusChanged，onDownloadProgress，offDownloadProgress方法用于实现下载安装原生广告的广告主App的能力。
• 新增Banner广告相关方法。
• 新增插屏广告相关方法。

详情请参见“API > 华为服务 > 广告”。

地理围栏 awareness

• 新增接口，用于对地理围栏的操作。
• 更新接口声明和导入方式，前缀由system.awareness更新为service.awareness。

详情请参见“API > 华为服务 > 地理围栏”。

用户凭据 keyring

新增接口。

详情请参见“API > 华为服务 > 用户凭据”。

实时语音识别 ml.asr

新增接口，用于实现机器学习服务提供的实时语音识别功能。

详情请参见“API > 华为服务 > 机器学习 > 实时语音识别”。

文本翻译 ml.translate

新增接口，用于实现机器学习服务提供的文本翻译功能。

详情请参见“API > 华为服务 > 机器学习 > 文本翻译”。

微信支付 wxpay

新增payScoreEnable，用于开通微信支付分，但华为手机暂不支持。

详情请参见“API > 第三方平台 > 微信支付”。

第三方分享 share

去除微博分享的能力。

详情请参见“API > 第三方平台 > 第三方分享”。

开发卡片

增加对video组件的约束说明。

详情请参见“开发卡片”。

接入推送服务

同一款快应用每天向同一个用户推送消息数目由一条变成五条。

详情请参见“接入推送服务”。

Manifest文件

• config新增 recreateOnFolding 字段，可用于控制折叠屏展开时是否加载页面。
• display的 orientation 新增auto，可使页面随系统横竖屏变化。
• 废弃display的 menu 设置，统一快应用的菜单。
• display新增 menuBarData 字段，用于设置页面菜单样式。

详情请参见“框架 > manifest文件”。

Script脚本

• 页面对象$page新增 scrollBy 和 scrollTo 方法，用于控制页面进行滚动。
• 应用生命周期新增 onRequest，onShow 和 onHide。

详情请参见“框架 >script脚本”。

通用事件

通用事件新增 animationstart，animationiteration和animationend，用于控制CSS动画。

详情请参见“组件 > 通用设置 > 通用事件”。

通用方法

• 新增 addEventListener 通用方法，用于监听CSS动画事件。
• 新增 toTempFilePath 通用方法，用于将组件的内容保存为图片。
• 新增 getBoundingClientRect 通用方法，用于获取当前组件的布局位置。

详情请参见“组件 > 通用设置 > 通用方法”。

动画样式

动画样式的 @keyframes 属性支持按百分比写法。

详情请参见“组件 > 通用设置 > 动画样式”。

<camera>

新增 autoorientation 属性，用于设置图片是否随设备重力方向发生变化调整。

详情请参见“组件 > camera”。

<list>

• 新增 scrollBy 属性，用于控制 list 从当前位置进行滑动。
• scrollTo方法新增 behavior 属性，用于控制是否进行平滑滚动。
• 新增 layout-type 样式，用于控制子元素是按网格展示还是瀑布流展示。

详情请参见“组件 > list”。

<list-item>

column-span 样式，适配 list 的 layout-type 不同设置，控制 list-item 在 list 中所占的列数。

详情请参见“组件 > list-item”。

<map>

• 新增 showscale 属性和 setScalePosition 方法，用于控制默认的比例尺控件的展示和位置。
• 新增 showzoom 属性和 setZoomPosition 方法，用于控制放大缩小功能控件的展示和位置。
• 新增 setCompassPosition 方法，用于控制指南针控件的位置。

详情请参见“组件 > map”。

<progress>

新增 layer-color 样式，用于控制进度条的背景颜色。

详情请参见“组件 > progress”。

<richtext>

新增 start 和 complete 事件，用于监听 richtext 开始加载和完成加载实例。

详情请参见“组件 > richtext”。

<switch>

新增 thumb-color 和 track-color 样式，用于控制滑块和滑轨的颜色。

详情请参见“组件 > switch”。

<video>

新增 orientation 属性，用于控制视频进入全屏时的布局方向。

详情请参见“组件 > video”。

<web>

• 新增 supportzoom 属性，用于控制网页是否支持放大缩小。
• 新增 showloadingdialog 属性，用于控制是否展示加载进度条。
• 新增 algorithmsforlayout、wideviewport、overviewmodeinload 属性，用于透传webview的能力，辅助开发者适配手机上展示的效果。
• 新增 multiwindow、jumppolicy、openinbrowserurl 属性，用于控制web组件多窗口行为。
• 新增 xrequestedwithpolicy 属性，用于控制web组件发送http/https请求的头域x-requested-with的值。

详情请参见“组件 > web”。

页面路由 router

• 新增getPages方法，用于获取当前页面栈列表。
• router.push的params新增参数___PARAM_LAUNCH_NATIVE_FLAG___，用于在打开原生应用页面时添加Flag，
• 新增参数___PARAM_PAGE_ANIMATION___，用于控制页面跳转时的动画类型。

详情请参见“API > 基本功能 > 页面路由”。

后台运行 resident

新增接口，用于控制快应用在后台运行。

详情请参见“API > 基本功能 > 后台运行”。

打开网页 webview

loadUrl新增 showloadingdialog 参数，用于控制是否展示加载进度条。

详情请参见“API > 界面交互 > 打开网页”。

通知消息 notification

• 新增 postDelayedShow 方法，用于设置延时显示通知。
• 新增 cancelDelayedShow 方法，用于取消处在延时状态的通知消息。

详情请参见“API > 界面交互 > 通知消息”。

传感器 sensor

subscribeCompass回调函数新增accuracy参数，用于获取传感器的精度。

详情请参见“API > 系统功能 > 传感器”。

地理位置 geolocation

• 新增 openLocation 方法，使用快应用内置地图查看位置。
• 新增 chooseLocation 方法，可以打开地图选择位置。

详情请参见“API > 系统功能 > 地理位置”。

网络状态 network

• 新增 getSimOperator 方法，用于获取Sim卡的运营商信息。
• subscribe 方法的 type 新增返回 5g、bluetooth、other类型。

详情请参见“API > 系统功能 > 网络状态”。

设备信息 device

新增 getCountryCode 方法，用于获取当前快应用中心华为账号的注册国家地信息。

详情请参见“API > 系统功能 > 设备信息”。

应用配置 configuration

• 新增 getLayoutDirection 方法，用于获取当前系统的语言方向。
• 新增 setScreenOrientation 方法，用于设置屏幕方向。
• 新增 formatDateAndTime 和 simpleFormatDate方法，用于将时间戳转换为需要格式的时间字符串。

详情请参见“API > 系统功能 > 应用配置”。

广告

新增接口，用于实现原生广告和激励视频广告。

详情请参见“API > 华为服务 > 广告”。

Manifest文件

• 新增trustedSslDomains，可配置可信的https站点。
• router新增errorPage字段，可以自定义错误页面；如果不配置的话，在页面跳转异常时，会跳转到系统默认的错误页。
• config新增network字段，可进行网络超时。
• 配置designWidth增加配置成device-width的能力。

详情请参见“框架 > manifest文件”。

Script脚本

• 页面对象$page新增query属性，可获取页面参数。生命周期增加onConfigurationChanged，可监听应用配置的变化。
• 增加onPageNotFound，当引擎导航到错误页面时触发。

详情请参见“框架 >script脚本”。

通用设置

增加getViewId方法，获取组件的nodeId。

详情请参见“组件 > 通用设置 > 通用方法”。

<image>

从本版本开始，如果没有设置占位图，快应用引擎自动填充颜色为#ccc的灰色占位图。如果不要默认占位图，需设置alt为blank。

详情请参见“组件 > image”。

<input>

新增caret-color样式，可以自定义光标颜色。

详情请参见“组件 > input”。

<list>

scrollTo方法新增smooth属性，可设置页面平滑滚动。

详情请参见“组件 > list”。

<list-item>

解决在list-item内部使用 if 和 for，导致DOM结构不一致的问题。

详情请参见“组件 > list-item”。

<textarea>

新增onlinechange事件，监听输入框行数变化。

详情请参见“组件 > textarea”。

文件存储 file

• get新增recursive参数，表示是否递归获取子目录文件列表，新增返回type和subFile，表示文件类型和文件列表。
• writeText、writeArrayBuffer新增append参数，表示是否为追加模式。
• 新增access、mkdir和rmdir方法。

详情请参见“API > 文件数据 > 文件存储”。

传感器 sensor

subscribeAccelerometer新增interval参数，用于设置监听回调函数的执行频率。

详情请参见“API > 系统功能 > 传感器”。

设备信息 device

• getInfo和getInfoSync新增返回marketingName字段，表示机型的传播名。
• 新增getServiceCountryCode方法，用于获取当前快应用中心的服务地信息。
• 新增getOAID方法，用于获取匿名设备标识符。

详情请参见“API > 系统功能 > 设备信息”。

屏幕亮度 brightness

新增setKeepScreenOn方法，可设置是否保持常亮状态。

详情请参见“API > 系统功能 > 屏幕亮度”。

应用配置 configuration

新增接口，用于设置和获取当前语言环境。

详情请参见“API > 系统功能 > 应用配置”。

解压缩 zip

新增接口，用于解压压缩文件。

详情请参见“API > 系统功能 > 解压缩”。

多媒体 media

• takePhoto、takeVideo、pickImage、pickVideo和pickFile方法新增返回name和size，用于获取文件名和大小。
• 新增pickImages、pickVideos、pickFiles 三个方法。

详情请参见“API > 图形图像 > 多媒体”。

支付 pay

新增productPay、getProductDetails、getPurchaseInfo和getOrderDetail四个方法，支持PMS支付。

详情请参见“API > 华为服务 > 支付”。

Manifest文件

• 新增 launchMode 属性，用于声明页面的启动模式。
• 新增 statusBarImmersive、statusBarTextStyle、statusBarBackgroundColor和statusBarBackgroundOpacity 属性，用于设置沉浸式标题栏，以及标题栏的样式。

详情请参见“框架 > manifest文件”。

template模板

支持自定义过滤器。

详情请参见“框架 > template模板” 。

Script脚本

• 页面级组件新增计算属性。
• 页面对象$page，新增 statusBarHeight 属性可获取当前页面的状态栏高度；新增 windowWidth 属性，获取当前页面的可使用窗口宽度；新增 windowHeight 属性，获取当前页面可使用窗口高度。

详情请参见“框架 >script脚本”。

通用设置

touches对象属性新增 offsetX 和 offsetY。

详情请参见“组件 > 通用设置 > 通用事件”。

<map>

map组件新增 polygons 属性，可绘制多边形；新增polylines子属性 arrowLine 和 arrowIconPath ，可绘制带纹理的线。

详情请参见“组件 > map”。

<slider>

新增支持block-color样式，用于设置滑块的颜色。

详情请参见“组件 > slider”。

<slot>

新增组件，可设置默认内容，支持具名插槽。

详情请参见“组件 > slot”。

<span>

支持嵌套span组件。

详情请参见“组件 > span”。

<stack>

新增 fullscreenchange 事件，进入和退出全屏时触发；新增 requestFullscreen 方法，请求进入全屏模式。

详情请参见“组件 > stack”。

<video>

新增 requestFullscreen 方法，请求进入全屏模式。

详情请参见“组件 > video”。

应用上下文 app

新增 app.getPackageInfo，可以获取本地已安装应用的信息。

详情请参见“API > 基本功能 > 应用上下文”。

页面路由 router

router.push 新增快应用启动参数 ___PARAM_LAUNCH_FLAG___。

详情请参见“API > 基本功能 > 页面路由”。

数据存储 storage

新增 key 方法，用于获取某个index对应的key名称。

详情请参见“API > 文件数据 > 数据存储”。

交换数据 exchange

新增接口，实现数据发布方和快应用数据的交互。

详情请参见“API > 文件数据 > 交换数据”。

设备信息 device

device.getInfo 新增 emuiApiLevel，获取系统的api版本号。

详情请参见“API > 系统能力 > 设备信息”。

画布 canvas

新增 toTempFilePath 方法，用于将指定区域的内容导出生成指定大小的图片。

详情请参见“API > 图形图像 > 画布”。

声音音频 audio

新增 getPlayState 方法，获取当前播放状态数据。

详情请参见“API > 音频 > 声音音频”。

账号 account

新增account.isLogin，可检查HMS Core的华为账号是否已经登录。

详情请参见“API > 华为服务 > 账号”。

Script脚本

公共方法增加getApp方法。

详情请参见“框架 >script脚本”。

通用属性

常规属性增加data属性。

详情请参见“组件 > 通用设置 > 通用属性”。

<marquee>

新增 marquee 组件，用于设置文字走马灯。

详情请参见“组件 > marquee”。

应用上下文 app

app.getInfo增加返回icon、packageName信息，可获取应用的图标路径和包名信息。

详情请参见“API > 基本功能 > 应用上下文”。

传感器 sensor

新增sensor.subscribeStepCounter和sensor.unsubscribeStepCounter，可监听和取消监听计步传感器数据。

详情请参见“API > 系统功能 > 传感器”。

设备信息 device

新增device.getSerial，可获取设备序列号。device.getId、device.getDeviceId、device.getUserId 在系统版本号为10.0及以上将无法获取数据。

详情请参见“API > 系统功能 > 设备信息”。

MediaQuery

新增接口，用于实现响应式布局的能力。

详情请参见“API > 系统能力 > MediaQuery”。

Script脚本

增加获取orientation的方法。

详情请参见“框架 >script脚本”。

<map>

• 新增 showcompass（是否显示指南针）、enableoverlooking（是否启用俯视3D功能）、enablezoom（是否支持缩放）、enablescroll（是否支持拖动）、enablerotate（是否支持旋转） 属性。
• markers子属性增加label，新增markers-label子属性，可在标记点周边显示文本；markers-callout子属性增加convertHtml，支持展示HTML内容。

详情请参见“组件 > map”。

<swiper>

• 新增 duration（设置滑动动画时长）、vertical（是否纵向滑动）属性；
• 新增top | left | right | bottom样式，可用于设置indicator相对于swiper的位置。

详情请参见“组件 > swiper”。

<web>

支持H5页面input标签的拍照、录视频、录音频，支持音频、视频、图片文件的选择。

详情请参见“组件 > web”。

设备信息 device

• device.getInfo增加返回timeZone、emuiVer、fontScale、characteristics、windowLogicWidth、windowLogicHeight信息。
• 新增getInfoSync、onFontScaleChange接口。

详情请参见“API > 系统能力 > 设备信息”。

蓝牙 bluetooth

新增支持蓝牙功能。

详情请参见“API > 系统能力 > 蓝牙”。

图片处理 image

新增image.pickColor接口，根据图片生成颜色值，用于获取背景或悬浮文字颜色。

详情请参见“API > 图形图像 > 图片处理”。

画布 canvas

canvas.createRadialGradient删除x1、y1、r1三个参数。

详情请参见“API > 图形图像 > 画布”。

接入推送服务

通知栏支持设置是否震动和显示呼吸灯。

详情请参见“接入推送服务”。

通用事件

新增resize通用事件。

详情请参见“组件 > 通用设置 > 通用事件”。

<camera>

新增camera组件，用于提供拍照功能。

详情请参见“组件 > camera”。

<div>

样式flex-direction类型新增row-reverse和column-reverse。

详情请参见“组件 > div”。

<image>

样式增加object-fit，后续将替代原有的resize-mode。

详情请参见“组件 > image”。

<list>

样式flex-direction类型新增row-reverse和column-reverse，新增scrollend和touchup事件。

详情请参见“组件 > list”。

页面路由 router

router.push的uri参数支持设置跳转另一个快应用页面、快应用的权限管理界面和手机系统的位置管理界面。

详情请参见“API > 基本功能 > 页面路由”。

打开网页 webview

补充示例代码。

详情请参见：API > 界面交互 > 打开网页。

数据存储 storage

storage.set、storage.clear和storage.delete在1035版本后，success回调返回值data为success。

详情请参见“API > 文件数据 > 数据存储”。

文件存储 file

file.get的uri支持tmp类型的uri。

详情请参见“API > 文件数据 > 文件存储”。

地理位置 geolocation

geolocation.getLocation和geolocation.subscribe的success回调返回值增加返回accuracy和time信息。

详情请参见“API > 系统能力 > 地理位置”。

设备信息 device

device.getInfo的success回调返回值增加返回screenDensity信息。

详情请参见“API > 系统能力 > 设备信息”。

闹钟 alarm

新增接口，开发者调用此接口可以设置闹钟。

详情请参见“API > 系统能力 > 闹钟”。

多媒体 media

• 新增接口setRingtone和getRingtone，开发者调用接口可以设置铃声。
• 新增接口previewImage，开发者调用接口可以预览图片。

详情请参见“API > 图形图像 > 多媒体”。

图片处理 image

新增接口getExifAttributes和setExifAttributes，开发者调用接口可以设置和获取图片的exif信息。

详情请参见“API > 图形图像 > 图片处理”。

画布 canvas

新增接口getLineDash和使用图片对象画图的介绍。

详情请参见“API > 图形图像 > 画布”。

声音音频 audio

新增streamType属性，开发者可通过此属性设置音频的类型。

详情请参见“API > 音频 > 声音音频”。

Script脚本的页面方法

新增name、component和path方法的说明，用于获取manifest中当前页面的名称、Path和组件名称。

详情请参见“框架 > script脚本”中的“页面方法”章节。

Script脚本的应用生命周期

新增onError接口，当应用出现错误时调用。

详情请参见“框架 > script脚本”中的“应用生命周期”章节。

Manifest文件

display部分新增orientation属性，支持设置页面为横屏或者竖屏。

详情请参见“框架 > manifest文件”中的“display”章节。

font-face样式

新增font-face样式的设置，支持开发者使用已有的字体文件来设置自定义的字体。

详情请参见“组件 > 通用设置 > font-face样式”。

<canvas>

新增canvas组件，用于定义一个画布，在画布上可以绘制图形或图片。

详情请参见“组件 > canvas”。

<image>

src属性新增支持矢量图svg（暂不支持动画和滤镜）。

详情请参见“组件 > image”。

<input>

type属性支持动态修改。

新增font-family样式的设置，支持四种系统原生字体：normal , sans-serif , serif , monospace。开发者可以通过设置该样式来改变字体。

font-weight样式新增支持类型：500、600、700、800、900、bolder为粗体，其他为正常字体。

新增selectionchange事件，在input组件中选中字符串的范围发生变化时触发。

详情请参见“组件 > input”。

<map>

新增map组件，用于提供地图功能。

详情请参见“组件 > map”。

<option>

• 新增font-family样式的设置，支持四种系统原生字体：normal , sans-serif , serif , monospace。开发者可以通过设置该样式来改变字体。
• font-weight样式新增支持类型：500、600、700、800、900、bolder为粗体，其他为正常字体。

详情请参见“组件 > option”。

<select>

新增font-family样式的设置，支持四种系统原生字体：normal , sans-serif , serif , monospace。开发者可以通过设置该样式来改变字体。

详情请参见“组件 > select”。

<span>

• 新增font-family样式的设置，支持四种系统原生字体：normal , sans-serif , serif , monospace。开发者可以通过设置该样式来改变字体。
• font-weight样式新增支持类型：500、600、700、800、900、bolder为粗体，其他为正常字体。

详情请参见“组件 > span”。

<text>

• 新增font-family样式的设置，支持四种系统原生字体：normal , sans-serif , serif , monospace。开发者可以通过设置该样式来改变字体。
• font-weight样式新增支持类型：500、600、700、800、900、bolder为粗体，其他为正常字体。

详情请参见“组件 > text”。

<textarea>

• 新增font-family样式的设置，支持四种系统原生字体：normal , sans-serif , serif , monospace。开发者可以通过设置该样式来改变字体。
• font-weight样式新增支持类型：500、600、700、800、900、bolder为粗体，其他为正常字体。
• 新增selectionchange事件，在textarea组件中选中字符串的范围发生变化时触发。

详情请参见“组件 >textarea”。

<video>

新增muted属性，用于控制视频播放时是否静音。

详情请参见“组件 > video”。

<web>

• 新增allowthirdpartycookies属性，用于设置是否支持跨域cookies传递。
• 新增支持全屏播放web组件中的视频。如果原web组件没有对返回键进行处理，开发者需要新增返回键处理以实现全屏后点击返回键能够恢复非全屏状态。

详情请参见“组件 > web”。

打开网页 webview

webview.loadUrl新增allowthirdpartycookies参数，用于设置是否支持跨域cookies传递。

详情请参见“API > 界面交互 > 打开网页”。

网络访问 fetch

fetch.fetch的data参数新增支持ArrayBuffer类型，同时新增responseType参数，从而增强开发者对返回数据类型控制。

详情请参见“API > 网络访问 > 数据请求”。

桌面图标 shortcut

shortcut.install新增message参数，在创建桌面快捷方式时，能够设置更有针对性的提示信息，从而增加创建桌面快捷方式的成功率。

详情请参见“API > 系统能力 > 桌面图标”。

设备信息 device

设备信息新增platform对象，通过该对象的versionCode属性，可以获取平台的版本号。

详情请参见“API > 系统功能 > 设备信息”。

画布 canvas

新增接口，开发者调用此接口可以画布上进行绘图，以及对图形进行操作。

详情请参见“API > 图形图像 > 画布”。

震动 vibrator

原有震动接口只支持1s长时震动的能力，为了支持短时震动，对vibrate接口扩展了参数以支持短时震动。

详情请参见“API > 系统能力> 震动”。

AI

新增接口，开发者调用此接口可以实现AI相关功能。

详情请参见“API > 华为服务 > AI”。

第三方分享 share

新增getAvailablePlatforms接口，用于获取当前可用的支持分享的平台列表。

详情请参见“API > 第三方平台 > 第三方分享”。

通用事件

新增target和touches对象属性的说明。

详情请参见“组件 > 通用设置 > 通用事件”。

通用样式

background-image支持使用网络图片。

详情请参见“组件 >通用设置 > 通用样式”。

<div>

justify-content样式新增支持设置为space-around。

详情请参见“组件 > div”。

<refresh>

为了支持<refresh>组件实现下拉刷新效果，<refresh>组件新增了属性type的设置。开发者可以在<refresh>组件补充type的设置，默认设置为“material”，未设置的<refresh>组件均按“material”处理。

详情请参见“组件 >refresh”。

<image>

新增支持complete和error事件，开发者可以在事件回调中对图片加载成功和失败进行处理。

详情请参见“组件 > image”。

<text>

为了支持文本组件对字符间距的设置，组件<text>新增了样式letter-spacing的设置。

详情请参见“组件 >text”。

<web>

• 新增了文件下载能力。开发者使用<web>组件打开的页面，点击下载链接后，将弹框提示下载，下载内容保存在sd卡的Download文件夹中。
• 新增message属性，通过onmessage事件和postMessage方法可实现网页与快应用双向通讯数据能力。

详情请参见“组件 > web”。

页面路由 router

router.back 新增path和delta参数，开发者调用一次接口可以返回多个页面。

详情请参见“API > 基本功能 > 页面路由”。

弹窗 prompt

prompt.showToast 新增image和gravity参数，开发者可以自定义toast的图片和位置。

详情请参见“API > 界面交互 > 弹窗”。

打开网页 webview

webview 新增文件下载能力，点击下载链接，下载文件保存至sd卡的Download文件夹。

详情请参见“API > 界面交互 > 打开网页”。

websocket

新增接口，用于websocket通信。

详情请参见“API > 网络访问 > websocket”。

桌面图标 shortcut

新增systemPromptEnabled属性，开发者通过此属性可以控制是否由系统来提示创建快捷方式。

详情请参见“API > 系统能力 > 桌面图标”。

设备信息 device

device.getInfo(OBJECT)接口新增 windowWidth、windowHeight、statusBarHeight和pixelRatio 4个返回值。

详情请参见“API > 系统功能 > 设备信息”。

动画 animation

新增接口，开发者调用此接口可以在组件中使用动画效果。

详情请参见“API > 图形图像 > 动画”。

声音音频 audio

新增stop方法，开发者通过此方法可实现停止音频的播放。

详情请参见“API > 音频 > 声音音频”。

账号 account

• account.authorize 新增 openid, unionid, nickname, avatar 4个返回值。
• 新增account.checkUserSession 接口，用于判断用户登录状态是否有效。

详情请参见“API > 华为服务 > 账号”。

Script脚本的页面级组件

自定义组件的props增加支持Object的类型，可用于进行类型检测、校验、设置默认值等。

详情请参见“框架 > script脚本”中的“页面级组件”章节。

通用事件

开发者可以在组件上绑定touch事件，实现用户触摸组件后的功能处理。

详情请参见“组件 > 通用设置 > 通用事件”。

通用样式

• background-image支持.9.png图片，开发者可以设置.9.png图片作为组件的背景。
• 新增background-position样式，开发者可以设置background-position来定位背景图。

详情请参见“组件 >通用设置 > 通用样式”。

<div>

• 支持active伪类效果。
• flex布局样式新增align-self，开发者可以定义flex子项单独在侧轴（纵轴）方向上的对齐方式。

详情请参见“组件 > div”。

<image>

支持active伪类效果。

<input>

• 支持active伪类效果。
• 增加maxlength和enterkeytype属性，新增select、setSelectionRange、getSelectionRange方法。
• 开发者可以通过设置maxlength属性来控制输入框可输入最多的字符数量；通过设置enterkeytype属性来控制软键盘Enter按钮的显示文本。
• change事件增加enterkeyclick参数可用于设置软键盘enter键点击事件。

详情请参见“组件 > input”。

<text>

支持active伪类效果。

<progress>

支持active伪类效果。

<rating>

支持active伪类效果。

<picker>

• 支持active伪类效果。
• 新增支持多列选择器。

详情请参见“组件 > picker”。

<slider>

支持active伪类效果。

<switch>

支持active伪类效果。

<textarea>

• 支持active伪类效果。
• 新增maxlength属性，新支持select、setSelectionRange和getSelectionRange方法。
• 开发者可以通过设置maxlength属性来控制输入框可输入的最多字符数量。通过新增的3个方法对选中文本框进行控制。

详情请参见“组件 > textarea”。

<list>

scroll事件增加scrollState设置。

开发者可以通过设置scrollState来控制列表滑动状态。

• 0：列表正在滑动
• 1：列表正在通过用户的手势滑动
• 2：列表正在滑动，用户已松手

详情请参见“组件 > list”。

<swiper>

• 新增loop属性。
• 开发者可以通过设置loop属性来控制是否开启循环模式，默认值为true。

详情请参见“组件 > swiper”。

<video>

• 新增controls属性。
• 开发者可以通过设置controls属性来控制视频播放控制条的显示和隐藏。默认为true表示由平台控制显示或隐藏，设置为false则不显示平台的控制条。

详情请参见“组件 > video”。

通用规则

异步接口支持返回Promise的方式，方便开发者实现以async的方式编写代码，增强代码的可读性与控制。

详情请参见“API > 通用规则 > 异步接口”。

文件存储 file

新增4个接口：

● file.writeText：将文本内容写入指定文件。

● file.writeArrayBuffer：将内容写入Buffer。

● file.readArrayBuffer：从Buffer中读取内容。

● file.readText：读取文本内容。

详情请参见“API > 文件数据 > 文件存储”。

地理位置 geolocation

新增geolocation.getLocationType接口，通过该接口可获取当前系统支持的定位类型。

详情请参见“API > 系统能力 > 地理位置”。

录音 record

record.start接口新增参数可供开发者设置录音时长、录音格式、采样率、录音通道数、编码码率。

详情请参见“API > 系统能力 > 录音”。

上传下载 request

request.download接口新增description和filename参数，可供开发者设置下载描述和下载文件名。

详情请参见“API > 网络访问 > 上传下载”。

多媒体 media

新增2个接口：

● media.saveToPhotosAlbum：将图片/视频文件保存到相册中。

● media.pickFile：选择文件。

详情请参见“API > 图形图像 > 多媒体”。

发送短信 sms

新增接口，开发者调用此接口可以实现发送短信功能。

详情请参见“API > 系统能力 > 发送短信”。

联系人 contact

新增接口，开发者调用此接口可以实现获取某个联系人的姓名和电话。

详情请参见“API > 系统能力 > 联系人”。

Wifi

新增接口，开发者调用此接口可以查询Wi-Fi、链接Wi-Fi、监听Wi-Fi连接情况。

详情请参见“API > 系统能力 > Wifi”。