# 全栈脚手架 - APP前端

**Repository Path**: heima365/uni-vue2-nview

## Basic Information

- **Project Name**: 全栈脚手架 - APP前端
- **Description**: 这是一个uniapp + vue2 + nview2搭建的APP端示例，包含完整登录与鉴权功能，针对APP端与微信小程序进行了适配。可与个人项目全栈脚手架后端一同使用
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-12-31
- **Last Updated**: 2024-12-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: uni-app

## README

# 全栈脚手架 - APP前端

这是一个uniapp + vue2 + nview2搭建的APP端示例，包含完整登录与鉴权功能，针对APP端与微信小程序进行了适配。可与个人项目全栈脚手架后端一同使用

![页面展示](./docs/preview.png)

## 特色说明

* 兼容h5、app、微信小程序。支持多种登录方式，可通过配置进行切换
* 统一化配置文件，支持debug模式一键切换，适应复杂环境需求
* 本项目内置 `better-mock`
* 本项目可用作 [mvc-php-tp8](https://gitee.com/darkwinoom/mvc-php-tp8) 个人项目的后端一同使用，对应后端控制器位于 `app/controller/app_v1/`，可通过该项目跳转进行查看

## 在线预览

![在线预览二维码](./docs/live-demo.png)

请使用手机扫描上方二维码，或点击[链接在PC端预览](https://uni-vue2-nview.netlify.app/)

## 配置项

> 内部配置全局生效，如修改需要重新打包

配置文件位置：`/src/config.js`，配置详细说明可查看已添加的注释

## 安装使用

推荐使用 pnpm 或者 yarn 进行安装与管理

```bash
git clone https://github.com/darkwinoom/uni-vue2-nview your-project
cd your-project

# 安装依赖
# yarn
pnpm i
```

需要在HBuilder中运行

## 后端开发

本项目可通过 `better-mock` 脱离后端运行，您可以查看 `/src/api` 和 `/src/mock/modules` 中对应文件了解请求与响应内容自行搭建后端

使用后端接管时需要进行以下配置：

* 修改 `/src/config.js` 中 `$config.mock.open` 配置项为 `false`，若您的后端正在开发中且需要逐步开放接口，可在保持 `$config.mock.open` 为 `true` 时，将已完成的API地址填写到 `$config.mock.ignore` 数组中
* 修改 `/src/config.js` 中 `$config.apiServer.default` 为您后端服务器域名地址，若您配置了 `$debug` 为 `true`，则需要在 `$debugConfig.apiServer.default` 中进行配置（或将该字段从 `$debugConfig` 中移除）

同时，项目 [mvc-php-tp8](https://gitee.com/darkwinoom/mvc-php-tp8) 中有包括登录部分的内容示例，您可以进行开发参考或直接使用该项目

具体使用方法请在对应项目中查看

## 核心组件

* [uView2.0](https://github.com/umicro/uView2.0) v2.0.38
* [uni-z-paging](https://github.com/SmileZXLee/uni-z-paging) v2.7.11

## Git 提交规范

* feat 增加新的业务功能
* fix 修复业务问题/BUG
* perf 优化性能
* style 更改代码风格, 不影响运行结果
* refactor 重构代码
* revert 撤销更改
* test 测试相关, 不涉及业务代码的更改
* docs 文档和注释相关
* chore 更新依赖/修改脚手架配置等琐事
* workflow 工作流改进
* ci 持续集成相关
* types 类型定义文件更改
* wip 开发中

## 开发环境

* node 22.7.0
* pnpm 9.10.0
* HBuilder X 4.24