# 安装
说明
由于 uView Pro 使用
easycom
模式,让您无需引入组件即可直接使用,但是此功能需要 Hbuilder X 2.5.5 及以上版本才支持,详见配置 easycom 组件模式。easycom
打包的时候是按需引入的,您可以放心引入 uView Pro 的整个组件库,发布打包时会自动剔除您没有使用的组件(注意:调试时仍然是全部引入的)请确保您下载的Hbuilder X (opens new window)为
APP开发版
,而非标准版
,并且在"工具-插件安装"中安装了"scss/sass 编译"插件
# 方式一:npm 安装
使用 npm 的方式安装,能更方便进行升级。
- 如果您的项目是通过vue-cli (opens new window)模式创建的,
无需手动 npm 安装
scss
,因为已内置scss
。
注意: 此安装方式必须要按照npm 方式安装的配置中的说明配置了才可用,且项目名称不能有中文字符。
// 如果您的项目是HX创建的,根目录又没有package.json文件的话,请先执行如下命令:
// npm init -y
// npm 安装
npm install uview-pro
// yarn 安装
yarn add uview-pro
// pnpm 安装
pnpm add uview-pro
# 版本查询
- 通过源码查看的形式
可以查阅 uView Pro 的配置文件得知当前版本号,具体位置为 "/uview-pro/package.json" 中的 "version" 字段。
# 方式二:下载安装
使用下载的方式安装,能更方便阅读源码,但是每次升级都需要重新下载并覆盖 uview-pro
文件夹。
- 在 uni-app 插件市场右上角选择
下载并导入HBuilder X
,会直接导入到项目src
目录的uni_modules
目录中。 - 如果您的项目是由 HBuilder X 创建的标准 uni-app 项目,将下载后的
uview-pro
文件夹,复制到项目uni_modules
目录。 - 如果您的项目是由vue-cli (opens new window)模式创建的,请将下载后的
uview-pro
文件夹放到项目的src
的uni_modules
文件夹中即可。
注意: 此安装方式必须要按照下载方式安装的配置中的说明配置了才可用。
# 示例项目
此方式为整个 uView Pro 演示项目,里面有 uView Pro 核心,组件演示,模板等,建议用户可以下载 此项目运行用于查看 UI 演示效果,复制模板案例,通过里面的示例,可以快速掌握某一个组件的用法。
通过 github 或 gitee 下载 uView Pro 示例项目,在 VSCode 中运行即可。
- github:https://github.com/anyup/uview-pro (opens new window)
- gitee:https://gitee.com/anyup/uview-pro (opens new window)
pnpm install
pnpm run dev:h5
注意
演示项目不适用于直接开发中,它只是演示用的,可以直接运行并查看效果。
如果在微信开发工具真机预览时,提示分包太大运行的问题,请在HBuilder X
进行设置:菜单栏 运行 -> 运行到小程序模拟器,在下拉菜单中勾选"运行时是否压缩代码"