Skip to content

运行演示工程 ​

演示工程包含全部示例页面与工程配置,提供三种运行方式:直接导入插件市场的示例工程、下载演示源码后运行、以及在自有工程中引入授权版组件库。

前两种方式用于体验和试用,无需购买;购买会绑定你自己的 DCloud 账号下的应用,只有准备在自己的工程中长期使用时才需要(方式三)。

环境准备 ​

项要求
编辑器HBuilderX(正式版,支持 uni-app x)
可选微信开发者工具(运行小程序)、Android 真机或模拟器(运行 App)

方式一:插件市场导入示例工程(推荐体验,无需购买) ​

示例工程已作为插件发布在 DCloud 插件市场,导入后即可直接运行,无需任何额外配置,也无需购买授权。

  1. 打开 DCloud 插件市场 · uView Pro X 示例工程。
  2. 点击「下载插件并导入 HBuilderX」,在 HBuilderX 中选择一个空目录或已有项目目录作为导入位置。
  3. 导入完成后打开工程,按「运行」菜单选择目标平台即可。

在 DCloud 插件市场导入示例工程

这种方式适合快速体验全部示例,也便于对照文档查看组件的实际效果。

方式二:下载演示源码后运行(可试用,无需购买) ​

除了上面方式之外,也可以克隆演示工程的源码运行:

bash
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:

重新获取 AppID

第二步:绑定项目试用 ​

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

点击使用绑定你的项目试用

第三步:导入组件库 ​

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

点击继续导入 HBuilderX

与方式一相比,方式二只是少了一份加密版 uview-pro-x 组件库,其他配置完全一致,无需再做任何额外设置。

方式三:在自有工程中引入授权版组件库(推荐购买源码版) ​

如果要在自己的 uni-app x 项目中长期使用组件,需要购买授权版本。购买会绑定你的 DCloud 账号下的应用,两种授权版本对比如下:

版本代码保护授权交易方式
普通授权版部分源码不可见提供基于该项目和/或该服务空间的使用权、未加密部分的二次开发权买方自助下单,即买即用;买方实名信息对卖方保密
源码授权版所有代码源码可见提供基于该项目和/或该服务空间的使用权、完整的二次开发权、完整可控的基于源码审查的安全性签署带数字签名的三方电子协议,各方实名交易,插件作者可拒绝交易,先签协议后买方再付款获取源码

第一步:导入组件库 ​

在 插件市场 购买后,点击「下载插件并导入 HBuilderX」,选择你自己的目标项目。

第二步:注册组件库 ​

在 main.ts 中使用命名导入注册组件库(加密版插件不支持 default 导入):

ts
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 末尾(变量块见快速开始)。

源码授权版:源码完整可见,可直接引入主题变量文件。

scss
@import '@/uni_modules/uview-pro-x/theme.scss';

两种写法二选一

@import 与 $u-* 变量块不要同时启用:变量块会把主题变量重新声明为默认值,覆盖 theme.scss 中的取值。普通授权版只保留变量块,源码授权版只保留 @import。

第四步:配置 easycom ​

pages.json 添加 easycom 规则,ux-* 组件即可免注册使用:

json
{
  "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 ...