升级指南

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

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，其他保持不变。

对此您有两个选择：

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

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

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

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

具体操作如下：

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

注意：

  1. 必须要将标签加入lang="scss"属性以支持SCSS，否则会出错！
  2. 请将将引入的代码，写在style标签的首行。
  1. <style lang="scss">
  2.     /* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
  3.     @import "@/uview-ui/index.scss";
  5.     /* ......其他的样式 */
  6. </style>
  • 在项目根目录的uni.scss中，删除原来的@import '@/uview-ui/theme.scss';一行，改成如下：
  1. // 删除原来的这一行
  2. // @import '@/uview-ui/index.scss';
  4. // 加入这一行
  5. @import '@/uview-ui/theme.scss';