301 lines
6.2 KiB
Markdown
301 lines
6.2 KiB
Markdown
# 云端打包缓存清除完整步骤
|
||
|
||
## ❌ **问题现状**
|
||
|
||
云端打包仍然报错：`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（自定义基座）！** 🚀
|