运行演示工程
演示工程包含全部示例页面与工程配置,提供三种运行方式:直接导入插件市场的示例工程、下载演示源码后运行、以及在自有工程中引入授权版组件库。
前两种方式用于体验和试用,无需购买;购买会绑定你自己的 DCloud 账号下的应用,只有准备在自己的工程中长期使用时才需要(方式三)。
- GitHub:github.com/anyup/hello-uview-pro-x
- Gitee:gitee.com/anyup/hello-uview-pro-x
- 在线演示:h5-x.uviewpro.cn
环境准备
| 项 | 要求 |
|---|---|
| 编辑器 | HBuilderX(正式版,支持 uni-app x) |
| 可选 | 微信开发者工具(运行小程序)、Android 真机或模拟器(运行 App) |
方式一:插件市场导入示例工程(推荐体验,无需购买)
示例工程已作为插件发布在 DCloud 插件市场,导入后即可直接运行,无需任何额外配置,也无需购买授权。
- 打开 DCloud 插件市场 · uView Pro X 示例工程。
- 点击「下载插件并导入 HBuilderX」,在 HBuilderX 中选择一个空目录或已有项目目录作为导入位置。
- 导入完成后打开工程,按「运行」菜单选择目标平台即可。

这种方式适合快速体验全部示例,也便于对照文档查看组件的实际效果。
方式二:下载演示源码后运行(可试用,无需购买)
除了上面方式之外,也可以克隆演示工程的源码运行:
git clone https://github.com/anyup/hello-uview-pro-x.git
# 或
git clone https://gitee.com/anyup/hello-uview-pro-x.git克隆后用 HBuilderX「文件 → 导入 → 从本地目录导入」打开项目根目录。
第一步:重新获取 AppID
克隆下来的工程 manifest.json 里保留的是演示工程作者的 AppID,可能会提示 AppID 不可用或无法绑定到你的账号。所以需要先打开 manifest.json → 基础配置,点击「重新获取」生成属于你自己账号的 AppID:

第二步:绑定项目试用
打开 DCloud 插件市场 · uView Pro X,点击「试用」并选择刚导入的演示工程,把插件绑定到该项目进行试用。仅体验演示时无需购买授权:

第三步:导入组件库
演示工程只缺组件库本体:uni_modules 下没有 uview-pro-x,其余配置(pages.json 的 easycom 规则、main.ts 的注册、uni.scss 的 $u-* 变量块)都已在工程中。在插件页点击「继续导入 HBuilderX」,选择刚导入的演示工程,插件落到 uni_modules/uview-pro-x 后即可直接运行。

与方式一相比,方式二只是少了一份加密版 uview-pro-x 组件库,其他配置完全一致,无需再做任何额外设置。
方式三:在自有工程中引入授权版组件库(推荐购买源码版)
如果要在自己的 uni-app x 项目中长期使用组件,需要购买授权版本。购买会绑定你的 DCloud 账号下的应用,两种授权版本对比如下:
| 版本 | 代码保护 | 授权 | 交易方式 |
|---|---|---|---|
| 普通授权版 | 部分源码不可见 | 提供基于该项目和/或该服务空间的使用权、未加密部分的二次开发权 | 买方自助下单,即买即用;买方实名信息对卖方保密 |
| 源码授权版 | 所有代码源码可见 | 提供基于该项目和/或该服务空间的使用权、完整的二次开发权、完整可控的基于源码审查的安全性 | 签署带数字签名的三方电子协议,各方实名交易,插件作者可拒绝交易,先签协议后买方再付款获取源码 |
第一步:导入组件库
在 插件市场 购买后,点击「下载插件并导入 HBuilderX」,选择你自己的目标项目。
第二步:注册组件库
在 main.ts 中使用命名导入注册组件库(加密版插件不支持 default 导入):
import { uViewProX } from '@/uni_modules/uview-pro-x'
export function createApp() {
const app = createSSRApp(App)
app.use(uViewProX)
return { app }
}第三步:配置主题样式
在 uni.scss 末尾按授权版本二选一配置。
普通授权版(加密版):无法直接 @import 组件库的 theme.scss,需把 $u-* 变量块复制到 uni.scss 末尾(变量块见快速开始)。
源码授权版:源码完整可见,可直接引入主题变量文件。
@import '@/uni_modules/uview-pro-x/theme.scss';两种写法二选一
@import 与 $u-* 变量块不要同时启用:变量块会把主题变量重新声明为默认值,覆盖 theme.scss 中的取值。普通授权版只保留变量块,源码授权版只保留 @import。
第四步:配置 easycom
pages.json 添加 easycom 规则,ux-* 组件即可免注册使用:
{
"easycom": {
"autoscan": true,
"custom": {
"^ux-(.*)": "@/uni_modules/uview-pro-x/components/ux-$1/ux-$1.uvue"
}
}
}运行到各平台
在 HBuilderX 中打开工程后,通过「运行」菜单选择目标平台:
| 平台 | 操作 | 说明 |
|---|---|---|
| H5 | 运行 → 运行到浏览器 | 默认 http://localhost:9000,适合快速查看全部示例页 |
| 微信小程序 | 运行 → 运行到小程序模拟器 → 微信开发者工具 | 需在 manifest.json 填写小程序 appid,并在 HBuilderX 设置中指定微信开发者工具路径 |
| App | 运行 → 运行到手机或模拟器 | 需连接 Android 真机(开启 USB 调试)或启动模拟器,首次编译较慢 |
注意事项
- 试用只能用于打包自定义基座或在本地运行,不能用于正式发布。试用没有有效期限制。
常见问题
| 现象 | 原因 | 解决 |
|---|---|---|
编译提示 uview-pro-x 不存在 / 组件找不到 | 插件未导入到当前项目 | 在插件市场下载并导入到当前工程 |
SCSS 报 $u-type-primary 未定义 | uni.scss 未按授权版本配置 | 普通授权版加 $u-* 变量块,源码授权版加 @import |
| 提示 default 导入失败 | 使用了 import uViewProX from ... | 改为命名导入 import { uViewProX } from ... |