uView の変更点

• 追加された行はこの色です。
• 削除された行はこの色です。
• +uniapp+uView へ行く。
• +uniapp+uView の差分を削除

#author("2024-01-26T22:38:39+08:00","default:Admin","Admin")
#author("2024-01-26T22:39:46+08:00","default:Admin","Admin")
[[uni-app]]

&color(red){※前提条件：vue3 的uniapp开发};

#contents

* 安装 [#d0530c1c]

通过 Hbuilder X 的方式安装（也可以使用NPM方式，不过比较麻烦这里不介绍了。）

可以在uni-app插件市场通过uni_modules的形式进行安装，此安装方式可以方便您后续在uni_modules对uView进行一键升级。

在uni-app插件市场右上角选择uni_modules版本下的使用HBuilderX导入插件，导入到对应的项目中即可。


下载地址：
 https://ext.dcloud.net.cn/plugin?id=1593


* 配置 [#i674030e]

** 引入uView主JS库 [#nfc469e6]

在项目根目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。
 import uView from'@/uni_modules/uview-ui'Vue.use(uView)

** 再引入uView的全局SCSS主题文件 [#aa0b3951]

在项目根目录的uni.scss中引入此文件。

 @import'@/uni_modules/uview-ui/theme.scss';

** 引入uView基础样式 [#b0dec444]

注意！
在App.vue中首行的位置引入，注意给style标签加入lang="scss"属性
#codeprettify{{
<style lang="scss">
    /* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
    @import"@/uni_modules/uview-ui/index.scss";</style>
}}


** 配置easycom组件模式 [#be0b5cec]

此配置需要在项目根目录的pages.json中进行。

注意事项：
+ uni-app为了调试性能的原因，修改easycom规则不会实时生效，配置完后，您需要重启HX或者重新编译项目才能正常使用uView的功能。
+ 请确保您的pages.json中只有一个easycom字段，否则请自行合并多个引入规则。
+ 如果您是通过uni_modules形式引入uView，可以忽略此配置
#codeprettify{{
// pages.json{// 如果您是通过uni_modules形式引入uView，可以忽略此配置
"easycom":{
  "^u-(.*)":"@/uni_modules/uview-ui/components/u-$1/u-$1.vue"
},

// 此为本身已有的内容
"pages":[// ......]}
}}

* Troubleshooting [#d4cb70f6]

**　SassError: Undefined variable　XXX [#e2357001]

+ 确保安装了 scss/sass 编译插件
+ 确保安装了 scss/sass 编译插(hBuilderX　－　工具　－　插件安装　里面可以确认是否安装)
+ 在根目录下 uni.scss 文件中引入 theme.scss
+ 确保在根目录下 App.vue 文件中添加 lang="scss" 和 index.scss

#hr();
Comment：
#comment_kcaptcha