# 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` 目录，使用微信开发者工具导入该目录即可。