微信小程序 Skyline 基础组件支持与差异

通用特性

特性 支持情况
无障碍访问 暂时只支持 aria-role、label、hidden、disabled
深色模式 支持
原生组件 都支持同层渲染
WeUI v2 支持

组件支持情况

总体来说,常用的组件基本都已经支持,已经标记为废弃的特性在 Skyline 下不会考虑支持。下面列出基础组件的整体情况,具体细节可以跳转到对应组件文档查看。

组件
支持情况 组件差异与备注
text 基本支持 内联文本只能用 text 组件;可以通过 span 组件与 text 或 image 内联;
view / cover-view 完全支持 涉及文本节点请参考 text 组件
image / cover-image 基本支持 SVG 支持度已经完善;部分不常用的 mode 未支持
button 完全支持
scroll-view 完全支持 需要显式指定 type="list";部分属性不需要对齐;额外支持大量新特性
swiper / swiper-item 完全支持 增强了大量特性
input / textarea 完全支持 光标选区、菜单略有不同
navigator 完全支持 只能嵌套 text 组件或文本节点;可以通过 span 组件与 text 或 image 内联
map 完全支持 开发者工具暂时不支持调试,请使用真机预览
canvas 完全支持 开发者工具暂时不支持调试,请使用真机预览
radio / radio-group 完全支持
label 完全支持
video 基本支持 全屏在 3.3.0 版本已经支持,投屏暂时不支持,开发者工具暂时不支持调试,请使用真机预览
checkbox / checkbox-group 完全支持
picker 完全支持
camera 完全支持 开发者工具暂时不支持调试,请使用真机预览
root-portal 完全支持
form 完全支持
ad 完全支持
official-account 完全支持
functional-page-navigator 支持中
live-player / live-pusher 完全支持
picker-view 基本支持 indicator-class 和 mask-style 属性暂时不支持
voip-room 完全支持
rich-text 完全支持 渲染结果可能略有不同,涉及到样式支持度;当 mode=web 时则完全与 webview 对齐
match-media 待考虑
keyboard-accessary 待考虑 可以通过 input 的 worklet:onkeyboardheightchange 回调实现
page-meta 基本支持 与全局滚动相关的属性不支持
editor 暂不考虑
web-view 暂不考虑 建议承载 web-view 的页面单独配置 "renderer": "webview"
movable-area / movable-view 暂不考虑 可以用手势配合 worklet 动画方案替代
page-container 基本支持
share-element 完全支持 与 WebView 使用方式不同,特性有所增强
icon 完全支持
progress 暂不考虑
slider 完全支持
switch 完全支持
xr-frame 暂未支持
navigation-bar 不考虑 Skyline 只能用自定义导航
open-data 完全支持 已废弃的特性不支持

Skyline 新增组件

组件
组件说明
span 用于支持内联文本和 image、navigator 的混排
snapshot 截图组件
sticky-header、sticky-section 吸顶布局容器
nested-scroll-header、nested-scroll-body 嵌套 scroll-view 场景中使用的节点,仅支持作为 <scroll-view type="nested"> 模式的直接子节点
list-view 列表布局容器,仅支持作为 <scroll-view type="custom"> 模式的直接子节点或 sticky-section 组件的直接子节点
grid-view Skyline 下的网格布局容器和瀑布流布局容器
draggable-sheet 半屏可拖拽组件
double-tap-gesture-handler 双击时触发手势
force-press-gesture-handler iPhone 设备重按时触发手势
horizontal-drag-gesture-handler 横向滑动时触发手势
long-press-gesture-handler 长按时触发手势
pan-gesture-handler 拖动(横向或纵向)时触发手势
scale-gesture-handler 多指缩放时触发手势
tap-gesture-handler 点击时触发手势
vertical-drag-gesture-handler 纵向滑动时触发手势

快速体验

环境要求

目前,安卓微信 8.0.33、iOS 微信 8.0.34 起内置了 Skyline 渲染引擎,可先更新到该版本,预览时通过强切开关打开,方可体验 Skyline。

快速体验

以下微信小程序已适配 Skyline,可直接扫码打开体验。

扫码打开微信小程序助手,其中首页、切换微信小程序、版本查看、成员管理和成员申请均已适配。

扫码微信小程序示例,可进入 交互动画 tab 页体验 Skyline 的新特性。

演示案例

以下是用 Skyline 实现的各种常见交互动画的示例,可通过视频直接预览效果,也可直接扫码在移动端上体验。

通讯录
使用 scroll-view 自定义模式,配合 sticky 吸顶布局容器,实现通讯录字母交错吸顶的效果。
点击查看源代码
半屏
基于 worklet 动画,通过手势协商机制,实现在半屏内列表往下拉到顶之后,无缝切换到半屏下拉的效果。
点击查看源代码
分段半屏
通过 worklet 动画、手势协商,实现分段半屏,处于不同位置时联动半屏后的地图改变缩放比例。
点击查看源代码
相册
使用自定义路由、共享元素动画、手势系统等实现列表中图片共享放大过渡到图片预览页效果,并实现预览图片的手势交互。
点击查看源代码
Tab 指示条
利用 swiper 切换时的逐帧回调,配合 worklet 动画实现 tab 指示条顺滑切换的效果。
点击查看源代码
卡片转场
scroll-view 瀑布流模式配合共享元素动画实现卡片柔性转场效果。
点击查看源代码
搜索栏吸附
scroll-view 吸顶布局结合 worklet 布局轻松实现搜索栏吸附效果。
点击查看源代码
沉浸式商品浏览
微信小程序手势 + worklet 在页面中实现广告、商品无缝切换。
点击查看源代码

Skyline 渲染引擎 / 概览 / 性能对比

性能对比

首屏耗时是衡量渲染性能一个最重要的指标。微信小程序的首屏耗时可以从上一个页面的点击到下一个页面 FCP(First Contentful Paint)的时间来衡量,首屏性能的好坏会影响上一个页面点击时的响应速度,以及下一个页面的白屏时间。

目前已经有一些微信小程序以 Skyline 模式在线上运行,以下取微信小程序助手的线上数据,可以看出 Skyline 的首屏时间比 WebView 快 66%,并且手机性能越低端,差异就越明显。

在内存占用方面,由于线上微信小程序未能较准确获取内存数据,我们在本地收集了一些测量数据,测量方法均是测 n 次取平均值,并且采用两个指标,一个是打开微信小程序示例首页,静置 30s 后采集数据,另一个是切 Tab 页面,同样静默后采集数据。

测量数据如下图所示(单位 M),可以看出,单个页面 Skyline 的占用比 WebView 减少 35%,两个页面 Skyline 的内存占用比 WebView 减少 50%,随着打开的页面变多,内存差距越明显。

与内存占用的测量类似,CPU 利用率的测量数据如下图所示(单位 %),也能看出,Skyline 相对 WebView 也有不错的提升。

效果对比

这里,我们分别录制了微信小程序助手在 Skyline 与 WebView 下的操作视频,从视频中的对比可以更直观地感受到区别。

视频录制的测试机为 OPPO R17,其中左边是 Skyline,右边是 WebView

特性

Skyline 以性能为首要目标,因此 CSS 特性上在满足基本需求的前提下进行了大幅精简,目前 Skyline 只保留更现代的 CSS 集合。另一方面,Skyline 又添加了大量的特性,使开发者能够构建出类原生体验的微信小程序。在编码上,Skyline 与 WebView 模式保持一致,仍使用 WXML 和 WXSS 编写界面。在不采用 Skyline 新增特性的情况下,适配了 Skyline 的微信小程序在低版本或未支持 Skyline 的平台上可无缝自动退回到 WebView 渲染。

支持与 WebView 混合使用

微信小程序支持页面使用 WebView 或 Skyline 任一模式进行渲染,Skyline 页面可以和 WebView 页面混跳,故开发者可以页面粒度或分包粒度按需适配。

// page.json
// skyline 渲染
{
    "renderer": "skyline"
}

// webview 渲染
{
    "renderer": "webview"
}
// app.json
{
  "subPackages": [
    {
      "root": "packageA",
      "pages": ["pages/cat"],
      "componentFramework": "glass-easel",
      "renderer": "skyline",
    },
  ],
}


提供更好的性能

Skyline 在渲染流程上较 WebView 更为精简,其对节点的渲染有着更精确的控制,尽量避免不可见区域的布局和绘制,以此来保证更高的渲染性能。WebView 由于其整体设计不同以及兼容性等问题,渲染流水线的实现更加冗长复杂。

在光栅化策略上,Skyline 采用的是同步光栅化的策略,WebView 是异步分块光栅化的策略。两种策略各有千秋,但 WebView 的策略存在一些难以规避的问题,例如:快速滚动会出现白屏问题;滚动过程中的 DOM 更新会出现不同步的问题,进而影响到用户体验。

在此基础上,我们还进一步实现了很多优化点。

1. 单线程版本组件框架

Skyline 下默认启用了新版本的组件框架 glass-easel,该版本适应了 Skyline 的单线程模型,使得建树流程的耗时有效降低(优化 30%-40%),同时 setData 调用也不再有通信开销和序列化开销。

2. 组件下沉

Skyline 内置组件的行为更接近原生体验,部分内置组件(如 scroll-view、swiper 等)借助于底层实现,有更好的性能和交互体验。同时,我们将部分内置组件(如 view、text、image 等)从 JS 下沉到原生实现,相当于原生 DOM 节点,降低了创建组件的开销(优化了 30% 左右)。

3.长列表按需渲染

长列表是一个常用的但又经常遇到性能瓶颈的场景,Skyline 对其做了一些优化,使 scroll-view 组件只渲染在屏节点(用法上有一定的约束),并且增加 lazy mount 机制优化首次渲染长列表的性能,后续我们也计划在组件框架层面进一步支持 scroll-view 的可回收机制,以更大程度降低创建节点的开销。

4. WXSS 预编译

同 WebView 传输 WXSS 文本不同,Skyline 在后台构建微信小程序代码包时会将 WXSS 预编译为二进制文件,在运行时直接读取二进制文件获得样式表结构,避免了运行时解析的开销(预编译较运行时解析快 5 倍以上)。

5. 样式计算更快

Skyline 通过精简 WXSS 特性大幅简化了样式计算的流程。在样式更新上,与 WebView 全量计算不同,Skyline 使用局部样式更新,可以避免对 DOM 树的多次遍历。Skyline 与微信小程序框架结合也更为紧密,例如: Skyline 结合组件系统实现了 WXSS 样式隔离、基于 wx:for 实现了节点样式共享(相比于 WebView 推测式样式共享更为精确、高效)。在节点变更、内联样式和继承样式的更新上,Skyline 也进行了一些优化,从而保证样式计算的性能。

此外,对于 rpx 单位,我们直接在样式计算阶段原生支持,这样避免了在 JS 层面做太多额外的计算。

<!-- 样式共享目前暂未自动识别,可手动声明 list-item 属性开启 -->
<scroll-view type="list" scroll-y>
    <view wx:for="{{list}}" list-item>{{index}}</view>
</scroll-view>

6. 降低内存占用

在 WebView 渲染模式下,一个微信小程序页面对应一个 WebView 实例,并且每个页面会重复注入一些公共资源。而 Skyline 只有 AppService 线程,且多个 Skyline 页面会运行在同一个渲染引擎实例下,因此页面占用内存能够降低很多,还能做到更细粒度的页面间资源共享(如全局样式、公共代码、缓存资源等)。


根除旧有架构的问题

在基于 Web 体系的架构下,微信小程序的部分基础体验会受限于 WebView 提供的能力(特别是 iOS WKWebView 限制更大一些),使得一些技术方案无法做得很完美,留下一些潜在的问题。

1. 原生组件同层渲染更稳定

iOS 下原生组件同层渲染的原理先前有介绍过,本质上是在 WKWebView 黑盒下一种取巧的实现方式,并不能完美融合到 WKWebView 的渲染流程,因此很容易在一些特殊的样式发生变化后,同层渲染会失效。在 Skyline 下可以很好地融合到渲染流程中,因此会更稳定。

2. 无需页面恢复机制

iOS 下 WKWebView 会受操作系统统一管理,当内存紧张时,操作系统就会将不在屏的 WKWebView 回收,会使得微信小程序除前台以外的页面丢失,虽然在页面返回时,我们对页面做了恢复,但页面的状态并不能 100% 还原。在 Skyline 下则不再有该问题。

3. 无页面栈层数限制

由于 WebView 的内存占用较大,页面层级最多有 10 层,而 Skyline 在内存方面更有优势,因此在连续 Skyline 页面跳转(复用同一引擎实例)的情况下,不再有该限制。


全新的交互动画体系

要达到类原生应用的体验,除渲染性能要好外,做好交互动画也很关键。在 Web 体系下,难以做到像素级可控,交互动画衔接不顺畅,究其原因,在于缺失了一些重要的能力。为此,Skyline 提供一套全新的交互动画能力。

1. Worklet 动画

Worklet 机制是 Skyline 交互动画体系的基础,它能够很方便地将 JavaScript 代码跑在渲染线程,那么基于 Worklet 机制的 动画模块,便能够在渲染线程同步运行动画相关逻辑,使动画不再会有延迟掉帧。

2. 手势系统

在原生应用的交互动画里,手势识别与协商是一个很重要的特性,而这块在 Web 体系下是缺失的,因此 Skyline 提供了基于 Worklet 机制的 手势系统。

  • 支持常用手势的识别,如缩放、拖动、双击等,并能够渲染线程同步监听手势、执行手势相关逻辑;
  • 支持手势协商处理,能够在遇到手势冲突(常见于滚动容器下)时决定让哪个手势生效,以实现更顺畅的动画衔接。

3. 自定义路由

页面间中转进行自定义的转场动画,在原生应用里也是一个很常见的交互动画。在原来的微信小程序架构下,每个页面都是独立的 WebView 渲染,互相隔离,其跨页能力是基本不具备的。因此,Skyline 提供了基于 Worklet 机制的 自定义路由模块,能实现市面上大多数页面转场动画效果。

4. 共享元素动画

支持 跨页面共享元素,能够很方便地将上一个页面的元素“共享”到下一个页面,并伴随着过渡动画,同时支持了一套可定制化接口,能实现自定义的过渡动画。

5. 内置组件扩展

对内置组件的扩展也是重要一环,特别是 scroll-view 组件,很多交互动画与滚动息息相关,Skyline 添加了很多在 Web 下很难做到又非常重要的特性。

  • 内置下拉刷新的实现,并完善相关事件。原来 WebView 的实现基于 transform,性能不够好且动画衔接不顺畅。
  • 提供“下拉二楼”交互的机制。
  • 提供 sticky 吸顶组件,能很方便地实现吸顶元素交错切换。
  • 使 scroll-view 组件在内容未溢出时也能滚动,让用户得到及时的交互反馈。
  • 为 scroll-view 组件提供更多控制能力,如最小触发滚动距离(min-drag-distance)、滚动结束事件(scrollend)、滚动原因(isDrag)等。
  • 提供原生的 swiper 实现,相比 WebView 基于 transform 的实现,性能更好。


更多的高级能力

除了交互动画的系列能力外,借助 Skyline 的优势,我们还提供了很多高级特性。

1. 提供 grid-view 瀑布流组件

瀑布流是一种常用的列表布局方式,得益于 Skyline 在布局过程中的可控性,我们直接在底层实现并提供出来,渲染性能要比 WebView 更优。

2. 提供 snapshot 截图组件

大多数微信小程序都会基于 canvas 实现自定义分享图的功能,一方面,需要通过 canvas 绘图指令手动实现,较为繁琐;另一方面,在分享图的布局较复杂时,或者在制作长图时会受限于系统对 canvas 尺寸限制,canvas 的方案实现成本都会很大。得益于 Skyline 在渲染过程中的可控性,Skyline 能直接对 WXML 子树进行截图,因此我们直接提供了截图组件,这样能复用更完善的 WXSS 能力,极大降低开发成本。

3. scroll-view 组件支持列表反转

在聊天对话的场景下,列表的滚动常常是反向的(往底部往上滚动),若使用正向滚动来模拟会有很多多余的逻辑,而且容易出现跳动,而 scroll-view 提供的 reverse 属性很好的解决这一问题。


还有更多计划提供出来的特性,请详见特性状态

需要帮助

简介

微信小程序一直以来采用的都是 AppService 和 WebView 的双线程模型,基于 WebView 和原生控件混合渲染的方式,微信小程序优化扩展了 Web 的基础能力,保证了在移动端上有良好的性能和用户体验。Web 技术至今已有 30 多年历史,作为一款强大的渲染引擎,它有着良好的兼容性和丰富的特性。 尽管各大厂商在不断优化 Web 性能,但由于其繁重的历史包袱和复杂的渲染流程,使得 Web 在移动端的表现与原生应用仍有一定差距。

为了进一步优化微信小程序性能,提供更为接近原生的用户体验,我们在 WebView 渲染之外新增了一个渲染引擎 Skyline,其使用更精简高效的渲染管线,并带来诸多增强特性,让 Skyline 拥有更接近原生渲染的性能体验。

架构

当微信小程序基于 WebView 环境下时,WebView 的 JS 逻辑、DOM 树创建、CSS 解析、样式计算、Layout、Paint (Composite) 都发生在同一线程,在 WebView 上执行过多的 JS 逻辑可能阻塞渲染,导致界面卡顿。以此为前提,微信小程序同时考虑了性能与安全,采用了目前称为「双线程模型」的架构。

在 Skyline 环境下,我们尝试改变这一情况:Skyline 创建了一条渲染线程来负责 Layout, Composite 和 Paint 等渲染任务,并在 AppService 中划出一个独立的上下文,来运行之前 WebView 承担的 JS 逻辑、DOM 树创建等逻辑。这种新的架构相比原有的 WebView 架构,有以下特点:

  • 界面更不容易被逻辑阻塞,进一步减少卡顿
  • 无需为每个页面新建一个 JS 引擎实例(WebView),减少了内存、时间开销
  • 框架可以在页面之间共享更多的资源,进一步减少运行时内存、时间开销
  • 框架的代码之间无需再通过 JSBridge 进行数据交换,减少了大量通信时间开销

而与此同时,这个新的架构能很好地保持和原有架构的兼容性,基于 WebView 环境的微信小程序代码基本上无需任何改动即可直接在新的架构下运行。WXS 由于被移到 AppService 中,虽然逻辑本身无需改动,但询问页面信息等接口会变为异步,效率也可能有所下降;为此,我们同时推出了新的 Worklet 机制,它比原有的 WXS 更靠近渲染流程,用以高性能地构建各种复杂的动画效果。

新的渲染流程如下图所示:

如果在使用过程中遇到任何问题,可以前往「Skyline 渲染引擎」专区查看说明。