upd
This commit is contained in:
wangziqi
@@ -1,222 +1,19 @@
|
||||
# 车管家 Android 客户端 - 快速开始指南
|
||||
# Android (Java) Quickstart
|
||||
|
||||
## 项目概述
|
||||
## Requirements
|
||||
- Android Studio Hedgehog (2023.1.1) or newer
|
||||
- JDK 17
|
||||
- Android SDK 34
|
||||
|
||||
这是一个现代化的 Android 应用，为车管家 4S店车辆维保管理系统提供移动端支持。
|
||||
## Run
|
||||
1. Open Android Studio
|
||||
2. Open the `android` folder
|
||||
3. Let Gradle sync
|
||||
4. Update API base URL if needed:
|
||||
- `android/app/build.gradle` -> `API_BASE_URL`
|
||||
5. Run `LoginActivity`
|
||||
|
||||
## 开发前准备
|
||||
|
||||
### 1. 安装 Android Studio
|
||||
|
||||
下载并安装最新版本的 Android Studio:
|
||||
https://developer.android.com/studio
|
||||
|
||||
### 2. 配置 JDK
|
||||
|
||||
确保安装了 JDK 17 或更高版本：
|
||||
```bash
|
||||
java -version # 应该显示 17.x.x 或更高
|
||||
```
|
||||
|
||||
### 3. 启动后端服务
|
||||
|
||||
在运行 Android 应用之前，确保后端服务正在运行：
|
||||
|
||||
```bash
|
||||
# 进入后端项目目录
|
||||
cd car-maintenance-system/backend
|
||||
|
||||
# 使用 Maven 启动服务
|
||||
mvn spring-boot:run
|
||||
|
||||
# 或者在 IDEA 中运行 SpringBootAppApplication.java
|
||||
```
|
||||
|
||||
后端默认运行在 `http://localhost:8080`
|
||||
|
||||
### 4. 配置 API 地址
|
||||
|
||||
根据你的测试环境，修改 `app/build.gradle.kts`：
|
||||
|
||||
**使用 Android 模拟器：**
|
||||
```kotlin
|
||||
buildConfigField("String", "API_BASE_URL", "\"http://10.0.2.2:8080/api/\"")
|
||||
```
|
||||
|
||||
**使用真机：**
|
||||
```kotlin
|
||||
buildConfigField("String", "API_BASE_URL", "\"http://YOUR_PC_IP:8080/api/\"")
|
||||
// 例如: "http://192.168.1.100:8080/api/"
|
||||
```
|
||||
|
||||
## 运行应用
|
||||
|
||||
### 方式一：使用 Android Studio
|
||||
|
||||
1. 打开 Android Studio
|
||||
2. 选择 **File > Open**
|
||||
3. 选择 `car-maintenance-system/android` 目录
|
||||
4. 等待 Gradle 同步完成
|
||||
5. 点击工具栏的 Run 按钮 (绿色三角形)
|
||||
|
||||
### 方式二：使用命令行
|
||||
|
||||
```bash
|
||||
cd android
|
||||
|
||||
# 查看连接的设备
|
||||
adb devices
|
||||
|
||||
# 安装并运行
|
||||
./gradlew installDebug
|
||||
```
|
||||
|
||||
## 测试账号
|
||||
|
||||
| 角色 | 用户名 | 密码 | 功能 |
|
||||
|------|--------|------|------|
|
||||
| 管理员 | admin | 123456 | 系统管理、数据统计 |
|
||||
| 工作人员 | staff001 | 123456 | 工单处理、预约确认 |
|
||||
| 客户 | customer001 | 123456 | 查看车辆、预约服务 |
|
||||
|
||||
## 项目结构说明
|
||||
|
||||
```
|
||||
android/
|
||||
├── app/ # 应用模块
|
||||
│ ├── src/main/
|
||||
│ │ ├── java/com/carmaintenance/
|
||||
│ │ │ ├── data/ # 数据层
|
||||
│ │ │ │ ├── local/ # 本地存储
|
||||
│ │ │ │ ├── model/ # 数据模型
|
||||
│ │ │ │ ├── remote/ # API接口
|
||||
│ │ │ │ ├── repository/ # 数据仓库
|
||||
│ │ │ │ └── manager/ # Token管理
|
||||
│ │ │ ├── di/ # 依赖注入
|
||||
│ │ │ ├── ui/ # UI层
|
||||
│ │ │ │ ├── navigation/ # 导航
|
||||
│ │ │ │ ├── screen/ # 页面
|
||||
│ │ │ │ ├── theme/ # 主题
|
||||
│ │ │ │ └── viewmodel/ # 视图模型
|
||||
│ │ │ ├── CarMaintenanceApplication.kt
|
||||
│ │ │ └── MainActivity.kt
|
||||
│ │ └── res/ # 资源文件
|
||||
│ ├── build.gradle.kts # 应用级构建配置
|
||||
│ └── proguard-rules.pro # 混淆规则
|
||||
├── build.gradle.kts # 项目级构建配置
|
||||
├── settings.gradle.kts # Gradle设置
|
||||
└── gradle.properties # Gradle属性
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 1. Gradle 同步失败
|
||||
|
||||
**问题**: Gradle 同步时出现错误
|
||||
|
||||
**解决方案**:
|
||||
```bash
|
||||
# 清理项目
|
||||
./gradlew clean
|
||||
|
||||
# 重新构建
|
||||
./gradlew build
|
||||
|
||||
# 如果还是失败，删除 .gradle 目录后重试
|
||||
rm -rf .gradle
|
||||
```
|
||||
|
||||
### 2. 网络请求失败
|
||||
|
||||
**问题**: 应用无法连接到服务器
|
||||
|
||||
**解决方案**:
|
||||
- 确认后端服务正在运行
|
||||
- 检查 API_BASE_URL 配置
|
||||
- 确保设备和电脑在同一网络（真机测试）
|
||||
- 检查防火墙设置
|
||||
|
||||
### 3. 登录失败
|
||||
|
||||
**问题**: 登录时提示错误
|
||||
|
||||
**解决方案**:
|
||||
- 确认后端数据库中有测试用户
|
||||
- 检查用户名和密码是否正确
|
||||
- 查看后端日志确认请求是否到达
|
||||
|
||||
### 4. 模拟器无法访问宿主机
|
||||
|
||||
**问题**: 模拟器中的 App 无法访问电脑上的后端服务
|
||||
|
||||
**解决方案**:
|
||||
使用 `10.0.2.2` 代替 `localhost`:
|
||||
```kotlin
|
||||
// 错误
|
||||
buildConfigField("String", "API_BASE_URL", "\"http://localhost:8080/api/\"")
|
||||
|
||||
// 正确（模拟器）
|
||||
buildConfigField("String", "API_BASE_URL", "\"http://10.0.2.2:8080/api/\"")
|
||||
```
|
||||
|
||||
### 5. 数据显示为空
|
||||
|
||||
**问题**: 登录后车辆、工单等数据显示为空
|
||||
|
||||
**解决方案**:
|
||||
- 确认后端数据库有相关数据
|
||||
- 使用 Admin 账号登录后台添加测试数据
|
||||
- 检查客户ID是否正确关联
|
||||
|
||||
## 调试技巧
|
||||
|
||||
### 查看 API 请求
|
||||
|
||||
在 `NetworkModule.kt` 中，日志级别已设置为 `BODY`：
|
||||
```kotlin
|
||||
if (BuildConfig.DEBUG) {
|
||||
HttpLoggingInterceptor.Level.BODY
|
||||
}
|
||||
```
|
||||
|
||||
在 Logcat 中过滤 `OkHttp` 即可看到所有网络请求。
|
||||
|
||||
### 查看 Token 存储
|
||||
|
||||
在 Logcat 中过滤 `TokenManager` 可以看到 Token 相关的日志。
|
||||
|
||||
## 下一步开发
|
||||
|
||||
### 功能优先级
|
||||
|
||||
1. **高优先级**
|
||||
- 在线预约表单
|
||||
- 车辆详情查看
|
||||
- 工单详情查看
|
||||
|
||||
2. **中优先级**
|
||||
- 管理员完整功能
|
||||
- 工作人员功能
|
||||
- 推送通知
|
||||
|
||||
3. **低优先级**
|
||||
- 数据刷新机制
|
||||
- 离线缓存
|
||||
- 图片上传
|
||||
|
||||
### 扩展功能建议
|
||||
|
||||
- [ ] 车辆照片上传
|
||||
- [ ] 电子签名
|
||||
- [ ] 扫码查看车辆
|
||||
- [ ] 消息推送（Firebase）
|
||||
- [ ] 支付集成
|
||||
- [ ] 数据导出
|
||||
- [ ] 多语言支持
|
||||
|
||||
## 技术支持
|
||||
|
||||
如有问题，请查看：
|
||||
- [Jetpack Compose 官方文档](https://developer.android.com/jetpack/compose)
|
||||
- [Hilt 官方文档](https://dagger.dev/hilt/)
|
||||
- [Retrofit 官方文档](https://square.github.io/retrofit/)
|
||||
## Test Accounts
|
||||
- admin / 123456
|
||||
- staff001 / 123456
|
||||
- customer001 / 123456
|
||||
|
||||
Reference in New Issue
Block a user