267 lines
5.9 KiB
Markdown
267 lines
5.9 KiB
Markdown
# 后续使用指南 - 超简单！
|
||
|
||
## 🎉 好消息
|
||
|
||
**首次配置已完成！后续修改只需 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
|
||
|
||
### 🚀 功能保证
|
||
- ✅ 服务器连接
|
||
- ✅ 学习记录
|
||
- ✅ 考试功能
|
||
- ✅ 课件查看
|
||
- ✅ 语音测评
|
||
|
||
**现在配置好后，以后只需要双击一个脚本就能完成所有操作！** 🎉
|