# 移动端项目 app-unibest

**Repository Path**: eacloud/front-end.app-unibest

## Basic Information

- **Project Name**: 移动端项目 app-unibest
- **Description**: EaCloud的APP应用快速开发项目，该项目基于unibest开源项目构建，由 uniapp + Vue3 + Ts + Vite4 + UnoCss + VSCode(可选 webstorm) + uni插件+ wot-ui（可选其他 UI 库）构建，集成了多种工具和技术，使用了最新的前端技术栈，无需依靠 HBuilderX，通过命令行方式即可运行 web、小程序 和 App。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://gitee.com/eacloud
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-09
- **Last Updated**: 2025-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a href="https://gitee.com/eacloud">
    <img width="160" src="./src/static/logo-unibest.svg">
  </a>
</p>

<h1 align="center">
  <a href="https://gitee.com/eacloud/front-end.app-unibest.git" target="_blank">EaCloud 基于 unibest 的 uniapp 开发框架</a>
</h1>

<h2 align="center">
  <a href="https://gitee.com/eacloud/front-end.app-unibest.git" target="_blank">unibest - 最好的 uniapp 开发框架</a>
</h2>

<div align="center">

[![Member of](https://img.shields.io/badge/member%20project%20of-EaCloud-9e20c9.svg)](https://gitee.com/eacloud) [![node](https://img.shields.io/badge/node-%3E%3D18-green)](https://nodejs.org/) [![pnpm](https://img.shields.io/badge/pnpm-%3E%3D7.30-orange)](https://www.pnpm.cn) [![version](https://img.shields.io/github/package-json/v/feige996/unibest)](https://gitee.com/eacloud/) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/license/mit/)

</div>

`unibest` —— 最好的 `uniapp` 开发模板，由 `uniapp` + `Vue3` + `Ts` + `Vite5` + `UnoCss` + `wot-ui` + `z-paging` 构成，使用了最新的前端技术栈，无需依靠 `HBuilderX`，通过命令行方式运行 `web`、`小程序` 和 `App`（编辑器推荐 `VSCode`，可选 `webstorm`）。

`unibest` 内置了 `约定式路由`、`layout布局`、`请求封装`、`请求拦截`、`登录拦截`、`UnoCSS`、`i18n多语言` 等基础功能，提供了 `代码提示`、`自动格式化`、`统一配置`、`代码片段` 等辅助功能，让你编写 `uniapp` 拥有 `best` 体验 （ `unibest 的由来`）。

<p align="center">
  <a href="https://unibest.tech/" target="_blank">📖 文档地址(Unibest)</a>
  <span style="margin:0 10px;">|</span>
  <a href="https://wot-design-uni.netlify.app/" target="_blank">📖 文档地址(Wot Design Uni)</a>
  <span style="margin:0 10px;">|</span>
  <a href="https://uniapp.dcloud.net.cn/" target="_blank">📖 文档地址(Uni App)</a>
</p>

---

注：项目参考借鉴了 `unibest` 开源项目，详情链接 [https://gitee.com/feige996/unibest](https://gitee.com/feige996/unibest)。

## 平台兼容性

| H5  | IOS | 安卓 | 微信小程序 | 字节小程序 | 快手小程序 | 支付宝小程序 | 钉钉小程序 | 百度小程序 |
| --- | --- | ---- | ---------- | ---------- | ---------- | ------------ | ---------- | ---------- |
| √   | √   | √    | √          | √          | √          | √            | √          | √          |

注意每种 `UI框架` 支持的平台有所不同，详情请看各 `UI框架` 的官网，也可以看 `unibest` 文档。

## ⚙️ 环境

- node>=18
- pnpm>=8
- Vue Official>=2.1.10
- TypeScript>=5.0

**pnpm常用命令：**

- 安装

```bash
# 全局安装最新版本
npm i -g pnpm
# 查看版本
pnpm --version
```

- 安装第三方模块

```bash
# 安装默认添加至 dependencies
pnpm install [package]
# 安装并添加至 devDependencies
pnpm install [package] -D
# 安装并添加至 dependencies
pnpm install [package] -S
```

- 更新第三方模块

```bash
pnpm update
```

- 卸载第三方模块

```bash
pnpm uninstall [package]
```

## &#x1F4C2; 快速开始

执行 `pnpm create unibest` 创建项目

执行 `pnpm i` 安装依赖

执行 `pnpm dev` 运行 `H5`

## 📥 运行（支持热更新）

- web平台： `pnpm dev:h5`, 然后打开 [http://localhost:38060/](http://localhost:38060/)。
- weixin平台：`pnpm dev:mp-weixin` 然后打开微信开发者工具，导入本地文件夹，选择本项目的`dist/dev/mp-weixin` 文件。
- APP平台：`pnpm dev:app`, 然后打开 `HBuilderX`，导入刚刚生成的`dist/dev/app` 文件夹，选择运行到模拟器(开发时优先使用)，或者运行的安卓/ios基座。

## ✨ 发布

- web平台： `pnpm build:h5`，打包后的文件在 `dist/build/h5`，可以放到web服务器，如nginx运行。如果最终不是放在根目录，可以在 `manifest.config.ts` 文件的 `h5.router.base` 属性进行修改。
- weixin平台：`pnpm build:mp-weixin`, 打包后的文件在 `dist/build/mp-weixin`，然后通过微信开发者工具导入，并点击右上角的“上传”按钮进行上传。
- APP平台：`pnpm build:app`, 然后打开 `HBuilderX`，导入刚刚生成的`dist/build/app` 文件夹，选择发行 - APP云打包。

## 🚀 跟随 uni-app 官方升级

项目下，执行 `npx @dcloudio/uvm@latest` 即可更新。执行 `pnpm upgrade` 后会升级 `uniapp` 相关依赖。在升级完后，会自动添加很多无用依赖，这需要删除以减小依赖包体积，需要执行下面的命令 `pnpm uvm-rm` 即可。由于 pnpm 无法正确解析安装 vue-i18n 的依赖包。 建议你用yarn 安装 vue-i18n的依赖包，如果有pnpm 使用需求，可以用pnpm安装 vue-i18n@9.1.9。 `pnpm install vue-i18n@9.1.9`

## 📄 License

[MIT](https://opensource.org/license/mit/)

Copyright © 2020-2025 SANQING Corporation, All rights reserved.

## 交流

| <img src="./screenshots/QQ_863605868.jpg" alt=" QQ" width="256px" height="256px" /> | <img src="./screenshots/Wechat_SeonHu.jpg" alt=" WeChat" width="256px" height="256px" /> |
| :---------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------: |
|                                  QQ群号：863605868                                  |                                      微信号：SeonHu                                      |

## 捐赠

如果觉得这个项目对你有帮助，您可以帮作者买一杯咖啡表示支持！

<p align='center'>
<img alt="pay alipay" src="./screenshots/pay_Alipay.jpg" height="330" style="display:inline-block; height:330px;">
<img alt="pay wechat" src="./screenshots/pay_Wechat.jpg" height="330" style="display:inline-block; height:330px; margin-left:10px;">
</p>