128 lines
2.4 KiB
Markdown
128 lines
2.4 KiB
Markdown
# 开发指南
|
||
|
||
## 项目结构说明
|
||
|
||
```
|
||
frontend/
|
||
├── user-miniprogram/ # 用户端小程序
|
||
│ ├── pages/ # 页面文件
|
||
│ ├── components/ # 组件文件
|
||
│ ├── static/ # 静态资源
|
||
│ ├── utils/ # 工具函数
|
||
│ ├── manifest.json # 应用配置
|
||
│ ├── pages.json # 页面路由配置
|
||
│ └── App.vue # 应用入口
|
||
├── technician-miniprogram/ # 技师端小程序
|
||
└── agent-miniprogram/ # 代理端小程序
|
||
```
|
||
|
||
## 开发环境配置
|
||
|
||
### 1. 安装HBuilderX
|
||
下载并安装HBuilderX开发工具
|
||
|
||
### 2. 导入项目
|
||
- 打开HBuilderX
|
||
- 文件 -> 导入 -> 从本地目录导入
|
||
- 选择对应的小程序目录
|
||
|
||
### 3. 配置小程序AppID
|
||
在各项目的manifest.json中配置对应的小程序AppID
|
||
|
||
## API接口规范
|
||
|
||
### 请求格式
|
||
```javascript
|
||
// 统一使用封装的api工具
|
||
this.$api.get('/api/endpoint', params)
|
||
this.$api.post('/api/endpoint', data)
|
||
```
|
||
|
||
### 响应格式
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"msg": "success",
|
||
"data": {}
|
||
}
|
||
```
|
||
|
||
### 用户类型标识
|
||
- 用户端：User-Type: user
|
||
- 技师端：User-Type: technician
|
||
- 代理端：User-Type: agent
|
||
|
||
## 页面开发规范
|
||
|
||
### 1. 页面结构
|
||
```vue
|
||
<template>
|
||
<view class="container">
|
||
<!-- 页面内容 -->
|
||
</view>
|
||
</template>
|
||
|
||
<script>
|
||
export default {
|
||
data() {
|
||
return {}
|
||
},
|
||
onLoad() {
|
||
// 页面加载
|
||
},
|
||
methods: {}
|
||
}
|
||
</script>
|
||
|
||
<style scoped>
|
||
/* 页面样式 */
|
||
</style>
|
||
```
|
||
|
||
### 2. 样式规范
|
||
- 使用scoped避免样式污染
|
||
- 遵循BEM命名规范
|
||
- 使用uni.scss变量
|
||
|
||
### 3. 组件开发
|
||
- 组件放在components目录
|
||
- 使用驼峰命名
|
||
- 提供完整的props和events
|
||
|
||
## 调试说明
|
||
|
||
### 1. 微信开发者工具
|
||
- 安装微信开发者工具
|
||
- 导入项目的unpackage/dist/dev/mp-weixin目录
|
||
- 配置AppID进行调试
|
||
|
||
### 2. 真机调试
|
||
- 使用HBuilderX的真机运行功能
|
||
- 或编译后在对应平台的开发工具中预览
|
||
|
||
## 发布流程
|
||
|
||
### 1. 编译打包
|
||
```bash
|
||
# 用户端
|
||
npm run build:user
|
||
|
||
# 技师端
|
||
npm run build:tech
|
||
|
||
# 代理端
|
||
npm run build:agent
|
||
```
|
||
|
||
### 2. 上传发布
|
||
- 使用对应平台的开发工具上传代码
|
||
- 提交审核
|
||
- 发布上线
|
||
|
||
## 注意事项
|
||
|
||
1. 各端功能独立，避免代码混淆
|
||
2. 统一使用gva后端API接口
|
||
3. 遵循各平台的开发规范
|
||
4. 注意用户隐私和数据安全
|
||
5. 做好错误处理和用户体验优化 |