314 lines
10 KiB
Plaintext
314 lines
10 KiB
Plaintext
═══════════════════════════════════════════════════════════════
|
||
正式版打包完整指南
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
【缓存清理状态】✅ 已完成
|
||
|
||
已删除以下缓存目录：
|
||
✓ unpackage/ - 编译输出缓存
|
||
✓ node_modules/ - 依赖包（如果存在）
|
||
✓ .hbuilderx/ - HBuilderX 配置缓存
|
||
|
||
|
||
【当前项目信息】
|
||
|
||
项目路径：D:\Desktop\fronted_uniapp\
|
||
AppID：__UNI__08E0C13
|
||
应用名称：国语教育平台
|
||
版本号：1.1.0
|
||
Android包名：com.yuyinedu.app ✓
|
||
服务器地址：192.168.0.106:8080
|
||
|
||
|
||
【正式版打包步骤】
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 1：重启 HBuilderX（重要）
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
1. 完全关闭 HBuilderX
|
||
|
||
2. 重新启动 HBuilderX
|
||
|
||
3. 打开项目：
|
||
文件 → 打开目录 → D:\Desktop\fronted_uniapp
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 2：验证项目配置
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
1. 打开 manifest.json（在项目根目录）
|
||
|
||
2. 检查以下配置：
|
||
☑ appid: "__UNI__08E0C13"
|
||
☑ name: "国语教育平台"
|
||
☑ versionName: "1.1.0"
|
||
☑ versionCode: "101"
|
||
☑ android.packagename: "com.yuyinedu.app"
|
||
|
||
3. 如果需要修改版本号：
|
||
- versionName: "1.1.0" → "1.2.0"（显示版本）
|
||
- versionCode: "101" → "102"（内部版本号，必须递增）
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 3：开始云打包
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
1. 点击菜单：发行 → 原生App-云打包
|
||
|
||
2. 在弹出的打包窗口中配置：
|
||
|
||
【平台选择】
|
||
☑ Android (apk)
|
||
☐ iOS（如果不需要可以不选）
|
||
|
||
【Android 打包选项】
|
||
◉ 使用 DCloud 公共测试证书
|
||
|
||
说明：
|
||
- 公共测试证书：快速打包，用于测试
|
||
- 使用自有证书：需要自己生成证书，用于正式发布
|
||
|
||
如果是第一次打包或测试，选择"公共测试证书"即可
|
||
|
||
3. 点击"打包"按钮
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 4：处理警告对话框（重要）
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
如果弹出警告对话框（包名未录入），请：
|
||
|
||
1. **立即点击"继续打包"按钮**
|
||
⚠️ 不要等待！对话框可能会自动消失
|
||
|
||
2. 如果对话框消失了：
|
||
- 关闭打包窗口
|
||
- 重新打开：发行 → 原生App-云打包
|
||
- 再次点击"打包"
|
||
- 快速点击"继续打包"
|
||
|
||
技巧：
|
||
- 可以准备好鼠标，点击"打包"后立即移动到"继续打包"位置
|
||
- 或者先在开发者中心录入包名（见下方"备选方案"）
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 5：观察控制台输出
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
点击"继续打包"后，控制台应该显示：
|
||
|
||
✓ 正确的输出：
|
||
[HBuilder] 正在连接云端打包服务...
|
||
[HBuilder] 正在打包...
|
||
[HBuilder] 编译中...
|
||
[HBuilder] 打包进度：30%
|
||
[HBuilder] 打包进度：60%
|
||
[HBuilder] 打包进度：90%
|
||
|
||
✗ 如果只显示：
|
||
[HBuilder] 项目 'fronted_uniapp' 编译成功。
|
||
（然后就没有了）
|
||
|
||
说明：打包请求没有提交，需要重新尝试
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 6：等待打包完成
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
1. 等待时间：5-10 分钟（取决于网络和服务器负载）
|
||
|
||
2. 不要关闭 HBuilderX
|
||
|
||
3. 可以在控制台看到打包进度
|
||
|
||
4. 打包成功后，控制台会显示：
|
||
[HBuilder] 打包成功！
|
||
[HBuilder] 下载地址：https://...
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 7：下载 APK
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
1. 点击控制台中的下载链接
|
||
|
||
2. 或者在打包窗口中点击"下载"按钮
|
||
|
||
3. APK 文件名类似：
|
||
国语教育平台_1.1.0_20251122.apk
|
||
|
||
4. 保存到本地
|
||
|
||
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
步骤 8：安装测试
|
||
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
1. 将 APK 传输到 Android 手机
|
||
|
||
2. 安装 APK
|
||
|
||
3. 测试以下功能：
|
||
□ 登录功能
|
||
□ 监控功能（屏幕录制）
|
||
□ 语音识别功能
|
||
□ 考试功能
|
||
□ 网络连接（192.168.0.106:8080）
|
||
|
||
|
||
【备选方案：在开发者中心录入包名】
|
||
|
||
如果警告对话框总是自动消失，可以先在开发者中心录入包名：
|
||
|
||
1. 访问：https://dev.dcloud.net.cn/
|
||
|
||
2. 登录（使用 HBuilderX 右上角的账号）
|
||
|
||
3. 点击"我的应用"
|
||
|
||
4. 找到应用：
|
||
- 应用名称：国语教育平台
|
||
- AppID：__UNI__08E0C13
|
||
|
||
5. 如果找不到，点击"创建应用"：
|
||
- 选择"uni-app"
|
||
- 输入 AppID：__UNI__08E0C13
|
||
- 输入应用名称：国语教育平台
|
||
- 提交
|
||
|
||
6. 进入应用详情
|
||
|
||
7. 找到"Android 包名"输入框
|
||
|
||
8. 填写：com.yuyinedu.app
|
||
|
||
9. 保存
|
||
|
||
10. 回到 HBuilderX 重新打包
|
||
|
||
|
||
【如果云打包失败】
|
||
|
||
方案1：检查网络连接
|
||
- 确保能访问 DCloud 服务器
|
||
- 检查防火墙设置
|
||
|
||
方案2：检查账号状态
|
||
- 确认已登录 DCloud 账号
|
||
- 查看右上角是否显示用户名
|
||
|
||
方案3：使用制作自定义调试基座
|
||
- 菜单：运行 → 运行到手机或模拟器 → 制作自定义调试基座
|
||
- 2-5 分钟生成 APK
|
||
- APK 位置：unpackage/debug/android_debug.apk
|
||
- 虽然是调试版，但功能完整
|
||
|
||
方案4：更新 HBuilderX
|
||
- 下载最新版：https://www.dcloud.io/hbuilderx.html
|
||
- 解压到新目录
|
||
- 重新打开项目
|
||
|
||
|
||
【正式版 vs 测试版】
|
||
|
||
使用 DCloud 公共测试证书打包：
|
||
✓ 快速打包（5-10分钟）
|
||
✓ 功能完整
|
||
✓ 可以正常使用
|
||
⚠️ 不能发布到应用商店
|
||
⚠️ 证书是公共的（不是您专属的）
|
||
|
||
使用自有证书打包：
|
||
✓ 可以发布到应用商店
|
||
✓ 证书是您专属的
|
||
✓ 更专业
|
||
⚠️ 需要自己生成证书（较复杂）
|
||
⚠️ 首次配置需要时间
|
||
|
||
|
||
【生成自有证书（可选）】
|
||
|
||
如果需要发布到应用商店，需要生成自有证书：
|
||
|
||
1. 使用 Android Studio 或 keytool 生成证书
|
||
|
||
2. 命令示例：
|
||
keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000
|
||
|
||
3. 在云打包时选择"使用自有证书"
|
||
|
||
4. 上传证书文件和填写密码
|
||
|
||
|
||
【打包后的文件说明】
|
||
|
||
APK 文件信息：
|
||
- 文件名：国语教育平台_1.1.0_日期.apk
|
||
- 大小：约 20-50 MB（取决于功能）
|
||
- 包名：com.yuyinedu.app
|
||
- 版本：1.1.0 (101)
|
||
- 最低系统：Android 5.0 (API 21)
|
||
- 目标系统：Android 11 (API 30)
|
||
|
||
|
||
【常见问题】
|
||
|
||
Q1：打包按钮点击后没反应？
|
||
A1：检查是否已登录 DCloud 账号（右上角）
|
||
|
||
Q2：编译成功但没有打包？
|
||
A2：警告对话框自动消失了，重新打包并快速点击"继续打包"
|
||
|
||
Q3：打包失败，提示网络错误？
|
||
A3：检查网络连接，或稍后重试
|
||
|
||
Q4：APK 安装后无法连接服务器？
|
||
A4：确保手机和服务器在同一局域网（192.168.0.x）
|
||
|
||
Q5：监控功能不工作？
|
||
A5：检查是否授予了屏幕录制权限
|
||
|
||
|
||
【快速操作清单】
|
||
|
||
□ 重启 HBuilderX
|
||
□ 打开外层项目（D:\Desktop\fronted_uniapp）
|
||
□ 验证 manifest.json 配置
|
||
□ 发行 → 原生App-云打包
|
||
□ ☑ Android + ◉ 公共测试证书
|
||
□ 点击"打包"
|
||
□ 快速点击"继续打包"（如有警告）
|
||
□ 观察控制台输出
|
||
□ 等待 5-10 分钟
|
||
□ 下载 APK
|
||
□ 安装测试
|
||
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
缓存已清理，现在可以开始打包了！
|
||
|
||
关键步骤：
|
||
1. 重启 HBuilderX
|
||
2. 打开外层项目
|
||
3. 发行 → 原生App-云打包
|
||
4. 快速点击"继续打包"（如有警告）
|
||
5. 等待下载 APK
|
||
═══════════════════════════════════════════════════════════════
|
||
|
||
|
||
【技术支持】
|
||
|
||
如果遇到问题：
|
||
1. 查看控制台完整日志
|
||
2. 截图错误信息
|
||
3. 访问 DCloud 社区：https://ask.dcloud.net.cn/
|
||
4. 或联系 DCloud 技术支持
|
||
|
||
祝您打包成功！🎉
|