铃阅时讯
❌

普通视图

有赞微信小程序接入Skyline的实践

2025年9月3日 11:19

原创 有赞共享技术 2025-09-03 11:19 浙江

本文讲述了有赞微信小程序接入 skyline 引擎,来实现我们的打开商详场景的“秒开”效果

有赞微信小程序接入Skyline的实践

小程序与移动端体验

移动端技术早期主要由两大平台主导:从 Web 演变而来的H5技术,以及手机厂商的原生(Native)技术。受限于当时的技术与开发效率,许多厂商依然选择 H5 承载业务,并借助 Hybrid 方案调用原生能力。微信小程序作为轻量化应用的早期探索者,为此提供了标准化的解决方案。

随着移动端技术持续进步,用户对体验的要求不断提高。习惯原生应用流畅体验的用户,对 Hybrid 等类 Web 方案体验感受越来越差。而微信小程序基于 Webview 引擎的原因,也没法实现更多 Native 的体验。为提升用户体验,微信小程序进行了技术革新,推出Skyline渲染引擎,显著提升了渲染性能与交互流畅度,使小程序的用户体验接近原生应用。

微信小程序
微信小程序

针对电商的高频场景,商品列表打开商详,我们从技术发展的角度,给大家一些案例,直观的感受下不同技术实现能带来的体验差别。

我们先对比 传统 Web 和 微信小程序,传统 Web 跳转切页有明显的 loading 加载过程。而微信小程序的技术架构,让整个切页加载体验有了大幅提升。

H5页面跳转
H5页面跳转
小程序跳转
小程序跳转

再看看,小红书、淘宝等原生 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 快速注入
      Webview 快速注入

      结论: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
            });
        }
        Webview
        Webview

        结论:在 attached 中包含一定量的计算逻辑后,Webview 路由先完成,渲染后完成,会产生白屏闪一下的问题。

        实验三:Skyline 下模拟大量计算逻辑后注入



          // 代码同实验二
          Skyline
          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

                [3]https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/migration/release.html#%E5%8F%91%E5%B8%83%E4%B8%8A%E7%BA%BF

                [4]https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/experience.html

                文末福利

                有赞研发团队前端、后端、客户端、测试、AI开发、运维开发、数据开发等多个岗位招聘中,看机会的伙伴可以将简历发送至 zhuzhuyun@youzan.com。

                阅读原文

                跳转微信打开

                ❌