# 后续使用指南 - 超简单！

## 🎉 好消息

**首次配置已完成！后续修改只需 5 分钟！**

这次配置这么复杂是因为首次环境搭建，但这些问题**只需要解决一次**。

---

## 📱 已集成的功能

### ✅ 服务器连接
- 当前配置：`192.168.1.8:30091`
- 可随时修改，无需重新配置环境

### ✅ 学习记录
- 自动同步到服务器
- 支持离线记录，联网后上传

### ✅ 考试功能
- 题目加载
- 答案提交
- 成绩记录

### ✅ 课件查看
- 支持视频、PDF、图片等
- 从服务器动态加载

### ✅ 语音测评 ⭐
- **完全离线工作**
- Vosk 语音识别引擎（11.73 MB）
- 无需网络，速度快

---

## 🚀 后续修改只需 3 步

### 场景 1：只修改服务器地址（最常见）

#### 方法 A：使用自动脚本（推荐）⭐

**双击运行：`修改服务器地址.ps1`**

```
1. 输入新的 IP 地址
2. 输入新的端口（可选）
3. 确认后自动重新打包
4. 等待 5 分钟完成

全程自动化，无需手动操作！
```

#### 方法 B：手动修改

**1. 修改配置文件（1 分钟）**
```javascript
// 编辑文件: src/utils/config.js
const DEFAULT_SERVER_HOST = '新的IP地址'  // 修改这里
const DEFAULT_SERVER_PORT = 30091         // 修改端口（可选）
```

**2. 双击运行：`一键重新打包.ps1`（4 分钟）**
- 自动编译 uni-app
- 自动集成资源
- 自动构建 APK

**3. 获取 APK**
```
位置: D:\4_Part\HBuilder-Android\HBuilder-Integrate-AS\simpleDemo\build\outputs\apk\debug\simpleDemo-debug.apk
```

---

### 场景 2：修改语音测评代码

**1. 修改 UTS 插件代码**
```
编辑: uni_modules/xwq-speech-to-text/utssdk/...
```

**2. 双击运行：`一键重新打包.ps1`**
- 自动编译并打包

---

### 场景 3：修改界面或业务逻辑

**1. 修改 Vue 代码**
```
编辑: src/pages/...
```

**2. 双击运行：`一键重新打包.ps1`**
- 自动编译并打包

---

## ⏱️ 时间对比

| 操作 | 首次配置 | 后续修改 |
|------|---------|---------|
| 环境搭建 | 40-60 分钟 | ✅ 0 分钟（已完成） |
| 修改代码 | - | 5 分钟 |
| 编译打包 | 10-15 分钟 | **2-3 分钟**（有缓存） |
| **总计** | **50-75 分钟** | **5 分钟** ⭐ |

---

## 📦 APK 部署说明

### 部署到服务器环境

**APK 文件本身不需要部署到服务器！**

APK 是安装到用户手机上的应用程序。部署流程：

#### 1. 修改服务器地址
```javascript
// 修改为正式服务器 IP
const DEFAULT_SERVER_HOST = '你的服务器IP'
const DEFAULT_SERVER_PORT = 30091
```

#### 2. 重新打包 APK
```bash
双击: 一键重新打包.ps1
```

#### 3. 分发 APK
```
方式 1: 上传到文件服务器，生成下载链接
方式 2: 通过微信、邮件发送给用户
方式 3: 放到应用商店（需要签名证书）
```

#### 4. 用户安装
```
用户下载 APK → 安装 → 使用
自动连接到配置的服务器地址
```

---

## ✅ 功能保证

### 所有功能都已内置在 APK 中：

| 功能 | 状态 | 说明 |
|------|------|------|
| 服务器连接 | ✅ | 连接到 192.168.1.8:30091 |
| 学习记录 | ✅ | 自动同步到服务器 |
| 考试功能 | ✅ | 完整的考试流程 |
| 课件查看 | ✅ | 支持多种格式 |
| 语音测评 | ✅ | Vosk 离线识别 |
| 用户登录 | ✅ | 连接后端认证 |
| 数据同步 | ✅ | 离线 + 在线 |

### 修改服务器地址后：

**只需要确保新服务器提供相同的 API 接口！**

```
✅ 学习记录：POST /api/learning/record
✅ 考试提交：POST /api/exam/submit
✅ 课件加载：GET /api/courseware/list
✅ 用户登录：POST /api/auth/login
✅ 语音测评：完全离线，无需服务器
```

---

## 🔧 可用的脚本工具

### 1. `修改服务器地址.ps1` ⭐ 最常用
- 交互式修改 IP 和端口
- 自动重新打包
- 适合：切换测试/正式环境

### 2. `一键重新打包.ps1`
- 快速重新编译和打包
- 显示详细进度
- 适合：修改代码后快速构建

### 3. `integrate.ps1`
- 集成资源到 Android Studio
- 一般不需要单独运行
- 适合：手动调试

### 4. `sync-from-outer.ps1`
- 同步外层项目文件
- 一般不需要使用
- 适合：特殊情况

---

## 🐛 常见问题

### Q1: 后续打包会不会还这么慢？
**A:** 不会！首次需要下载 SDK 和依赖（约 50 分钟），后续有缓存，只需 **2-3 分钟**。

### Q2: 如果语音测评有问题怎么办？
**A:** 
1. 修改 UTS 插件代码
2. 双击 `一键重新打包.ps1`
3. 等待 5 分钟完成
4. 测试新 APK

### Q3: 能不能不重新打包，直接修改 APK？
**A:** 不能。APK 是编译后的二进制文件，必须重新编译。但现在只需 5 分钟。

### Q4: 服务器部署需要做什么？
**A:** 
- **APK 不需要部署到服务器**
- 只需确保服务器提供正确的 API 接口
- 用户安装 APK 后自动连接服务器

### Q5: 所有功能都能正常使用吗？
**A:** ✅ 是的！
- 学习记录 → 连接服务器 API
- 考试功能 → 连接服务器 API
- 课件查看 → 从服务器加载
- 语音测评 → **完全离线，不依赖服务器**

---

## 📞 需要帮助？

如果遇到问题：

1. **查看构建日志**：打开 PowerShell 窗口查看错误信息
2. **检查网络**：确保能访问服务器地址
3. **重新构建**：清理缓存后重新打包

```bash
# 清理缓存
cd D:\4_Part\HBuilder-Android\HBuilder-Integrate-AS
.\gradlew clean

# 重新构建
.\gradlew assembleDebug
```

---

## 🎯 总结

### ✅ 已完成（不需要再配置）
- SDK 环境搭建
- Gradle 配置
- Vosk 语音库集成
- 所有依赖下载

### ⚡ 后续只需（5 分钟）
1. 修改配置文件（或双击脚本）
2. 等待自动打包
3. 获取 APK

### 🚀 功能保证
- ✅ 服务器连接
- ✅ 学习记录
- ✅ 考试功能
- ✅ 课件查看
- ✅ 语音测评

**现在配置好后，以后只需要双击一个脚本就能完成所有操作！** 🎉