从 webview 迁移 -凯发app官方网站

框架概述

目录结构

native 渲染

概览

差异和兼容性

从 webview 迁移

acss 样式支持度

性能与优化

小程序全局配置

acss 语法参考

小程序页面

axml

sjs 语法参考

事件系统

自定义组件

基础能力

基础库

基础库更新日志

更新时间：2024-07-01 11:40:31

订阅更新

我的文档

设置

环境准备

native 渲染需要满足如下条件后方可开启：

●

支付宝客户端 10.5.70 或更高版本。

●

基础库 2.9.6

或更高版本。

如需真机预览生效，除符合上述支持度外，请使用 3.8.4 及以上的

小程序开发者工具（ide）版本

。

开始迁移

指定启用页面范围

对于小程序开发者，希望对小程序的所有页面/部分指定页面启用 native 渲染，可以在

app.json/${page}.json

中配置

renderer

渲染器字段，该字段有以下有效值：

字段名	可选值	默认值	作用范围
"renderer"	"native" \| "web" \| -	-	app.json / ${pagepath}.json

说明

：如需真机预览生效，除符合客户端/基础库支持度外请使用 3.8.4 及以上小程序开发者工具（ide）版本。

应用级启用

可以在

app.json

中配置

"renderer": "native"

来对小程序所有页面启用 native 渲染。

{

"pages": [...],

"renderer": "native"

}

页面级启用

可以在页面对应的 json 中

${pagepath}.json

配置

"renderer": "native"

来指定当前页面启用 native 渲染。

配置项优先级/覆盖策略

如果在一个小程序中同时配置了

app.json

和

$page.json

的

renderer

渲染器字段，将遵循如下覆盖关系：

说明：非可选值：指除了 "native", "web", undefined 以外的其他配置值

指定页面配置	应用配置	覆盖含义	页面是否启用 native 渲染
不配置 / 非可选值	"native"	以应用配置为准（"native"）	是
"native"	"native"	以页面配置为准（"native"）	是
"native"	"web"
"native"	不配置 / 非可选值
不配置 / 非可选值	"web"	以应用配置为准（"web"）	否
不配置 / 非可选值	不配置 / 非可选值	以应用配置为准（默认 "web"）	否
"web"	"native"	以页面配置为准（"web"）	否
"web"	"web"
"web"	不配置 / 非可选值

由于页面配置较全局配置具有更高的优先级，如果全局设置为 native 渲染的同时又希望指定个别页面仍使用 webview 渲染，可在该页面上配置：

指定启用客户端范围

对于小程序开发者，希望小程序仅在不低于特定客户端及基础库版本上启用 native 渲染，可以在

app.json/${page}.json

中配置

rendereroptions.native

字段。

该字段仅在应用或页面启用 native 渲染时有效（即配置

renderer: native

）。

应用级配置

在

app.json

中配置

rendereroptions.native

字段，有以下字段，默认对所有页面生效。

页面级配置

如特定页面需要独立配置生效客户端范围，那么可以在当前页面的

${pagepath}.json

中配置

rendereroptions

，格式与

app.json

内一致。

配置项优先级

页面在客户端启用 native 渲染的条件：客户端环境（包括基础库版本）同时满足

应用级配置

和

页面级配置

（如存在）

字段名	字符串类型	默认值	用途
sdkminversion	"x.y.z"	"0.0.0"	启用 native 渲染的基础库最低版本，至多 3 位版本号，不足 3 位默认填 0
iosminversion	"x.y.z"	"0.0.0"	启用 native 渲染的支付宝 ios 客户端最低版本，至多 3 位版本号，不足 3 位默认填 0
androidminversion	"x.y.z"	"0.0.0"	启用 native 渲染的支付宝 android 客户端最低版本，至多 3 位版本号，不足 3 位默认填 0

如何识别当前页面是否使用 native 渲染

通过接口判断

页面和自定义组件实例上有属性 renderer，可以用于判断当前页面或自定义组件的实际渲染引擎，如：

相关问题