升级指南

优质

小牛编辑

135浏览

2023-12-01

本专题不是每次更新版本的时候都会写入内容，只有某些需要特殊留意和处理的版本升级时，才会在这里写入相关的升级指导，如果您想看看uView近来都有哪些升级记录，请移步：更新日志

1.5.8升级指导(2020-08-03)

由于1.5.6版本新增了this.$u.sys和this.$u.os属性，因为属性是初始化时执行一次，导致获取首页和内页通过this.$u.sys获取windowHeight高度可能不准确的问题，详见全局赋值设备信息的陷阱。
因此，我们在1.5.8版本中，将二者修改为方法的形式，简而言之，是需要后面加上括号，修改后为如下用法：

console.log(this.$u.sys()) 

console.log(this.$u.os())

这意味着，如果您使用了this.$u.sys和this.$u.os必须要将其修改为this.$u.sys()和this.$u.os()才行。

1.5.4升级指导(2020-07-21)

重要说明

本次升级主要针对支付宝小程序，需要项目开启支付宝小程序的component2模式(默认关闭)，做法：
在项目根目录manifest.json中新增mp-alipay属性节点，设置component2值为true：

......
"mp-alipay" : {
	"component2": true
},
......

本次升级主要针对支付宝小程序的兼容，uView目前已全面实现对支付宝小程序的兼容，前提是需要开启支付宝特有的component2模式，才能实现一些新特性和支持。
本次升级中，由于table表格组件的单元格合并模式兼容性不好，且实现方式较为复杂，不利于该组件日后的升级和扩展，故在1.5.4版本废弃了table的单元格合并模式，如果您没有使用table的单元格合并模式，则无需理会，如果使用了可以按如下方法处理：

拷贝一份uView原来的table组件，单独引入：到/uview-ui/components中把u-table、u-th、u-tr、u-td拷贝到其他目录，另起别名使用
稍微修改组件用法，使用正常的table写法，放弃单元格合并模式

1.2.8升级指导(2020-05-22)

本次升级，对Waterfall瀑布流组件进行升级，新增了可以清空和移除瀑布流列表数据的组件内部方法，需要通过ref调用，因为组件内部无法直接修改父组件的数据，所以需要您手动将原来的flow-list参数改为v-model双向绑定父组件的数据，内部才可以修改父组件的瀑布流数组数据。

1.1.9升级指导(2020-05-06)

本次升级，对swipeAction组件进行了修改，可以配置多个按钮，原本通过btn-text和btn-bg-color配置按钮的文字和背景颜色，本次升级，加入options 参数(数组)，可以配置多个按钮，详见SwipeAction 滑动操作的基本说明，另外，点击的回调事件中，返回了两个参数，一个为Props传递的index参数，另一个options按钮参数的索引。

1.1.7升级指导(2020-05-05)

本次升级，迎来了uView的一个跨越发展，uView正式支持npm方式安装，借助此方式，您不用每次都下载覆盖升级，仅执行npm update uview-ui即可，由于uView在npm的包名为uview-ui，引入时需写上import uView from "uview-ui"，旧版中下载方式安装时uView的文件夹为uview，为了规范和统一，在此1.1.7版本后，uView将以前根目录的uview文件夹，改名为uview-ui，其他保持不变。

对此您有两个选择：

uView下载解压后得到uview-ui文件夹，您可以将其改名为uview，从而覆盖原有的同名库(如果这不是您第一次下载的话)，这样您无需在pages.json、main.js、uni.scss、App.vue做出路径名称的变更(但是我们不推荐这样做)
如果您是在进行下载方式的升级，删掉(或备份)原来的uview文件夹，将uview-ui文件夹放到根目录，然后根据下载安装方式配置说明对pages.json、main.js、uni.scss、App.vue做出细微修改。(推荐此方式，一劳永逸)

1.1.4升级指导(2020-04-29)

由于本次更新，加入基础类内置样式，需要作出一些调整(修改两行代码)，原因如下：

内置样式如果放在uni.scss文件中，在微信小程序上，由于编译机制的问题，会同时被打包到全局样式文件和单独的每个页面样式文件中，可能造成分包、整包变大而无法预览或者发布。故uView对此样式进行了分拆，将基础样式类放到uView库的index.scss中，由于目前uni-app的V3版本不支持在main.js中引入，故需要在App.vue中引入，不会导致被打包到每个单独的页面样式文件中。
由于uni-app的机制，对于SCSS的变量，只能在uni.scss中引入才生效，故uView将主题样式变量相关的部分，放到了uView库的theme.scss文件中。

具体操作如下：

在App.vue中首行的位置，增加如下一行import "@/uview-ui/index.scss"：

注意：

必须要将标签加入lang="scss"属性以支持SCSS，否则会出错！
请将将引入的代码，写在style标签的首行。

<style lang="scss">
	/* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
	@import "@/uview-ui/index.scss";
	
	/* ......其他的样式 */
</style>

在项目根目录的uni.scss中，删除原来的@import '@/uview-ui/theme.scss';一行，改成如下：

// 删除原来的这一行
// @import '@/uview-ui/index.scss';

// 加入这一行
@import '@/uview-ui/theme.scss';