2024-06-06 09:20:53 +08:00
|
|
|
|
<h1 align="center">
|
|
|
|
|
<a href="https://github.com/codercup/unibest" target="_blank">unibest - 最好的 uniapp 开发框架</a>
|
|
|
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
<div align="center">
|
|
|
|
|
|
|
|
|
|
[![GitHub Repo stars](https://img.shields.io/github/stars/codercup/unibest?style=flat&logo=github)](https://github.com/codercup/unibest)
|
|
|
|
|
[![GitHub forks](https://img.shields.io/github/forks/codercup/unibest?style=flat&logo=github)](https://github.com/codercup/unibest)
|
|
|
|
|
[![star](https://gitee.com/codercup/unibest/badge/star.svg?theme=dark)](https://gitee.com/codercup/unibest/stargazers)
|
|
|
|
|
[![fork](https://gitee.com/codercup/unibest/badge/fork.svg?theme=dark)](https://gitee.com/codercup/unibest/members)
|
|
|
|
|
![node version](https://img.shields.io/badge/node-%3E%3D18-green)
|
|
|
|
|
![pnpm version](https://img.shields.io/badge/pnpm-%3E%3D7.30-green)
|
|
|
|
|
![GitHub package.json version (subfolder of monorepo)](https://img.shields.io/github/package-json/v/codercup/unibest)
|
|
|
|
|
![GitHub License](https://img.shields.io/github/license/codercup/unibest)
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
`unibest` —— 最好的 `uniapp` 开发框架,由 `uniapp` + `Vue3` + `Ts` + `Vite5` + `UnoCss` + `wot-ui` + `z-paging` 构成,使用了最新的前端技术栈,无需依靠 `HBuilderX`,通过命令行方式运行 `web`、`小程序` 和 `App`(编辑器推荐 `VSCode`,可选 `webstorm`)。
|
|
|
|
|
|
|
|
|
|
`unibest` 内置了 `约定式路由`、`layout布局`、`请求封装`、`请求拦截`、`登录拦截`、`UnoCSS`、`i18n多语言` 等基础功能,提供了 `代码提示`、`自动格式化`、`统一配置`、`代码片段` 等辅助功能,让你编写 `uniapp` 拥有 `best` 体验 ( `unibest 的由来`)。
|
|
|
|
|
|
|
|
|
|
![](https://raw.githubusercontent.com/andreasbm/readme/master/screenshots/lines/rainbow.png)
|
|
|
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
|
<a href="https://codercup.github.io/unibest-docs/" target="_blank">📖 文档地址</a>
|
|
|
|
|
<span style="margin:0 10px;">|</span>
|
|
|
|
|
<a href="https://codercup.github.io/hello-unibest/" target="_blank">📱 DEMO 地址</a>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
## ⚙️ 环境
|
|
|
|
|
|
|
|
|
|
- node>=18
|
|
|
|
|
- pnpm>=7.30
|
|
|
|
|
|
|
|
|
|
## 📂 快速开始
|
|
|
|
|
|
2024-06-17 11:55:29 +08:00
|
|
|
|
main 纯洁分支
|
2024-09-12 11:41:37 +08:00
|
|
|
|
feature 开发分支 线上测试(正式环境)
|
|
|
|
|
dev 转盘、翻牌等两个活动(旧版)
|
|
|
|
|
prod 正式环境 merge feature
|
2024-06-17 11:55:29 +08:00
|
|
|
|
|
2024-06-06 09:20:53 +08:00
|
|
|
|
执行 `pnpm create unibest` 创建项目
|
|
|
|
|
|
|
|
|
|
执行 `pnpm i` 安装依赖
|
|
|
|
|
|
|
|
|
|
执行 `pnpm dev` 运行 `H5`
|
|
|
|
|
|
|
|
|
|
## 📦 运行(支持热更新)
|
|
|
|
|
|
|
|
|
|
- web平台: `pnpm dev:h5`, 然后打开 [http://localhost:9000/](http://localhost:9000/)。
|
|
|
|
|
- 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云打包。
|