271 lines
5.6 KiB
Markdown
271 lines
5.6 KiB
Markdown
# 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 目录
|