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/
|
||
|
||
═══════════════════════════════════════════════════════════════
|
||
问题已解决！祝您打包顺利！
|
||
═══════════════════════════════════════════════════════════════
|