Files
nxxmdata/government-mini-program/微信小程序使用说明.md

104 lines
2.4 KiB
Markdown
Raw Normal View History

2025-09-19 17:52:28 +08:00
# 微信小程序使用说明
## 问题说明
由于uni-app的Vue CLI集成比较复杂建议使用以下方式运行微信小程序
## 方法一使用HBuilderX推荐
1. **下载HBuilderX**
- 访问 https://www.dcloud.io/hbuilderx.html
- 下载并安装HBuilderX
2. **打开项目**
- 启动HBuilderX
- 文件 -> 打开目录 -> 选择 `government-mini-program` 目录
3. **配置项目**
- 在HBuilderX中右键项目根目录
- 选择"重新识别项目类型" -> "uni-app"
- 确保manifest.json中的appid正确
4. **运行到微信小程序**
- 点击工具栏的"运行" -> "运行到小程序模拟器" -> "微信开发者工具"
- 首次运行会提示配置微信开发者工具路径
## 方法二:使用微信开发者工具
1. **构建项目**
```bash
# 在项目目录下执行
npm run build:h5
```
2. **使用微信开发者工具**
- 打开微信开发者工具
- 选择"导入项目"
- 项目目录选择:`government-mini-program`
- AppID填写`wx1b9c7cd2d0e0bfd3`
- 项目名称:政府端小程序
## 方法三H5版本立即可用
1. **启动H5版本**
```bash
npm run dev:h5
```
2. **访问应用**
- 浏览器打开http://localhost:8080
- 默认登录admin / 123456
## 配置说明
### 环境配置
项目已创建 `config.env` 文件,包含以下配置:
```
VUE_APP_API_BASE_URL=http://localhost:5352/api
VUE_APP_TITLE=政府管理系统
VUE_APP_WECHAT_APPID=wx1b9c7cd2d0e0bfd3
```
### 后端服务
确保后端服务运行在 http://localhost:5352
```bash
# 在 government-backend 目录下
npm start
```
## 功能特性
- ✅ 完整的政府管理功能
- ✅ 响应式设计,支持移动端
- ✅ 用户认证和权限管理
- ✅ 数据看板和统计功能
- ✅ 监管、审批、人员管理
- ✅ 疫情监控和服务管理
## 故障排除
### 1. 端口被占用
如果8080端口被占用可以修改vue.config.js中的端口配置
### 2. 后端连接失败
确保后端服务正在运行,检查 http://localhost:5352/health
### 3. 微信小程序无法预览
- 检查微信开发者工具是否已安装
- 确认AppID配置正确
- 检查网络连接
### 4. 依赖安装失败
```bash
# 清除缓存重新安装
rm -rf node_modules package-lock.json
npm install
```
## 联系支持
如有问题,请参考:
- 项目README.md文件
- HBuilderX官方文档
- 微信小程序开发文档