起步
在已有的 Ray 项目或原生小程序中选一个已注册的页面,并用支持 Nova 的 App 预览。
选择第一个页面
先看页面是否使用了浏览器绘图、RJS 或第三方网页脚本。设备详情和设置页通常以小程序组件为主,可以优先迁移。地图页如果需要在地图上放按钮,也可以用来体验同层渲染。主要功能依赖浏览器绘图或网页脚本的页面,可以继续使用 WebView。
例如选择设备设置页时,可以先在 WebView 里打开页面、修改一次设置,再返回。切换后用同样的入口和步骤检查。如果还在选页面,参照我的页面适合用哪一种。
设置页面渲染方式
在 Ray 项目中,将 renderer: 'nova' 合并到对应页面的 index.config.ts,即可选择 Nova。
原生小程序在与页面同名的 .json 文件中添加该字段。
页面配置优先于应用的默认配置。两处都未配置时使用 WebView。如果应用默认使用 Nova,个别页面仍可以显式配置 renderer: 'webview'。
预览这个页面
在目标 App 中确认文字和图片正常显示,执行该页的主要操作,再返回并重新进入。页面有键盘、地图或播放器时,也试用对应的交互。如果原页面无法显示,先用示例体验里的简单页面确认配置,再检查常见问题。