guoyu/log/备份/md/内层_BUILD_GUIDE.md

uni-app 项目打包指南

问题说明

npm run build:app 命令只会编译项目代码到 unpackage/dist/build/app-plus 目录，但不会生成最终的 APK 或 IPA 安装包。

解决方案

方案一：使用 HBuilderX（推荐）

1. 下载并安装 HBuilderX

   • 访问：https://www.dcloud.io/hbuilderx.html
   • 下载 HBuilderX App 开发版

2. 在 HBuilderX 中打开项目

   • 打开 HBuilderX
   • 文件 -> 打开目录 -> 选择本项目根目录

3. 云端打包（推荐）

   • 点击菜单：发行 -> 原生App-云打包
   • 选择打包平台（Android/iOS）
   • 配置证书和签名（Android 可以使用公共测试证书）
   • 点击打包，等待云端打包完成
   • 下载生成的 APK/IPA 文件

4. 本地打包（需要配置原生开发环境）

   • 点击菜单：发行 -> 原生App-本地打包
   • 需要预先配置 Android Studio 或 Xcode
   • 生成原生工程后，使用原生 IDE 打包

方案二：使用 DCloud 云打包服务

1. 注册 DCloud 账号

   • 访问：https://dev.dcloud.net.cn/
   • 注册并登录账号

2. 配置 manifest.json

   • 确保 src/manifest.json 中的 appid 已正确配置
   • 当前配置：__UNI__71560C7

3. 使用 HBuilderX 云打包

   • 必须使用 HBuilderX 进行云打包
   • 命令行工具不支持直接打包成 APK

方案三：生成离线打包资源（高级）

如果您需要自己打包，可以：

1. 运行编译命令

   npm run build:app
   

2. 获取编译产物

   • 编译后的资源位于：unpackage/dist/build/app-plus

3. 使用原生开发工具

   • Android: 需要 Android Studio 和 uni-app 离线 SDK

     • 下载 Android 离线 SDK：https://nativesupport.dcloud.net.cn/AppDocs/download/android
     • 将编译产物复制到离线 SDK 的 assets 目录
     • 使用 Android Studio 打包 APK

   • iOS: 需要 Xcode 和 uni-app 离线 SDK

     • 下载 iOS 离线 SDK：https://nativesupport.dcloud.net.cn/AppDocs/download/ios
     • 将编译产物复制到离线 SDK 的资源目录
     • 使用 Xcode 打包 IPA

推荐流程

对于快速测试和发布，强烈推荐使用方案一（HBuilderX 云打包）：

1. 安装 HBuilderX
2. 在 HBuilderX 中打开项目
3. 使用云打包功能
4. 下载生成的安装包

当前项目配置

• 项目名称: 国语教育平台
• AppID: __UNI__71560C7
• 版本号: 1.0.0 (versionCode: 100)
• 目标平台: Android (minSdk: 21, targetSdk: 30)

注意事项

1. ⚠️ CLI 命令 npm run build:app 只编译代码，不生成安装包
2. ⚠️ 必须使用 HBuilderX 或配置完整的原生开发环境才能生成 APK/IPA
3. ⚠️ 云打包需要 DCloud 账号
4. ⚠️ iOS 打包需要 Apple 开发者账号和证书

快速开始

如果您只是想快速测试应用：

1. 下载 HBuilderX：https://www.dcloud.io/hbuilderx.html
2. 打开本项目
3. 点击"发行" -> "原生App-云打包"
4. 选择 Android，使用公共测试证书
5. 等待打包完成并下载 APK

其他平台打包

H5 打包（Web）

npm run build:h5

打包后的文件在 unpackage/dist/build/h5 目录，可直接部署到 Web 服务器。

微信小程序打包

npm run build:mp-weixin

打包后的文件在 unpackage/dist/build/mp-weixin 目录，使用微信开发者工具导入该目录即可。