# mms-uniapp

**Repository Path**: MrShanDev/mms-uniapp

## Basic Information

- **Project Name**: mms-uniapp
- **Description**: MMS 传统 uni-app 移动端基座，基于 Vue 2 / JavaScript / uView，支持 Android、iOS、H5、微信及抖音小程序，包含登录、会员、点餐和订单示例；与 mms-uniapp-x（UTS / UVue）版本分别维护。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://mmsadmin.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-13
- **Last Updated**: 2026-10-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
   <br/>
   <a href="https://mmsadmin.cn">
     <img width="150" src="https://mmsadmin.cn/logo.png" alt="MMS logo">
   </a>
   <h1>mms-uniapp · MMS 移动端基座</h1>
   <p>MMS · Modular Management System</p>
   <p><strong>mms-uniapp · 移动端（uni-app）</strong></p>
   <p><a href="https://mmsadmin.cn/">📘 在线文档 · mmsadmin.cn</a> · <a href="https://gitee.com/MrShanDev/mms-uniapp">Gitee</a> · <a href="https://github.com/MrShanDev/mms-mobile">GitHub</a></p>
   <br/>
</div>

[English](README.en.md) | 简体中文

`mms-uniapp` 是 **MMS 的移动端应用**，基于 **uni-app（Vue 2）** 开发，一套代码编译到 **App（Android / iOS）**、**微信小程序**、**抖音小程序** 等多端。当前是一个 C 端点餐/会员类应用：首页、点餐、订单、我的四个 Tab 页，含微信登录与网页容器。

- 仓库：<https://gitee.com/MrShanDev/mms-uniapp>（公开）
- 后端对接：`mms` 开放接口，API 地址集中在 `common/utils.js` 的 `baseUrl`

---

## 技术栈

- uni-app（`manifest.json` 中 `vueVersion: 2`）
- UI 组件：`uview-ui` / `uv-ui-tools` / `uv-waterfall`（`uni_modules/`）
- 业务组件：`mms-login`（微信登录）、`vk-data-goods-sku-popup`（SKU 弹窗）
- 自研组件库：`components/sumer-components`（easycom 自动注册，前缀 `sumer-`）

## 环境要求

- **HBuilderX**（推荐最新版；本项目为 HBuilderX 工程，`package.json` 不含依赖，无需 npm install）
- 微信开发者工具（调试微信小程序时）

## 支持的运行端

| 端 | 说明 |
|----|------|
| App（`app-plus`） | Android / iOS，HBuilderX 云打包或本地打包 |
| 微信小程序（`mp-weixin`） | 已配置 appid（见 `manifest.json`） |
| 抖音小程序（`mp-toutiao`） | 已配置 appid（见 `manifest.json`） |

---

## 快速开始

1. 用 **HBuilderX** 导入本目录（`文件 → 导入 → 从本地目录导入`）
2. 修改 `common/utils.js` 中的 `baseUrl` 指向你的后端环境
3. 在 HBuilderX 中选择运行目标：
   - **运行 → 运行到浏览器 / 手机或模拟器**（App / H5）
   - **运行 → 运行到小程序模拟器 → 微信开发者工具**（需先在微信开发者工具中开启服务端口）

## 页面结构（`pages.json`）

| 页面 | 路径 | 说明 |
|------|------|------|
| 首页 | `pages/index/index` | TabBar 页 |
| 点餐 | `pages/meal/meal` | TabBar 页 |
| 订单 | `pages/order/order` | TabBar 页 |
| 我的 | `pages/me/me` | TabBar 页 |
| 网页容器 | `pages/webview/webview` | 内嵌 H5 |
| 微信登录 | `pages/login/login/weixinLoging` | 微信授权登录 |

---

## 发布

- **App**：HBuilderX → 发行 → 原生 App-云打包（或本地打包）
- **微信小程序**：HBuilderX → 发行 → 小程序-微信，然后在微信开发者工具中上传
- **抖音小程序**：HBuilderX → 发行 → 小程序-抖音

## License

MIT；详见 [LICENSE](LICENSE) 文件。

## 项目版本与搜索关键词

MMS 传统 uni-app 移动端基座，基于 Vue 2、JavaScript 和 uView，包含登录、会员、点餐及订单示例，面向 App、H5 和小程序。

关键词：MMS,uni-app,Vue 2,JavaScript,uView,移动端,微信小程序。

传统版本：[mms-uniapp](https://gitee.com/MrShanDev/mms-uniapp)；UTS / UVue 版本：[mms-uniapp-x](https://gitee.com/MrShanDev/mms-uniapp-x)。