6.4 KiB
6.4 KiB
自定义基座打包完整步骤
🎯 为什么使用自定义基座？
问题
- 云端打包限制：40MB
- 语音模型大小：41.87MB
- 结果：云端打包失败
解决方案
- ✅ 自定义基座没有大小限制
- ✅ 可以包含42MB的语音模型
- ✅ 所有功能立即可用
📋 完整操作步骤
步骤1：在 HBuilderX 中打开项目
确保项目已经打开：fronted_uniapp
步骤2：制作自定义调试基座
2.1 点击菜单
运行 → 运行到手机或模拟器 → 制作自定义调试基座
或者：
发行 → 原生App-本地打包 → 生成本地打包App资源
推荐：制作自定义调试基座（更简单）
2.2 选择打包方式
会弹出对话框，选择：
方式1：使用云端证书（推荐） ✅
- ✅ 简单，DCloud提供证书
- ✅ 无需配置
- ⚠️ 证书是公共的，不能上架应用商店
方式2：使用自有证书
- ✅ 可以上架应用商店
- ❌ 需要自己生成证书（复杂）
现在选择：使用云端证书
2.3 选择平台
- ☑ Android
- ☐ iOS（如果需要iOS也勾选）
点击：打包
步骤3：等待打包完成
3.1 查看控制台
HBuilderX 底部的控制台会显示打包进度：
[HBuilder] 开始制作自定义基座...
[HBuilder] 正在编译...
[HBuilder] 正在打包Android资源...
[HBuilder] 正在生成APK...
[HBuilder] 打包成功！
预计时间：5-15分钟（首次可能更久）
3.2 成功标志
看到类似信息：
[HBuilder] 自定义基座制作成功
[HBuilder] Android基座路径：
C:\Users\Administrator\Desktop\Project\ry_study-v_03\fronted_uniapp\unpackage\debug\android_debug.apk
步骤4：安装自定义基座到手机
4.1 找到APK文件
路径：
项目目录/unpackage/debug/android_debug.apk
4.2 安装到手机
方法A：USB连接
- 手机通过USB连接电脑
- 开启手机的USB调试
- 将APK拖到手机
- 在手机上安装
方法B：通过HBuilderX直接安装
运行 → 运行到手机或模拟器 → 运行到Android App基座
选择您的设备
步骤5：使用自定义基座运行
5.1 选择运行方式
在 HBuilderX 中：
运行 → 运行到手机或模拟器 → 运行到Android App基座
重要： 选择"运行到Android App基座"，而不是"运行到手机"
5.2 选择设备
选择已安装自定义基座的手机
5.3 开始运行
HBuilderX 会将代码同步到自定义基座中运行
步骤6：测试语音功能
- 打开APP
- 进入语音测评页面
- 测试语音识别功能
- ✅ 应该正常工作！
🎯 自定义基座 vs 云端打包
| 特性 | 自定义基座 | 云端打包 |
|---|---|---|
| 大小限制 | 无限制 ✅ | 40MB ❌ |
| 打包时间 | 5-15分钟 | 2-5分钟 |
| 证书 | 云端或自有 | 云端或自有 |
| 开发调试 | 方便 ✅ | 一般 |
| 正式发布 | 可以 ✅ | 可以 ✅ |
| 包含模型 | 可以 ✅ | 不能 ❌ |
⚠️ 常见问题
Q1：自定义基座可以发布吗？
A： 可以！
自定义基座就是完整的APK，可以：
- ✅ 直接分发给用户
- ✅ 上传到应用商店（需要自有证书）
- ✅ 作为正式版本发布
但是：
- 如果用云端证书，不能上架应用商店
- 如果用自有证书，可以上架
Q2：自定义基座和云端打包有什么区别？
本质上没区别！
- 自定义基座 = 本地/云端编译的完整APK
- 云端打包 = 云端编译的完整APK
唯一区别：
- 自定义基座没有40MB限制
- 云端打包有40MB限制
Q3：每次修改代码都要重新制作基座吗？
不需要！
开发阶段：
- 制作一次基座
- 之后修改代码，直接"运行到基座"
- HBuilderX会自动同步代码
- 除非修改了manifest.json或原生插件
发布阶段：
- 代码稳定后
- 重新制作基座
- 这个基座就是最终APK
Q4：打包失败怎么办？
常见原因：
-
插件版本冲突
- 清理：
unpackage目录 - 重新打包
- 清理：
-
证书问题
- 使用云端证书
- 或重新生成自有证书
-
网络问题
- 检查HBuilderX网络连接
- 检查防火墙设置
-
Gradle下载失败
- 配置Gradle镜像
- 或等待自动重试
Q5：自定义基座很大怎么办？
原因：
- 包含了所有资源和插件
- 语音模型42MB
- 其他资源
正常大小：
- 50-100MB是正常的
- 语音识别APP通常较大
- 微信: 200MB+
- 抖音: 100MB+
如果想减小：
- 压缩图片资源
- 移除未使用的插件
- 使用运行时下载（后续优化）
🚀 开始制作自定义基座
现在在 HBuilderX 中操作：
- ✅ 确保模型文件已恢复（已完成）
- ✅ 保存所有文件（Ctrl+Shift+S）
- ✅ 点击菜单：
运行 → 运行到手机或模拟器 → 制作自定义调试基座 - ✅ 选择：使用云端证书
- ✅ 勾选：Android
- ✅ 点击：打包
- ⏰ 等待 5-15 分钟
- ✅ 打包成功！
- ✅ 安装到手机
- ✅ 测试语音功能
📊 预期结果
自定义基座APK：
- 文件名:
android_debug.apk或android_release.apk - 大小: 约 80-120MB
- 位置:
unpackage/debug/或unpackage/release/ - 功能: 完整，包含语音识别
运行效果：
- ✅ 所有页面正常
- ✅ 语音识别功能正常
- ✅ 模型文件在APP内部
- ✅ 无需额外下载
💡 后续优化建议
开发阶段（现在）：
使用自定义基座，快速开发和测试
正式发布：
选项A：继续使用自定义基座
- 简单，一次打包即可
- 用户下载即用，无需等待
选项B：改用运行时下载
- APK减小42MB
- 首次使用需下载1-2分钟
- 代码参考：
log/运行时下载模型完整示例.md
✅ 总结
- 模型文件已恢复 ✅
- 使用自定义基座打包 ✅
- 没有大小限制 ✅
- 语音功能正常 ✅
- 可以作为正式版发布 ✅
现在请在 HBuilderX 中制作自定义基座！ 🚀
如果遇到问题，随时告诉我！ 💬