xiaozhang/guoyu

Fork 0

xiao12feng8 1a9423951c 尝试替换掉语音插件

2025-12-07 00:11:06 +08:00

5.9 KiB

Raw Blame History

后续使用指南 - 超简单！

🎉 好消息

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

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

📱 已集成的功能

✅ 服务器连接

当前配置：192.168.1.8:30091
可随时修改，无需重新配置环境

✅ 学习记录

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

✅ 考试功能

题目加载
答案提交
成绩记录

✅ 课件查看

支持视频、PDF、图片等
从服务器动态加载

✅ 语音测评 ⭐

完全离线工作
Vosk 语音识别引擎（11.73 MB）
无需网络，速度快

🚀 后续修改只需 3 步

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

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

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

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

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

方法 B：手动修改

1. 修改配置文件（1 分钟）

// 编辑文件: 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. 修改服务器地址

// 修改为正式服务器 IP
const DEFAULT_SERVER_HOST = '你的服务器IP'
const DEFAULT_SERVER_PORT = 30091

2. 重新打包 APK

双击: 一键重新打包.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: 如果语音测评有问题怎么办？

修改 UTS 插件代码
双击 一键重新打包.ps1
等待 5 分钟完成
测试新 APK

Q3: 能不能不重新打包，直接修改 APK？

A: 不能。APK 是编译后的二进制文件，必须重新编译。但现在只需 5 分钟。

Q4: 服务器部署需要做什么？

APK 不需要部署到服务器
只需确保服务器提供正确的 API 接口
用户安装 APK 后自动连接服务器

Q5: 所有功能都能正常使用吗？

A: ✅ 是的！

学习记录 → 连接服务器 API
考试功能 → 连接服务器 API
课件查看 → 从服务器加载
语音测评 → 完全离线，不依赖服务器

📞 需要帮助？

如果遇到问题：

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

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

# 重新构建
.\gradlew assembleDebug

🎯 总结

✅ 已完成（不需要再配置）

SDK 环境搭建
Gradle 配置
Vosk 语音库集成
所有依赖下载

⚡ 后续只需（5 分钟）

修改配置文件（或双击脚本）
等待自动打包
获取 APK

🚀 功能保证

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

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

5.9 KiB Raw Blame History Unescape Escape