更新记录

1.3.1（2023-07-02）

• cli 创建的 Vue3/Vite 项目 与 使用 HBuilderX 导入插件 的包有差异,请直接访问 开源地址；
• 如有问题请加群【872378674】交流；
• 更新依赖，删除不能用的一些组件；
• 其他优化；

1.3.0（2023-05-08）

• cli 创建的 Vue3/Vite 项目 与 使用 HBuilderX 导入插件 的包有差异,请直接访问 开源地址
• 使用uni-mini-router管理路由；
• 优化登录体验；
• 其他优化；

1.2.1（2023-04-13）

• cli 创建的 Vue3/Vite 项目 与 使用 HBuilderX 导入插件 的包有差异,请直接访问 开源地址；
• 新增 VITE_USE_MOCK 配置；
• 更新依赖及其他优化；

平台兼容性

🌈 uni-app Vue3 Vite4 pinia2 TypeScript 基础框架

简介

• uni-app Vue3 Vite4 pinia2 TypeScript 基础框架
• cli 创建的 Vue3/Vite 项目 与 使用 HBuilderX 导入插件 的包有差异,请直接访问 开源地址
• 访问uniapp 插件
• 如有问题请加群【872378674】交流

说明

• 框架完全基于 Vue3 SFC <script setup> 写法,不支持 Vue2;
• 可用于学习与交流;
• 目前测试 H5、微信小程序,APP(Android),支付宝小程序通过;
• 其他平台暂未测试,后续会增加;
• 如发现问题或建议可在评论区留言, 或提Issues及PR,会及时处理;
• 如有需求亦可在评论区留言,或在此项目基础上增加;
• 代码规范 & 详细解释 husky、prettier、eslint、lint-staged 的作用和使用

特性

• 最新技术栈：使用 Vue3/Vite4/pinia ,TypeScript 等前端前沿技术开发;
• Unocss: 原子化 CSS, iconify图标
• Eslint/Prettier: 规范代码格式,统一编码;
• 路由拦截: uni-mini-router,类似Vue Router的API和功能,在uni-app中进行路由跳转、传参、拦截等常用操作;
• 请求拦截: 使用alova 请求,支持请求和响应拦截等;
• Mock 数据: 配合 alova 请求的@alova/mock，模拟 api 请求(App 不支持);
• 缓存加密: 支持 AES 加密缓存,可设置区分在开发或生成环境中是否加密;

目录结构

.
├─ src
│   ├─assets # 静态资源目录
│   │
│   ├─components # 组件目录
│   │   ├─ BasicButton
│   │   │    ├─index.vue
│   │   │    └─prpos.ts
│   │   └─...
│   │
│   ├─enums # 枚举/常量
│   │   ├─ cacheEnum.ts
│   │   └─...
│   │
│   ├─pages # 页面
│   │   ├─ index
│   │   │    └─index.vue
│   │   └─...
│   │
│   ├─services # 接口相关
│   │   ├─ api # api
│   │   │    ├─auth.ts
│   │   │    └─...
│   │   │
│   │   └─ model # 数据模型
│   │        ├─authModel.d.ts
│   │        └─...
│   │
│   ├─settings # 设置
│   │   └─ encryptionSetting # 加密设置
│   │
│   ├─state # 状态管理模式(pinia)
│   │   ├─ modules # 数据模块
│   │   │    ├─auth.ts
│   │   │    └─...
│   │   │
│   │   └─ index.ts
│   │
│   ├─static # 静态公共文件
│   │   ├─ images # 图片
│   │   │    ├─avatar.png
│   │   │    └─...
│   │   │
│   │   └─ ...
│   │
│   ├─types # 类型文件
│   │   ├─ http.d.ts
│   │   └─ ...
│   │
│   └─utils # 工具类
│       ├─ cache # 缓存相关目录
│       ├─ http  # request相关目录
│       ├─ interceptors  # 拦截器相关目录
│       └─ ...
│
├─ .env
├─ .env.development
├─ .env.production
├─ .eslintignore
├─ .eslintrc.js
├─ .gitignore
├─ .prettierignore
├─ .prettierrc.js
├─ favicon.ico
├─ index.html
├─ package.json
├─ pnpm-lock.yaml
├─ README.md
├─ tree.txt
├─ tsconfig.json
└─ vite.config.ts

预览

• 域名到期，暂时已不能预览

//: # ()

安装使用

• 安装依赖

pnpm install

• 运行

# 其他端请查看 package.json script
pnpm dev:h5

• 打包

# 其他端请查看 package.json script
pnpm build:h5

• 更新依赖到最新（新手请忽略）

pnpm up
# 打开HBuilder X alpha桌面程序-->点击上面的帮助-->历次更新说明-->获取最新版本号（如：3.7.2.20230217-alpha）
npx @dcloudio/uvm 3.7.2.20230217-alpha

Gitee 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

Gitee 贡献提交规范

提交类型

提交别名

快捷别名提示

1. resolve a conflict：解决冲突
2. merge branch：合并分支
3. feat: [...] : 添加的新功能说明
4. fix: [...] : 修复的 bug 说明
5. initial project：初始化项目
6. style: [...] : 修改的样式范围
7. perf：[...] : 优化的范围
8. release : 发布新版本
9. docs: 文档修改
10. refactor： 代码重构
11. revert： 还原之前的版本
12. dependencies： 依赖项修改
13. devDependencies： 开发依赖修改
14. review：复习，回顾
15. strengthen: 加强，巩固