快速上手

欢迎使用 unibestX，这是一个基于 uni-app X 的现代开发模板。本指南将帮助您快速在本地运行项目。

⚙️ 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: >= 22
• 包管理器: pnpm >= 7.30
• IDE: HBuilderX = 5.0.7

  注意

  目前大于 5.0.7 的版本在安卓编译上存在一些问题，强烈建议下载并使用 5.0.7 版本。

• Vue Official: >= 2.1.10
• TypeScript: >= 5.0
• 特定平台依赖:
  • Android: JDK >= 17, Android SDK
  • iOS: Xcode (仅 macOS 支持)
  • 鸿蒙: DevEco Studio

📂 快速开始

1. 克隆项目

将项目克隆到本地计算机：

git clone https://github.com/cq112233/unibestX.git
cd unibestX

2. 安装依赖

在控制台中执行以下命令，使用 pnpm 安装项目所需的 Node 依赖：

pnpm install

3. 打开项目

使用 HBuilderX 打开克隆下来的项目根目录。

📦 运行项目（支持热更新）

在 HBuilderX 的顶部菜单栏中，您可以选择不同的平台来启动运行：

• Android 平台：选择 运行 → 运行到手机或模拟器，然后选择目标安卓设备。
• iOS 平台：选择 运行 → 运行到手机或模拟器，选择 iOS 设备。
• 鸿蒙平台：选择 运行 → 运行到手机或模拟器，选择鸿蒙设备。
• H5 平台：选择 运行 → 运行到浏览器。
• 微信小程序：选择 运行 → 运行到小程序模拟器 → 微信开发者工具。

🔗 发布构建

完成开发后，您可以通过以下方式打包发布：

• Android 平台：选择 发行 → 原生App-云打包 或 原生App-本地打包。
• iOS 平台：选择 发行 → 原生App-云打包（需 Apple 开发者证书）。
• 鸿蒙平台：选择 发行 → 原生App-鸿蒙。
• H5 平台：选择 发行 → 网站-H5手机版，打包后的文件将生成在 dist/build/h5 目录下。
• 微信小程序：选择 发行 → 小程序-微信，然后通过微信开发者工具上传代码。