guoyu/Test/备份/log_备份/md/内层_下载SDK并打包指南.md

# Android Studio 打包完整指南

## 🎯 项目信息

- **AppID**: `__UNI__08E0C13`
- **包名**: `uni.app.UNI08E0C13`
- **应用名**: 国语教育平台
- **最低 Android 版本**: 5.0 (API 21)

---

## 📥 第一步：下载 uni-app Android 离线 SDK

### 方法 1：官网下载（推荐）

1. 访问：https://nativesupport.dcloud.net.cn/AppDocs/download/android
2. 下载最新版本（例如：`HBuilder-Integrate-AS-4.x.zip`）
3. 解压到：`D:\SDK\HBuilder-Android\`
4. 解压后应该有这个目录：
   ```
   D:\SDK\HBuilder-Android\HBuilder-Integrate-AS\
   ```

### 方法 2：直接下载链接

- 稳定版：https://download1.dcloud.net.cn/download/HBuilder-Integrate-AS.zip
- 如果下载慢，可以使用国内CDN镜像

### 验证下载

解压后目录结构应该是：
```
HBuilder-Integrate-AS/
├── simpleDemo/           ← Android Studio 项目
│   ├── build.gradle
│   ├── src/
│   │   └── main/
│   │       ├── assets/
│   │       └── java/
│   └── libs/
├── gradle/
└── build.gradle
```

---

## ⚙️ 第二步：自动集成资源

下载 SDK 后，运行自动集成脚本：

```powershell
# 在 PowerShell 中执行
cd d:\Desktop\Project\ry_study-v_03\ry_study-v_03\fronted_uniapp\fronted_uniapp

# 运行集成脚本
.\integrate-to-android-studio.ps1
```

**脚本会自动完成：**
- ✅ 复制 Web 资源到 SDK
- ✅ 复制 Vosk 语音库
- ✅ 更新应用配置
- ✅ 生成 Gradle 配置

---

## 🔧 第三步：打开 Android Studio

### 1. 启动 Android Studio

### 2. 打开项目
- 点击 **File → Open**
- 选择目录：`D:\SDK\HBuilder-Android\HBuilder-Integrate-AS`
- 点击 **OK**

### 3. 等待 Gradle 同步
- 首次打开会自动下载依赖
- 大约需要 5-10 分钟
- 等待底部状态栏显示"Gradle sync finished"

---

## 📝 第四步：修改 build.gradle

打开 `simpleDemo/build.gradle`，添加以下配置：

### 找到 android { } 块，修改为：

```gradle
android {
    compileSdkVersion 33
    
    defaultConfig {
        applicationId "uni.app.UNI08E0C13"
        minSdkVersion 21  // Vosk 要求
        targetSdkVersion 33
        versionCode 100
        versionName "1.0.0"
        
        multiDexEnabled true
    }
    
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}
```

### 找到 dependencies { } 块，添加：

```gradle
dependencies {
    // 原有依赖...
    
    // 添加 Vosk 语音库
    implementation files('libs/vosk-android-0.3.47.aar')
    implementation 'net.java.dev.jna:jna:5.12.1'
}
```

### 找到 repositories { } 块（如果没有就添加）：

```gradle
repositories {
    maven { url 'https://maven.aliyun.com/repository/public' }
    maven { url 'https://maven.aliyun.com/repository/google' }
    maven { url 'https://repo1.maven.org/maven2/' }
    google()
    mavenCentral()
}
```

### 保存并同步
- 点击顶部的 **Sync Now**
- 等待同步完成

---

## 🚀 第五步：构建 APK

### 方法 1：使用菜单（推荐）

1. 点击菜单：**Build → Build Bundle(s) / APK(s) → Build APK(s)**
2. 等待构建完成（首次约 5-10 分钟）
3. 构建完成后，点击弹出的通知中的 **locate** 查看 APK

### 方法 2：使用命令行

```powershell
cd D:\SDK\HBuilder-Android\HBuilder-Integrate-AS

# 构建 Debug 版本
.\gradlew assembleDebug

# 构建 Release 版本
.\gradlew assembleRelease
```

### APK 输出位置

```
D:\SDK\HBuilder-Android\HBuilder-Integrate-AS\simpleDemo\build\outputs\apk\debug\simpleDemo-debug.apk
```

---

## 📱 第六步：安装测试

### 使用 ADB 安装

```powershell
adb install simpleDemo\build\outputs\apk\debug\simpleDemo-debug.apk
```

### 手动安装
1. 将 APK 文件传输到手机
2. 在手机上安装
3. 测试所有功能

---

## ✅ 功能验证清单

安装后测试以下功能：

- [ ] 应用正常启动
- [ ] 连接到服务器 (192.168.1.8:30091)
- [ ] 登录功能
- [ ] 查看课件
- [ ] 学习记录上传
- [ ] 考试功能
- [ ] **语音测评**（关键功能）

---

## 🐛 常见问题

### 1. Gradle 同步失败

**原因**: 网络问题或依赖下载失败

**解决**:
```gradle
// 在 build.gradle 顶部添加
allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public' }
        google()
        mavenCentral()
    }
}
```

### 2. 找不到 Vosk 库

**检查**:
```powershell
# 确认文件存在
Test-Path "D:\SDK\HBuilder-Android\HBuilder-Integrate-AS\simpleDemo\libs\vosk-android-0.3.47.aar"
```

**解决**: 重新运行集成脚本

### 3. 构建失败：minSdkVersion

**错误**: `Manifest merger failed : uses-sdk:minSdkVersion 16 cannot be smaller than version 21`

**解决**: 确保 `build.gradle` 中设置了 `minSdkVersion 21`

### 4. 应用闪退

**原因**: 可能是配置文件问题

**检查**:
```xml
<!-- assets/data/dcloud_control.xml -->
<hbuilder>
    <apps>
        <app appid="__UNI__08E0C13" appver="1.0.0"/>
    </apps>
</hbuilder>
```

---

## 🎉 完成！

构建成功后，你将获得一个完整功能的 APK，包含：
- ✅ 所有业务功能
- ✅ 语音测评（Vosk）
- ✅ 连接内网服务器
- ✅ 学习记录和考试功能

---

## 📚 相关文件

- **集成脚本**: `integrate-to-android-studio.ps1`
- **Gradle 配置示例**: `build.gradle.sample`
- **本指南**: `下载SDK并打包指南.md`

---

## 💡 提示

如果你有任何问题：
1. 查看 Android Studio 的 **Build** 窗口查看详细错误
2. 检查 **Logcat** 查看运行时错误
3. 确保 Vosk AAR 文件正确复制到 libs 目录