安装
说明
由于uView使用easycom
模式,让您无需引入组件即可直接使用,但是此功能需要Hbuilder X 2.5.5及以上版本才支持,详见配置easycom组件模式。 easycom
打包的时候是按需引入的,您可以放心引入uView的整个组件库,打包的会自动剔除您没有使用的组件。
npm安装
使用npm的方式安装,能更方便进行升级。
- 如果您的项目是通过vue-cli模式创建的, 无需手动npm安装
scss
,因为已内置scss
。
注意: 此下载方式必须要按照npm方式安装的配置中的说明配置了才可用,且项目名称不能有中文字符。
注意!
由于HX编译错误的原因的,目前(2020-05-06)不支持通过cnpm安装uView,这意味着您只能通过npm安装uView,如果您的网络无法使用npm, 那就使用下载的方式安装,等HX修复此问题,可以使用cnpm的时候,我们会撤销此通告。
// 如果您的项目是HX创建的,根目录又没有package.json文件的话,请先执行如下命令:
// npm init -y
// 安装
npm install uview-ui
// 更新
npm update uview-ui
下载安装
使用下载的方式安装,能更方便阅读源码,但是每次升级都需要重新下载并覆盖uview-ui
文件夹。
- 如果您的项目是由HBuilder X创建的标准uni-app项目,解压后将
uview-ui
文件夹,复制到项目根目录。 - 如果您的项目是由vue-cli模式创建的, 请将下载解压的
uview-ui
文件夹放到项目的src
文件夹中即可。
注意: 此下载方式必须要按照下载方式安装的配置中的说明配置了才可用。
下载地址:uView_1.2.7.zip
示例工程
此方式为一个完整的uni-app示例工程(使用Hbuilder X创建,非vue-cli模式创建), 它适用于新启动的项目,其中已包含了uView,并且做好了所有配置,让您无需任何配置,开箱即用。
说明:
- 此方式,依然需要Hbuilder X已安装
sass/scss编译
插件 - 此示例工程,默认开启V3编译器配置,以及自定义组件模式
- 如果运行出现问题,可能是您的HX版本太低,请升级至最新稳定版尝试解决
下载地址:uView_demo_1.2.7.zip
演示项目
此方式为整个uView演示项目,里面有uView核心,组件演示,模板等,建议用户可以下载 此项目运行用于查看UI演示效果,复制模板案例,通过里面的示例,可以快速掌握某一个组件的用法。
下载地址:uView_1.2.7_full.zip
注意
演示项目不适用于直接开发中,它只是演示用的,可以直接运行并查看效果。
如果在微信开发工具真机预览时,提示分包太大运行的问题,请在HBuilder X
进行设置:菜单栏 运行 -> 运行到小程序模拟器,在下拉菜单中勾选“运行时是否压缩代码”
版本查询
有两种方式可以查询到正在使用的uView的版本:
- 通过
console.log
打印的形式
console.log(this.$u.config.v);
// 或者(二者等价)
console.log(this.$u.config.version);
- 通过源码查看的形式
可以查阅uView的配置文件得知当前版本号,具体位置为”/uview-ui/libs/config/config.js”。