# 安装
提示
- uv-ui 现在只推荐使用
easycom
,如自己引用组件,可能会出现组件找不到的问题。 - 除了npm下载需要
easycom
配置 和vue.config.js
配置,其他可以不进行任何配置即可直接在页面中使用组件,建议重新运行下项目。 - 强烈建议了解扩展配置功能,如果需要使用组件库内部的API等工具,需要进行扩展配置。
- 如果你在安装组件之前就运行了项目,那么安装配置好后,需要重新启动项目,以微信小程序为例:关闭微信编辑器,最好是删除一次unpackage文件,然后重新运行项目,一般就可正常运行。如果不这样做,很有可能存在缓存,你怎么刷新都没用。
# HbuilderX 方式(推荐)
# 插件市场下载入口:https://ext.dcloud.net.cn/plugin?name=uv-ui (opens new window)
如果您是使用 Hbuilder X
开发的用户,您可以在 uni-app
插件市场通过 uni_modules
的形式进行安装,此安装方式可以方便您后续在 uni_modules
对 uv-ui
进行一键升级,右键uni_modules目录或右键某组件,均可进行一键升级。
- 在uni-app插件市场右上角选择
下载插件并导入HBuilderX
,导入到对应的项目中即可。
# NPM 方式
- 在项目根目录执行如下命令安装uv-ui(建议使用npm或yarn安装,其他方式可能安装后使用不了):
npm i @climblee/uv-ui
- 在项目根目录pages.json中配置easycom:
// pages.json
{
"easycom": {
"autoscan": true,
"custom": {
"^uv-(.*)": "@climblee/uv-ui/components/uv-$1/uv-$1.vue"
}
},
// 其他内容
pages:[
// ...
]
}
注意:
- vue2-cli 使用 npm 安装的组件,默认情况下 babel-loader 会忽略所有 node_modules 中的文件 ,导致条件编译失效,需要通过配置
vue.config.js
解决:
// 在根目录创建 vue.config.js 文件,并配置如下
module.exports = {
transpileDependencies: ['@climblee/uv-ui']
}
# 其他方式
- 在插件市场 uv-ui (opens new window)或uv-ui的git仓库 (opens new window),直接下载uv-ui的项目包。
- 将uv-ui项目的uni_modules复制到自己的项目中即可,和方式一导入的方式类似。