133 lines
4.3 KiB
Plaintext
133 lines
4.3 KiB
Plaintext
|
═══════════════════════════════════════════════════════════════
|
|||
|
|
uni-app 项目打包问题 - 解决方案
|
|||
|
|
═══════════════════════════════════════════════════════════════
|
|||
|
|
|
|||
|
|
【问题描述】
|
|||
|
|
运行 npm run build:app 后，项目一直在编译，编译成功但不生成 APK 安装包。
|
|||
|
|
|
|||
|
|
【问题原因】
|
|||
|
|
这不是 bug，而是 uni-app 的正常行为！
|
|||
|
|
|
|||
|
|
npm run build:app 命令只负责：
|
|||
|
|
✓ 编译 Vue 代码
|
|||
|
|
✓ 打包资源文件
|
|||
|
|
✓ 生成中间产物到 unpackage/dist/build/app-plus
|
|||
|
|
|
|||
|
|
它不会生成最终的 APK 或 IPA 安装包！
|
|||
|
|
|
|||
|
|
【解决方案】
|
|||
|
|
|
|||
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|||
|
|
方案一：使用 HBuilderX（最简单，推荐！）
|
|||
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|||
|
|
|
|||
|
|
步骤：
|
|||
|
|
1. 下载 HBuilderX
|
|||
|
|
网址：https://www.dcloud.io/hbuilderx.html
|
|||
|
|
下载"App 开发版"
|
|||
|
|
|
|||
|
|
2. 打开项目
|
|||
|
|
HBuilderX -> 文件 -> 打开目录 -> 选择本项目
|
|||
|
|
|
|||
|
|
3. 云端打包
|
|||
|
|
菜单栏 -> 发行 -> 原生App-云打包
|
|||
|
|
- 选择 Android
|
|||
|
|
- 使用公共测试证书
|
|||
|
|
- 点击打包
|
|||
|
|
- 等待 5-10 分钟
|
|||
|
|
- 下载 APK
|
|||
|
|
|
|||
|
|
优点：
|
|||
|
|
✓ 最简单，无需配置
|
|||
|
|
✓ 5-10 分钟即可获得 APK
|
|||
|
|
✓ 支持 Android 和 iOS
|
|||
|
|
✓ 免费使用
|
|||
|
|
|
|||
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|||
|
|
方案二：使用辅助脚本（了解构建过程）
|
|||
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|||
|
|
|
|||
|
|
我已经为您创建了辅助脚本，运行：
|
|||
|
|
|
|||
|
|
npm run build:app-help
|
|||
|
|
|
|||
|
|
或者双击运行：
|
|||
|
|
|
|||
|
|
构建App.bat
|
|||
|
|
|
|||
|
|
这个脚本会：
|
|||
|
|
✓ 执行构建
|
|||
|
|
✓ 显示构建结果
|
|||
|
|
✓ 提供详细的下一步指南
|
|||
|
|
|
|||
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|||
|
|
方案三：离线打包（高级用户）
|
|||
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|||
|
|
|
|||
|
|
需要：
|
|||
|
|
- Android Studio
|
|||
|
|
- uni-app 离线 SDK
|
|||
|
|
- 配置原生开发环境
|
|||
|
|
|
|||
|
|
详细步骤请查看：BUILD_GUIDE.md
|
|||
|
|
|
|||
|
|
【已创建的文件】
|
|||
|
|
|
|||
|
|
1. README_BUILD.md
|
|||
|
|
→ 完整的构建说明文档（中文）
|
|||
|
|
|
|||
|
|
2. BUILD_GUIDE.md
|
|||
|
|
→ 详细的打包指南
|
|||
|
|
|
|||
|
|
3. build-helper.ps1
|
|||
|
|
→ PowerShell 辅助脚本
|
|||
|
|
|
|||
|
|
4. 构建App.bat
|
|||
|
|
→ 一键构建脚本（双击运行）
|
|||
|
|
|
|||
|
|
5. package.json（已更新）
|
|||
|
|
→ 添加了新的构建命令
|
|||
|
|
|
|||
|
|
【快速开始】
|
|||
|
|
|
|||
|
|
最快的方式（推荐）：
|
|||
|
|
1. 下载 HBuilderX（5 分钟）
|
|||
|
|
2. 打开本项目（1 分钟）
|
|||
|
|
3. 云端打包（10 分钟）
|
|||
|
|
4. 下载 APK 测试
|
|||
|
|
|
|||
|
|
总耗时：约 15-20 分钟
|
|||
|
|
|
|||
|
|
【重要提示】
|
|||
|
|
|
|||
|
|
✓ npm run build:app 只编译代码，不生成 APK
|
|||
|
|
✓ 必须使用 HBuilderX 或离线 SDK 才能生成安装包
|
|||
|
|
✓ 这是 uni-app 的正常工作方式，不是 bug
|
|||
|
|
✓ 推荐使用 HBuilderX 云打包，最简单快速
|
|||
|
|
|
|||
|
|
【其他平台】
|
|||
|
|
|
|||
|
|
H5 平台（Web）：
|
|||
|
|
npm run build:h5
|
|||
|
|
→ 可直接部署到 Web 服务器
|
|||
|
|
|
|||
|
|
微信小程序：
|
|||
|
|
npm run build:mp-weixin
|
|||
|
|
→ 使用微信开发者工具导入
|
|||
|
|
|
|||
|
|
【需要帮助？】
|
|||
|
|
|
|||
|
|
查看详细文档：
|
|||
|
|
- README_BUILD.md（推荐阅读）
|
|||
|
|
- BUILD_GUIDE.md
|
|||
|
|
|
|||
|
|
运行辅助脚本：
|
|||
|
|
npm run build:app-help
|
|||
|
|
|
|||
|
|
访问官方文档：
|
|||
|
|
https://uniapp.dcloud.net.cn/
|
|||
|
|
|
|||
|
|
═══════════════════════════════════════════════════════════════
|
|||
|
|
问题已解决！祝您打包顺利！
|
|||
|
|
═══════════════════════════════════════════════════════════════
|