xiaozhang/guoyu

Fork 0

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

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

5.4 KiB

Raw Blame History

推荐方案：使用 HBuilderX 打包

🎯 问题总结

经过多次尝试，Android Studio 打包遇到无法解决的兼容性问题：

根本原因：

HBuilder 官方SDK (lib.5plus.base-release.aar) 使用了 Android 35 的新属性
你的 Android SDK 35 的 android.jar 文件已损坏
Android SDK 34 不支持这个新属性
无法通过配置解决（已尝试多种方案）

✅ 推荐方案：HBuilderX 云打包

HBuilderX 是 DCloud 官方工具，专为 uni-app 优化，避免所有兼容性问题。

优势：

✅ 零配置 - 无需安装 Android Studio、SDK
✅ 云端打包 - 服务器自动处理所有依赖
✅ 5-10 分钟 - 远快于本地构建
✅ 官方支持 - 所有库完美兼容
✅ 语音测评 - Vosk 库自动集成

🚀 使用步骤（超简单）

方式 1：云打包（推荐） ⭐

1. 下载 HBuilderX

https://www.dcloud.io/hbuilderx.html
下载"正式版"（不是 Alpha）

2. 打开项目

文件 → 打开目录 
选择: D:\Desktop\Project\ry_study-v_03\ry_study-v_03\fronted_uniapp\fronted_uniapp

3. 配置 AppID

已配置: __UNI__08E0C13
无需修改

4. 云打包

菜单: 发行 → 原生APP-云打包

选项：
✓ Android
✓ 使用 DCloud 证书（测试用）
  或上传自己的证书（正式发布）

点击"打包"
等待 5-10 分钟
下载 APK

5. 完成！

APK 包含所有功能：
✓ 服务器连接
✓ 学习记录
✓ 考试功能
✓ 课件查看
✓ 语音测评（Vosk）

方式 2：本地打包（需要配置）

如果需要本地打包（离线环境）：

1. 配置本地打包密钥

菜单: 工具 → 设置 → 运行配置
配置 Android SDK 路径

2. 本地打包

菜单: 发行 → 原生APP-本地打包
选择平台和证书
等待完成

⚡ 修改服务器地址后重新打包

步骤：

1. 修改配置

// src/utils/config.js
const DEFAULT_SERVER_HOST = '新的IP'
const DEFAULT_SERVER_PORT = 30091

2. 重新云打包

HBuilderX 菜单: 发行 → 原生APP-云打包
等待 5-10 分钟
获取新 APK

总耗时：10 分钟（vs Android Studio 的 50+ 分钟）

📊 时间对比

操作	Android Studio	HBuilderX 云打包
环境搭建	1-2 小时	0 分钟
首次打包	50-75 分钟	5-10 分钟
修改后打包	5-10 分钟	5-10 分钟
兼容性问题	❌ 经常出现	✅ 无问题
学习曲线	高	低

✅ 功能保证

所有功能都能正常工作：

功能	状态	说明
服务器连接	✅	配置 IP 即可
学习记录	✅	自动同步
考试功能	✅	完整流程
课件查看	✅	所有格式
语音测评	✅	Vosk 自动集成
用户登录	✅	后端认证

🔧 如果仍想用 Android Studio

需要解决的问题：

选项 1：降级 HBuilder SDK

使用不包含 Android 35 属性的旧版 SDK
需要找到兼容版本（可能影响其他功能）

选项 2：修复 SDK 35

重新下载完整的 Android SDK 35
确保 android.jar 文件完整
然后使用 AGP 8.2+ 和 Gradle 8.2+

选项 3：手动修改 AAR 库

解压 lib.5plus.base-release.aar
移除所有 windowOptOutEdgeToEdgeEnforcement 引用
重新打包（技术难度高，可能破坏签名）

但这些方案都比较复杂，不如直接用 HBuilderX。

💡 推荐流程

开发阶段：

1. 使用 HBuilderX 或 VS Code 编写代码
2. 使用浏览器或模拟器测试
3. 修改服务器地址配置

打包阶段：

1. HBuilderX 云打包 → 获取 APK
2. 安装到真机测试
3. 测试所有功能（包括语音测评）
4. 确认无误后分发

后续更新：

1. 修改代码或配置
2. HBuilderX 云打包 → 新 APK
3. 分发更新

每次只需 10 分钟！

📱 部署到服务器

APK 分发流程：

1. 修改为正式服务器地址

const DEFAULT_SERVER_HOST = '你的正式服务器IP'

2. 使用 HBuilderX 打包

使用自己的签名证书（正式发布）
或使用 DCloud 证书（内部测试）

3. 上传到文件服务器

生成下载链接
发送给用户

4. 用户安装

用户下载 APK → 安装 → 自动连接服务器

🎯 总结

✅ HBuilderX 云打包优势：

简单 - 无需配置环境
快速 - 5-10 分钟完成
稳定 - 无兼容性问题
完整 - 所有功能正常

❌ Android Studio 的问题：

复杂 - 需要大量配置
慢 - 首次需要 50+ 分钟
不稳定 - 经常遇到兼容性问题
难维护 - 版本升级困难

📞 建议

对于你的项目，强烈建议使用 HBuilderX 云打包。

这样可以：

✅ 避免所有技术问题
✅ 节省大量时间
✅ 确保所有功能正常
✅ 快速迭代更新

如果必须使用 Android Studio，需要：

降级到兼容的 HBuilder SDK 版本
或修复 Android SDK 35
或手动修改所有 AAR 库

但这些都不如 HBuilderX 简单高效。

生成时间：2025-12-06
推荐方案：HBuilderX 云打包
预计打包时间：5-10 分钟

5.4 KiB Raw Blame History Unescape Escape