# 自定义基座打包完整步骤

## 🎯 **为什么使用自定义基座？**

### **问题**
- 云端打包限制：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连接**
1. 手机通过USB连接电脑
2. 开启手机的USB调试
3. 将APK拖到手机
4. 在手机上安装

**方法B：通过HBuilderX直接安装**
```
运行 → 运行到手机或模拟器 → 运行到Android App基座
选择您的设备
```

---

### **步骤5：使用自定义基座运行**

#### **5.1 选择运行方式**

在 HBuilderX 中：

```
运行 → 运行到手机或模拟器 → 运行到Android App基座
```

**重要：** 选择"运行到Android App基座"，而不是"运行到手机"

#### **5.2 选择设备**

选择已安装自定义基座的手机

#### **5.3 开始运行**

HBuilderX 会将代码同步到自定义基座中运行

---

### **步骤6：测试语音功能**

1. 打开APP
2. 进入语音测评页面
3. 测试语音识别功能
4. ✅ 应该正常工作！

---

## 🎯 **自定义基座 vs 云端打包**

| 特性 | 自定义基座 | 云端打包 |
|------|-----------|---------|
| **大小限制** | 无限制 ✅ | 40MB ❌ |
| **打包时间** | 5-15分钟 | 2-5分钟 |
| **证书** | 云端或自有 | 云端或自有 |
| **开发调试** | 方便 ✅ | 一般 |
| **正式发布** | 可以 ✅ | 可以 ✅ |
| **包含模型** | 可以 ✅ | 不能 ❌ |

---

## ⚠️ **常见问题**

### **Q1：自定义基座可以发布吗？**

**A：** 可以！

自定义基座就是完整的APK，可以：
- ✅ 直接分发给用户
- ✅ 上传到应用商店（需要自有证书）
- ✅ 作为正式版本发布

**但是：**
- 如果用云端证书，不能上架应用商店
- 如果用自有证书，可以上架

---

### **Q2：自定义基座和云端打包有什么区别？**

**本质上没区别！**

- 自定义基座 = 本地/云端编译的完整APK
- 云端打包 = 云端编译的完整APK

唯一区别：
- 自定义基座没有40MB限制
- 云端打包有40MB限制

---

### **Q3：每次修改代码都要重新制作基座吗？**

**不需要！**

**开发阶段：**
- 制作一次基座
- 之后修改代码，直接"运行到基座"
- HBuilderX会自动同步代码
- 除非修改了manifest.json或原生插件

**发布阶段：**
- 代码稳定后
- 重新制作基座
- 这个基座就是最终APK

---

### **Q4：打包失败怎么办？**

**常见原因：**

1. **插件版本冲突**
   - 清理：`unpackage` 目录
   - 重新打包

2. **证书问题**
   - 使用云端证书
   - 或重新生成自有证书

3. **网络问题**
   - 检查HBuilderX网络连接
   - 检查防火墙设置

4. **Gradle下载失败**
   - 配置Gradle镜像
   - 或等待自动重试

---

### **Q5：自定义基座很大怎么办？**

**原因：**
- 包含了所有资源和插件
- 语音模型42MB
- 其他资源

**正常大小：**
- 50-100MB是正常的
- 语音识别APP通常较大
- 微信: 200MB+
- 抖音: 100MB+

**如果想减小：**
- 压缩图片资源
- 移除未使用的插件
- 使用运行时下载（后续优化）

---

## 🚀 **开始制作自定义基座**

### **现在在 HBuilderX 中操作：**

1. ✅ 确保模型文件已恢复（已完成）
2. ✅ 保存所有文件（Ctrl+Shift+S）
3. ✅ 点击菜单：
   ```
   运行 → 运行到手机或模拟器 → 制作自定义调试基座
   ```
4. ✅ 选择：使用云端证书
5. ✅ 勾选：Android
6. ✅ 点击：打包
7. ⏰ 等待 5-15 分钟
8. ✅ 打包成功！
9. ✅ 安装到手机
10. ✅ 测试语音功能

---

## 📊 **预期结果**

### **自定义基座APK：**
- 文件名: `android_debug.apk` 或 `android_release.apk`
- 大小: 约 80-120MB
- 位置: `unpackage/debug/` 或 `unpackage/release/`
- 功能: 完整，包含语音识别

### **运行效果：**
- ✅ 所有页面正常
- ✅ 语音识别功能正常
- ✅ 模型文件在APP内部
- ✅ 无需额外下载

---

## 💡 **后续优化建议**

### **开发阶段（现在）：**
使用自定义基座，快速开发和测试

### **正式发布：**

**选项A：继续使用自定义基座**
- 简单，一次打包即可
- 用户下载即用，无需等待

**选项B：改用运行时下载**
- APK减小42MB
- 首次使用需下载1-2分钟
- 代码参考：`log/运行时下载模型完整示例.md`

---

## ✅ **总结**

1. **模型文件已恢复** ✅
2. **使用自定义基座打包** ✅
3. **没有大小限制** ✅
4. **语音功能正常** ✅
5. **可以作为正式版发布** ✅

---

**现在请在 HBuilderX 中制作自定义基座！** 🚀

**如果遇到问题，随时告诉我！** 💬