介绍

背景与目标

涂鸦小程序最初采用 WebView 渲染页面。开发者可以复用 Web 技术编写界面,在小程序逻辑层处理数据请求和页面状态,并通过小程序 API 控制设备、调用 App 的原生能力。

设备面板需要频繁更新状态时,渲染和触摸响应会直接影响操作体验。页面状态变化后,逻辑层把数据传给视图层,WebView 再更新节点、计算样式并完成布局和绘制。当地图、播放器等组件采用异层渲染时,App 还要协调网页内容与原生视图的尺寸、叠放顺序和触摸响应。例如,把定位按钮叠在扫地机地图上,既要让按钮能响应点击,也要让用户能在按钮之外拖动地图。

在启动阶段,代码包预下载、运行环境预加载和内存缓存可以减少打开小程序时的准备工作。资源和运行环境就绪之后,页面仍需创建视图、计算布局并绘制。为了继续改善首屏呈现和复杂交互,涂鸦小程序在 WebView 之外引入了原生渲染引擎 Nova,由 Nova 完成页面的样式计算、布局和绘制。

Nova 的目标是让开发者沿用现有的 Ray 或原生小程序开发方式,同时按页面选择合适的渲染引擎。设备控制、数据请求和页面导航可以继续使用小程序的写法。涉及样式、组件或视图脚本的代码,迁移时需要按 Nova 的支持范围检查。

Nova 带来的变化

在 Nova 中,普通小程序视图与受支持的原生组件可以在同一层布局和叠放。例如,扫地机地图和定位按钮可以放在同一个容器里,再用普通 view 和 z-index 设置按钮的叠放顺序。详见原生组件同层渲染。

Nova 页面可按需启用首屏即时渲染。再次打开页面时,如果资源已就绪且有可用的首屏快照,Nova 可以先显示标题、固定布局或占位内容。首屏主要内容如果依赖网络请求或设备连接,仍要等本次数据就绪。详见首屏即时渲染。

页面是怎样显示的

下面以设备详情页为例。Ray 更新 React 状态,原生小程序用 setData 更新模板数据。WebView 和 Nova 都接收这些数据,并根据各自的布局与样式规则更新界面。

---
config:
  htmlLabels: false
---
flowchart TD
    accTitle: WebView 与 Nova 的页面渲染流程
    accDescr: 两种渲染方式接收相同的页面数据。WebView 通过浏览器绘制界面,异层场景下由 App 单独显示原生视图。Nova 让普通视图与受支持的原生组件参与同层布局。
    Logic["小程序逻辑层<br/>页面状态、请求与设备控制"]
    Logic -->|页面数据| Web["WebView 视图<br/>创建或更新浏览器节点"]
    Logic -->|页面数据| Nova["Nova 视图<br/>创建或更新小程序元素"]
    Web --> Browser["浏览器计算样式<br/>布局并绘制"]
    Browser --- Native["异层场景<br/>App 单独显示原生视图"]
    Nova --> Layout["计算样式、布局并绘制<br/>原生组件可同层布局"]

需要在页面更新后读取节点尺寸,或在拖动结束时提交设备指令,可以沿用小程序的节点查询和组件事件。见页面状态与交互。

从 WebView 切换时会遇到哪些差异

原来的页面怎么写在 Nova 中怎么处理
用 cover-view 将按钮盖在异层地图上Nova 专用页面可以用普通 view。共享组件若还用于 WebView 异层场景,可保留原覆盖写法。
用 overflow: auto 让一个区域滚动使用 scroll-view,给滚动区域明确尺寸和方向。
用 RJS 改节点样式、测量位置,或调用网页绘图RJS 运行在 WebView 视图中,Nova 页面不运行 .rjs。简单显隐和样式用页面状态表达,局部交互可使用组件事件或受支持的 SJS,测量位置使用异步节点查询。
用 Web Canvas 绘图,或依赖某个网页插件先确认有没有可满足需求的 Nova 组件。功能依赖浏览器时,可保留该页面的 WebView 渲染,或把可以独立运行的网页内容放进 web-view。

原生小程序仍用 TYML 和 TYSS 编写页面,Ray 仍可使用组件及 CSS 或 Less。已有样式、组件和脚本需要按 Nova 的支持范围检查。详见样式支持与差异、基础组件支持与差异和RJS 与视图交互。

我的页面适合用哪一种

  • 先尝试 Nova。 页面主要使用小程序组件,并且希望改善连续操作的反馈,或需要将地图、播放器与页面内容一起布局。可以从一条独立路由开始,在目标 App 中检查页面打开和主要交互。
  • 保留 WebView。 页面以浏览器绘图、DOM 操作或网页插件为核心,并且暂时没有合适的替代写法。例如自由绘图页可以继续用 WebView,设备详情页可以先迁移到 Nova。
  • 按页面混用。 同一个小程序可以让不同路由选择不同的渲染方式。迁移后验证两类页面之间的进入、返回与状态恢复,再决定是否继续扩大范围。

确定要试用的页面后,参照起步设置渲染方式,或从示例体验开始。