DCloud_heavensoft
DCloud_heavensoft
  • 发布:2019-04-17 02:51
  • 更新:2023-08-25 16:09
  • 阅读:56055

uni-app各环节版本兼容性说明

分类:uni-app

此文档停止维护,最新的文档见:uni版本说明

uni-app是一个跨度很大的产品,支持多种开发ide、HBuilderX有正式版和alpha版、支持cli和普通项目、支持很多端、有云打包app和本地打包app、编译器模式支持老的模板模式和新的自定义组件模式。
它们都会升级,如果出现一个升级、另一个未升级的情况,可能会运行异常。

正常情况,HBuilderX升级后,其自带的app运行基座、uni-app编译器、云打包配套引擎会同步升级。但在开发者使用cli创建项目、使用自定义基座、使用5+sdk离线打包时,就需要手动维护版本更新。

我们经常遇到的误报问题是:“我的HBuilderX已经是最新版了,升级日志里提到的已解决问题,为什么没有仍然存在?”,其实有的是因为cli项目下编译器是旧的、有的是因为本地打包的sdk是旧的,有的是因为自定义基座的版本是旧的。

  • 如果你使用cli创建项目(即项目根目录是package.json),不管用什么ide,即便是用HBuilderX,切记cli项目的编译器是在项目下的,HBuilderX不管怎么升级都不会影响编译器版本。你需要手动npm update来升级编译器。以及如果你想要安装less、scss等预编译器,也需要自己npm安装在项目下,而不是在HBuilderX的插件管理里安装。

  • 如果你使用离线打包,请注意HBuilderX升级后,真机运行基座和云打包对应引擎跟随HBuilderX升级,而你的sdk需要手动升级。sdk的版本升级一般滞后HBuilderX正式版升级一两天。在这里下载最新版

  • 如果你使用自定义基座,之前制作的自定义基座是不会跟随HBuilderX升级的,升级HBuilderX后你应该重新制作新版自定义基座。

  • 如果你使用wgt升级,新版HBuilderX编译的wgt,运行到之前的runtime上,一定要先测试好,看有没有兼容性问题。如果有问题,就不要wgt升级,整包升级。

  • 考虑到向下兼容,uni-app编译器在升级为新的自定义组件模式后,同时保留了对老编译模式的向下兼容。
    在HBuilderX alpha版中,App端一定会使用新编译器,不理会manifest配置。
    在HBuilderX 正式版中,新创建的项目会使用新编译器,老项目不会强制使用,而是开发者自己在manifest里配置开启。

  • 如果你使用其他ide开发uni-app,会经常因为拼错单词而运行失败,因为经过webpack编译一道,很多错误反应的不够直观,排错时间很长,不如从开始就依赖有良好提示的HBuilderX,避免敲错单词。

  • 云打包的引擎版本说明
    自HBuilderX 3.9起,云打包机版本保留了多个可用的版本,具体可用的云端打包版本参考下方的版本对应表。
    打包时,服务端会根据用户使用的HBuilderX或cli版本去匹配最合适的打包机,规则如下(匹配优先级从高到低):

    1. HBuilderX或cli版本与云端版本完全一致;
    2. HBuilderX或cli版本的大版本号与云端一致时,使用该大版本的最新版本;如打包机上有[3.92, 3.93, 3.99, 4.01, 4.10],则3.91使用3.99打包机。
    3. 当以上规则无法匹配时,使用云端最新版本。

举个例子:
当云打包机有以下版本[3.7.11,3.8.12,3.92, 3.93, 3.99, 4.01, 4.15]可用时:

  • 如果HBuilderX使用3.7.11,3.8.12,3.92, 3.93, 3.99, 4.08, 4.15这些版本时,版本号完全匹配,直接使用同版本号打包机;
  • 如果HBuilderX使用3.7.3,则云端打包机使用3.7.11版本;HBuilderX使用3.91,则云端打包机使用3.99版本;HBuilderX使用4.01版本,则云端打包机使用4.08版本;
  • 如果HBuilderX使用3.7以下的版本,则云端打包机使用最新版本4.15。

很多人在报问题时不说清自己的情况,导致别人给出错误的回答。
很多人在搜问题时没注意看条件,导致使用了并不适用于自己的错误方案。

要想问题少,推荐使用HBuilderX完成一切工作,包括创建项目、运行编译、云打包app。
因为在这套体系里,官方会对很多常见的问题做出提醒和引导,减少问题的概率。随着HBuilderX的升级,uni-app编译器、真机运行基座、云打包引擎都会升级。

版本列表

下面提供 uni-app 开发中各产品的版本对应表:

11 关注 分享
Trust 萌龙 DCloud_HB_WDL 5***@qq.com yqs 杨大宝 8***@qq.com albearcat 2***@qq.com 风云杭州 南黎

要回复文章请先登录注册

清蒸鱼

清蒸鱼

还需要一些对应关系,uni版本与vue3具体版本,iOS以及安卓系统的最低支持版本
2023-08-25 16:09
南黎

南黎

。。。。
2023-08-11 14:08
易软

易软

回复 易软 :
写错了 是13
2023-08-08 16:56
易软

易软

请问 现在 我使用3.8.7 推送使用的是 1.0 是不是不支持Android 14 了 .Android 14 的手机的应用管理中的通知权限被置灰了 无法点击
2023-08-08 16:40
DCloud_App_Array

DCloud_App_Array

回复 makeit :
云端打包并没有保留所有老版本打包机,目前HBuilderX最低版本是3.1.22。因此建议你更新到最新版本,如果nvue页面横竖屏引起的布局乱问题可以参考:https://uniapp.dcloud.io/frame?id=%e5%b0%ba%e5%af%b8%e5%8d%95%e4%bd%8d 中 dynamicRpx 说明。
2021-11-15 16:40
makeit

makeit

回复 makeit :
我的一台测试android机,android系统v4.4.2, 除了3.0.7外,其他版本video点全屏都闪退。


直到3.2.12修复了video点全屏闪退问题,但是3.2.12又带来其他问题,布局乱了,video多次动态修改播放地址app闪退。目前没法升级到3.2.12.
2021-11-12 01:05
makeit

makeit

回复 makeit :
我的一台测试android机,android系统v4.4.2, 除了3.0.7外,其他版本video都闪退。

直到3.2.12修复了video闪退问题,但是3.2.12又带来其他问题,布局乱了,video多次动态修改播放地址app闪退。目前没法升级到3.2.12.
2021-11-12 01:03
makeit

makeit

我想打包 3.0.7版本,其他版本video全屏都闪退,直到3.2.12修复了video闪退问题,但是3.2.12又带了其他问题,目前没法升级到3.2.12.

这个问题怎么办,有什么办法能打包3.0.7版本??
2021-11-12 01:00
3***@qq.com

3***@qq.com

对应iOS、Anroid版本有不?
2021-03-21 11:48
m***@126.com

m***@126.com

回复 m***@126.com :
和mui
2020-10-21 11:29