DCloud_UNI_HT
DCloud_UNI_HT
  • 发布:2019-04-16 10:33
  • 更新:2020-01-07 14:22
  • 阅读:83708

uni-app新老编译模式差异说明

分类:uni-app

uni-app 自 1.8版本开始,同时支持两种编译模式:

  • template模板模式:老框架模式,借鉴自mpvue,将用户编写的Vue组件,编译为WXML中的模板(template),变相实现组件化开发,性能差,支持 Vue 语法少,比如不支持过滤器。
  • 自定义组件模式:新框架模式,DCloud自研,将用户编写的Vue组件,编译为微信小程序自定义组件,实现了更高的性能更完善的 Vue 语法支持。同时在App端提供了独立的js引擎,大幅提升性能

如何切换编译模式

manifest.json 的源码视图里配置是否启用新编译器, manifest.json -> %platform% -> usingComponents 切换编译模式。

%platform% 是指平台名称

// manifest.json    
{    
    // ...    
     /* App平台特有配置 */    
    "app-plus": {    
        "usingComponents":true //是否启用`自定义组件模式`,为true表示新的`自定义组件模式` ,否则为`template模板模式`   
    }    
    /* 微信小程序特有配置 */    
    "mp-weixin": {    
        "usingComponents":true //是否启用`自定义组件模式`,为true表示新的`自定义组件模式`,否则为`template模板模式`   
    }    
  // ...  
} 

在HBuilderX的manifest的可视化界面,每个平台的也都有配置勾选。

manifest.json配置文件中,未明确指定编译模式(即未配置%platform% -> usingComponents),则uni-app默认策略如下:

  • HbuilderX 2.3.0 正式版之前的版本为保证历史项目兼容,默认使用老编译器(template模板模式),即不配置的情况下效果等同于 usingComponents: false,而 HbuilderX 2.3.0 正式版之后,默认会启用新编译器(自定义组件模式),即不配置的情况下效果等同于 usingComponents: true,从 HbuilderX 2.3.8 正式版开始将停止支持非自定义组件模式,届时,新版HBuilderX真机运行和云打包,都不再支持非自定义组件模式。HBuilderX的云打包,只向下保留2个版本。再升级1个版本后,老版打包机也不再支持非自定义组件模式。详见https://ask.dcloud.net.cn/article/36385
  • HBuilderX Alpha 为开发者提供最新技术尝鲜,默认会启用新编译器(自定义组件模式),即不配置的情况下效果等同于 usingComponents: true
  • CLI 开发模式下的,默认编译策略同 HBuidlerX 正式版策略

Tips:

  • 切换编译环境之后,请重新运行项目

非自定义组件模式升级为自定义组件模式注意

自定义组件模式虽然兼容大部分老模式的写法,但也有部分不兼容。老项目升级时,可能需要修改部分代码,请详细参考自定义组件模式开发注意事项:https://ask.dcloud.net.cn/article/35851

不同编译模式支持的Vue语法差异

自定义组件模式模板模式都不支持的 vue 语法:

  • class不支持绑定Obejct变量(使用字符串的形式绑定)
  • 不支持事件修饰符:prevent、passive(在App与小程序平台,使用stop修饰符,既可以阻止冒泡也能阻止默认行为)
  • 不支持render、inline-template、X-Templates、keep-alive、transition
  • 不支持使用 Vue.use 的方式注册全局组件(在main.js使用Vue.component的方式引入)

template模板模式除了不支持如上Vue语法外,额外还不支持如下语法:

  • 不支持过滤器 filter
  • 不支持比较复杂的 JavaScript 渲染表达式
  • 不支持在 template 内使用 methods 中的函数
  • 不支持 v-html
  • 不支持 v-slot 新语法及后备内容
  • 不支持解构插槽 Prop 设置默认值
  • 组件不支持原生事件绑定,如:@tap.native
  • 组件不支持通过class绑定样式

问题反馈

  • 如果在使用 uni-app 的过程中遇到问题,先认真阅读下 如何准确地反馈 uni-app 的问题 再发帖咨询。
  • 在不要在本文章下留言报bug,请发布新帖,并将帖子地址复制到回复栏,并简短说明bug。

扩展阅读

9 关注 分享
DCloud_UNI_CHB Trust linux-user@163.com 617404917@qq.com 377313813@qq.com 1750352431@qq.com skysowe 1203606379@qq.com ydflys@163.com

要回复文章请先登录注册

stringutils@163.com

stringutils@163.com

本来就是图个简单,弄成这样,我也是服了。
能不能不要这么坑爹,直接让客户自己选择是新编译模式还是旧的,表示不知道官方么想的,居然一刀切
2020-01-07 14:22
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 新兰:
不能,新编译模式如果报错的话,也是有对应的解决方案的,建议发单帖说明问题,新编译模式肯定是要老编译模式支持度更高的。
2019-12-16 11:18
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 lun1bz@163.com:
看一下你的样式怎么写的?如果能提供一个 简单的demo最好
2019-12-16 11:17
DCloud_UNI_HT

DCloud_UNI_HT (作者)

回复 852871771@qq.com:
引用的什么第三方组件?报什么组件,单开帖子描述一下
2019-12-16 11:15
852871771@qq.com

852871771@qq.com

哎 引用个第三方的组件一直在报错,切换完模式,编译是过了,但是整个项目都挂了。
2019-12-14 20:40
lun1bz@163.com

lun1bz@163.com

真的不知道怎么用,支付宝的写好了微信的样式没了,微信写好了支付宝又炸了
2019-11-27 10:51
新兰

新兰

新的编译模式太坑了,建议大家不要轻易的切换,麻烦问一下11.14更新之后的客户端版本,还能采用非自定义组件的编译模式吗?
2019-11-19 19:04
1764600907@qq.com

1764600907@qq.com

前几天遇见插槽的问题了,现在高级的插槽只能解构插槽,,,,而且编辑器每次修改就要重新启动微信开发工具运行,不然就不能正常显示,问题多的一批,太麻烦了
2019-11-12 14:10
386377268@qq.com

386377268@qq.com

回复 386377268@qq.com:
而且
2019-10-30 22:53
386377268@qq.com

386377268@qq.com

回复 coln@foxmail.com:
同意,而已还很难得到支持
2019-10-30 22:53