有赞微信小程序接入Skyline的实践
原创 有赞共享技术 2025-09-03 11:19 浙江
![]()
本文讲述了有赞微信小程序接入 skyline 引擎,来实现我们的打开商详场景的“秒开”效果
有赞微信小程序接入Skyline的实践
小程序与移动端体验
移动端技术早期主要由两大平台主导:从 Web 演变而来的H5技术,以及手机厂商的原生(Native)技术。受限于当时的技术与开发效率,许多厂商依然选择 H5 承载业务,并借助 Hybrid 方案调用原生能力。微信小程序作为轻量化应用的早期探索者,为此提供了标准化的解决方案。
随着移动端技术持续进步,用户对体验的要求不断提高。习惯原生应用流畅体验的用户,对 Hybrid 等类 Web 方案体验感受越来越差。而微信小程序基于 Webview 引擎的原因,也没法实现更多 Native 的体验。为提升用户体验,微信小程序进行了技术革新,推出Skyline渲染引擎,显著提升了渲染性能与交互流畅度,使小程序的用户体验接近原生应用。

针对电商的高频场景,商品列表打开商详,我们从技术发展的角度,给大家一些案例,直观的感受下不同技术实现能带来的体验差别。
我们先对比 传统 Web 和 微信小程序,传统 Web 跳转切页有明显的 loading 加载过程。而微信小程序的技术架构,让整个切页加载体验有了大幅提升。


再看看,小红书、淘宝等原生 APP 的切页过程。


很明显,原生 APP 在同样的跳转交互下,做到了更优的体验。其中有几个关键的细节:
新页面在展开过程中,无白屏、闪动的现象。
整个展开过程,有过渡动画,由点击卡片向全屏展开
打开速度非常快,秒级直出。
有赞小程序在对部分页面接入 Skyline 引擎后,持续优化。最终实现了类似原生体验的路由切换效果,整个跳转过程做到了首帧无白屏,包含过渡效果,并且达到秒级直出。
先看效果:![]()
接下来我们对整个优化的几个关键点做具体介绍。
如何实现页面切换首帧无白屏
什么是首帧?
有赞对于首帧的定义是切页出现后,用户看到的第一帧画面。
图中红色区域标记的为用户看到的第一帧画面,即为首帧。

哪些内容可以进入首帧渲染?
只要在组件 attached 生命周期前(含)通过 setData 设置上去,就会在首帧渲染。微信文档[1]
官方文档未明确说明数据注入的姿势,考虑大家实际的业务场景,我们这里需要对比同步数据和等待异步数据两种注入方式。
// 示例数据const testContent = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit…………';data() {content: '';}// 同步代码示例attached() {this.setData({content: testContent});}// 异步代码示例attached() {setTimeout(() => {this.setData({content: testContent});}, 200) // 200ms 模拟等待异步执行}


关注切页后的【红色文字内容】,只有通过同步注入,才能在首帧进行渲染展示。而异步注入的内容,则会错过首帧渲染,直到页面打开之后才展示。
那是不是只要在 Webview 引擎下保证首屏数据在 attached 周期注入,就能确保“首帧无白屏”了呢?我们通过简单的实验来验证。
我们首先验证最简单的场景,在 Webview 下直接注入首屏数据,观测是否能实现首帧无白屏渲染。
实验一:Webview 下直接注入数据
// 示例数据const testContent = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit…………';data() {content: '';}// 同步代码示例attached() {this.setData({content: testContent});}

结论:Webview 在 attached 直接注入简单数据,可实现首帧无白屏。
少量的数据往往是在验证阶段编写 demo 采用的。但实际业务情况是,页面的首屏会有大量数据,并包含一系列的执行逻辑和计算过程。我们用实验二来模拟更接近实际的运行场景。模拟的方式是加一段阻塞代码,模拟业务逻辑执行等。
实验二:Webview 下模拟大量计算逻辑后注入
// 示例数据const testContent = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit…………';data() {content: '';}attached() {function sleep(ms) {const start = Date.now();while (Date.now() - start < ms) {// 空循环,持续检查时间差}}sleep(1000); // 模拟计算逻辑阻塞this.setData({content: testContent});}

结论:在 attached 中包含一定量的计算逻辑后,Webview 路由先完成,渲染后完成,会产生白屏闪一下的问题。
实验三:Skyline 下模拟大量计算逻辑后注入
// 代码同实验二

结论:在同场景下,Skyline 切页过程是渲染先完成,路由动画后完成,整个过程无白屏。
通过上面的实验,我们可以得出结论,Skyline 即使在有数据逻辑阻塞下,也能保证首屏内容的稳定输出。接下来,我们还可以继续对 首屏数据 和 路由动画这两个点进行深度优化。
首屏数据准备
首屏数据作为首屏渲染的关键依赖,想要更加顺畅的提升速度。可以有以下思路进行优化:
在前一页面预加载下一页首屏数据,抽象一个预加载模块,专门用于商品信息预加载的逻辑。
拆分下一页数据,仅保留首屏视窗内可见的数据。
服务端承担部分计算逻辑,确保页面拿到数据可以直出。
路由动画接入
在 Skyline 引擎下,使用微信内置的 open-container 组件,可以轻松实现和原生页面切换一样的路由动画效果。还支持多种切换模式,以及自定义配置。官方文档[2]
<open-container class="card-item" bind:tap="goDetail"><small-card class="card-item" /></open-container>

从上面的分析中,我们发现 Skyline 包含诸多优秀的新特性,可以让用户体验进一步提升。接下来我们简单介绍下 Skyline 引擎如何接入,以及在接入过程中需要注意的地方。
接入 Skyline 引擎
Skyline 以性能为首要目标,因此 CSS 特性上在满足基本需求的前提下进行了大幅精简,目前 Skyline 只保留更现代的 CSS 集合。另一方面,Skyline 又添加了大量的特性,使开发者能够构建出类原生体验的小程序。小程序支持页面使用 WebView 或 Skyline 任一模式进行渲染,Skyline 页面可以和 WebView 页面混跳。 所有从 Webview 引擎的页面接入 Skyline 引擎后,页面大概率会出现样式结构错乱的。我们适配的重点,就在于 样式和结构上的调整。
样式和结构的适配调整,包含诸多细节,这里只列举了常见的问题,更多细节调整可以参考官方文档。
样式适配
在 Skyline 下 text-overflow:ellipsis,仅用于 text 组件,原先如果是 view 组件实现的,会出现文字超长无法省略,可以用 text 重新实现。
结构适配
在 Skyline 下,overflow 不支持 scroll 属性,只能通过 scroll-view 实现;不支持单独设置 overflow-x/y。
Skyline 配置
小程序对于 Skyline 引擎的使用是具体到页面的,并不需要考虑整体小程序切换的影响,可以渐进式,对部分页面进行逐步升级。接入的话,需要分别 app.json 和页面的 index.json 写入配置代码。
// app.json"rendererOptions": {"skyline": {"defaultDisplayBlock": true,"defaultContentBox": true,"tagNameStyleIsolation": "legacy",}},"lazyCodeLoading": "requiredComponents",// 页面 index.json"renderer": "skyline","componentFramework": "glass-easel",
灰度上线
为保证线上商家小程序稳定,有赞 Skyline 小程序上线过程中,灰度控制是重要的一环。 我们的灰度包含两个环节控制
有赞内部的小程序灰度机制,对商家进行分流,部分商家接入 Skyline 版本,部分接入Webview 版本。
微信提供的 Skyline 灰度机制。针对终端用户的灰度筛选,控制项包含微信版本、基础库版本等。官方文档[3]
// app.json// 可分别控制 基础库、iOS、Android、鸿蒙设备微信版本"rendererOptions": {"skyline": {"disableABTest": true,"sdkVersionBegin": "3.0.1", // 基础库最低版本"sdkVersionEnd": "15.255.255", // 填最大值,否则之后的新版本会不生效"iosVersionBegin": "x.y.z", // iOS 微信最低版本"iosVersionEnd": "15.255.255", // 填最大值,否则之后的新版本会不生效"androidVersionBegin": "x.y.z", // 安卓微信最低版本"androidVersionEnd": "15.255.255", // 填最大值,否则之后的新版本会不生效"ohosVersionBegin": "1.0.5", // HarmonyOS 微信最低版本"ohosVersionEnd": "15.255.255" // 填最大值,否则之后的新版本会不生效}},
结语:Skyline 特性在电商场景的更多探索
有赞微信小程序目前在 Skyline 引擎方面目前只接入了路由切换这一场景,配合数据预加载和首屏数据的优化,实现了首帧无白屏的秒开效果,当然还有更多场景可以探索,比如分段半屏,搜索栏吸附,沉浸式商品浏览等。官方Demo[4]
引用
[1]https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/share-element.html
[2]https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/open-container.html
[4]https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/experience.html
文末福利
有赞研发团队前端、后端、客户端、测试、AI开发、运维开发、数据开发等多个岗位招聘中,看机会的伙伴可以将简历发送至 zhuzhuyun@youzan.com。