113 lines
3.4 KiB
Markdown
113 lines
3.4 KiB
Markdown
|
# 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. **运行编译命令**
|
|||
|
|
```bash
|
|||
|
|
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）
|
|||
|
|
```bash
|
|||
|
|
npm run build:h5
|
|||
|
|
```
|
|||
|
|
打包后的文件在 `unpackage/dist/build/h5` 目录，可直接部署到 Web 服务器。
|
|||
|
|
|
|||
|
|
### 微信小程序打包
|
|||
|
|
```bash
|
|||
|
|
npm run build:mp-weixin
|
|||
|
|
```
|
|||
|
|
打包后的文件在 `unpackage/dist/build/mp-weixin` 目录，使用微信开发者工具导入该目录即可。
|