guoyu/log/云端打包缓存清除完整步骤.md

# 云端打包缓存清除完整步骤

## ❌ **问题现状**

云端打包仍然报错：`Cannot find a parameter with this name: errorMsg`

**原因：** 云端使用了缓存的旧代码（version 1.0.9），没有使用最新的代码（version 1.0.12）

---

## ✅ **已完成的修改**

1. ✅ **插件版本升级**
   - 从 `1.0.9` → `1.0.12`
   - 文件：`uni_modules/xwq-speech-to-text/package.json`

2. ✅ **代码已修复**
   - 所有 `error` 已改为 `errorMsg`
   - 文件：`uni_modules/xwq-speech-to-text/utssdk/app-android/index.uts`

3. ✅ **添加版本标记**
   - 在代码开头添加了 `VERSION: 1.0.12` 注释

---

## 🚀 **彻底清除云端缓存的方法**

### **方法1：使用自定义基座（推荐）** ⭐⭐⭐⭐⭐

自定义基座不使用云端编译，直接在本地编译插件。

#### **步骤：**

1. **在 HBuilderX 中：**
   ```
   运行 → 运行到手机或模拟器 → 制作自定义调试基座
   ```

2. **选择证书：**
   - 使用云端证书或
   - 使用自有证书

3. **等待编译完成**（约 5-10 分钟）

4. **安装自定义基座到手机**

5. **使用自定义基座运行**
   ```
   运行 → 运行到手机或模拟器 → 运行到自定义基座
   ```

**优点：**
- ✅ 完全避免云端缓存问题
- ✅ 编译速度更可控
- ✅ 可以重复使用

---

### **方法2：修改插件 ID（强制清除缓存）** ⭐⭐⭐⭐

修改插件 ID，云端会认为这是全新的插件。

#### **步骤：**

1. **修改 `package.json`**
   ```json
   {
     "id": "xwq-speech-to-text-fixed",  // 改名！
     "version": "1.0.12"
   }
   ```

2. **保存所有文件**
   ```
   Ctrl + Shift + S
   ```

3. **重新云端打包**

**注意：** 打包成功后，记得改回原来的 ID！

---

### **方法3：联系 DCloud 清理服务器缓存** ⭐⭐⭐

如果以上方法都不行，联系官方：

1. **访问 DCloud 论坛**
   ```
   https://ask.dcloud.net.cn/
   ```

2. **发帖说明情况**
   ```
   标题：云端打包缓存未更新，请求清理
   内容：
   - 项目 ID: __UNI__08E0C13
   - 插件: xwq-speech-to-text
   - 版本: 1.0.12
   - 问题: 云端仍使用旧代码编译
   ```

3. **等待官方处理**（通常 1-2 工作日）

---

### **方法4：等待云端缓存过期** ⭐⭐

DCloud 云端缓存通常会在 24-48 小时后自动过期。

**操作：**
- 明天或后天再尝试打包
- 不修改任何代码
- 直接打包

---

### **方法5：删除并重新导入插件** ⭐⭐

完全删除插件，然后重新导入。

#### **步骤：**

1. **备份插件目录**
   ```
   复制整个 uni_modules/xwq-speech-to-text 文件夹到桌面
   ```

2. **在 HBuilderX 中删除插件**
   ```
   右键 uni_modules/xwq-speech-to-text → 删除
   ```

3. **重启 HBuilderX**

4. **重新导入插件**
   ```
   将备份的 xwq-speech-to-text 文件夹
   复制回 uni_modules/ 目录
   ```

5. **重新打包**

---

## 📋 **推荐执行顺序**

### **立即可以尝试：方法2（修改插件ID）**

1. **修改 `package.json` 中的 `id`**
   ```json
   "id": "xwq-speech-to-text-v2"
   ```

2. **保存所有文件**

3. **云端打包**

4. **如果成功，改回原 ID：**
   ```json
   "id": "xwq-speech-to-text"
   ```

---

### **如果方法2不行：使用方法1（自定义基座）**

这是最可靠的方法，完全避免云端缓存问题。

---

## 🎯 **验证是否使用新代码**

### **检查打包日志**

打包时查看日志，应该显示：

```
✅ 正确：
[HBuilder] 编译插件 xwq-speech-to-text (1.0.12)
[HBuilder] BUILD SUCCESSFUL

❌ 错误（仍使用旧代码）：
[HBuilder] 编译插件 xwq-speech-to-text (1.0.9)
[HBuilder] Cannot find a parameter with this name: errorMsg
```

---

## ⚠️ **注意事项**

### **1. 保存所有文件**

修改后必须保存：
```
Ctrl + Shift + S  (保存所有)
```

### **2. 不要同时打包多个版本**

如果有打包任务在队列中，等待完成或取消后再打包。

### **3. 检查网络**

确保 HBuilderX 可以正常连接云端服务器。

### **4. 避免频繁打包**

如果短时间内多次打包失败，可能被限流，等待 10-15 分钟再试。

---

## 🔧 **临时解决方案：本地打包（如果有 Android Studio）**

如果您有 Android Studio 和 Android SDK：

### **步骤：**

1. **导出 Android 项目**
   ```
   HBuilderX → 发行 → 原生 App-本地打包 → 生成本地打包App资源
   ```

2. **用 Android Studio 打开项目**
   ```
   打开 unpackage/resources/__UNI__08E0C13/android/
   ```

3. **编译 APK**
   ```
   Build → Build Bundle(s) / APK(s) → Build APK(s)
   ```

**优点：**
- ✅ 完全本地编译，无缓存问题
- ✅ 可以实时查看编译过程

**缺点：**
- ❌ 需要安装 Android Studio
- ❌ 需要配置 Android SDK
- ❌ 首次配置较复杂

---

## 📊 **各方法对比**

| 方法 | 成功率 | 时间 | 难度 | 推荐度 |
|------|--------|------|------|--------|
| 自定义基座 | ⭐⭐⭐⭐⭐ | 10分钟 | 简单 | ⭐⭐⭐⭐⭐ |
| 修改插件ID | ⭐⭐⭐⭐ | 5分钟 | 简单 | ⭐⭐⭐⭐ |
| 联系官方 | ⭐⭐⭐⭐⭐ | 1-2天 | 简单 | ⭐⭐⭐ |
| 等待过期 | ⭐⭐⭐ | 1-2天 | 简单 | ⭐⭐ |
| 删除重导 | ⭐⭐⭐ | 10分钟 | 简单 | ⭐⭐⭐ |
| 本地打包 | ⭐⭐⭐⭐⭐ | 30分钟 | 复杂 | ⭐⭐ |

---

## ✅ **总结**

### **立即尝试**

1. **方法2：修改插件 ID** → 快速测试
2. **方法1：自定义基座** → 最可靠

### **如果以上都不行**

3. **方法3：联系官方** → 等待官方处理

---

## 📞 **获取帮助**

### **DCloud 官方支持**

- **论坛：** https://ask.dcloud.net.cn/
- **文档：** https://uniapp.dcloud.net.cn/
- **QQ群：** 见官网

### **搜索类似问题**

在 DCloud 论坛搜索：
```
"云端打包缓存"
"Cannot find a parameter"
"插件打包失败"
```

---

## 🎯 **下一步操作**

1. **保存所有修改**（已完成 ✅）
2. **选择一个方法执行**
3. **打包并查看日志**
4. **如果成功，测试语音功能**
5. **如果失败，尝试下一个方法**

---

**现在建议您先尝试方法2（修改插件ID），如果不行再使用方法1（自定义基座）！** 🚀