# 安装

提示

  1. uv-ui 现在只推荐使用 easycom ,如自己引用组件,可能会出现组件找不到的问题。
  2. 除了npm下载需要 easycom 配置 和 vue.config.js 配置,其他可以不进行任何配置即可直接在页面中使用组件,建议重新运行下项目。
  3. 强烈建议了解扩展配置功能,如果需要使用组件库内部的API等工具,需要进行扩展配置。
  4. 如果你在安装组件之前就运行了项目,那么安装配置好后,需要重新启动项目,以微信小程序为例:关闭微信编辑器,最好是删除一次unpackage文件,然后重新运行项目,一般就可正常运行。如果不这样做,很有可能存在缓存,你怎么刷新都没用。

# HbuilderX 方式(推荐)

# 插件市场下载入口:https://ext.dcloud.net.cn/plugin?name=uv-ui (opens new window)

如果您是使用 Hbuilder X 开发的用户,您可以在 uni-app 插件市场通过 uni_modules 的形式进行安装,此安装方式可以方便您后续在 uni_modulesuv-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']
 }

# 其他方式