xiaozhang/guoyu

Fork 0

xiao12feng8 1a9423951c 尝试替换掉语音插件

2025-12-07 00:11:06 +08:00

5.6 KiB

Raw Blame History

Android Studio 打包完整指南

🎯 项目信息

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

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

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

访问：https://nativesupport.dcloud.net.cn/AppDocs/download/android
下载最新版本（例如：HBuilder-Integrate-AS-4.x.zip）
解压到：D:\SDK\HBuilder-Android\

解压后应该有这个目录：

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 中执行
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 { } 块，修改为：

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 { } 块，添加：

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

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

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：使用菜单（推荐）

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

方法 2：使用命令行

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 安装

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

手动安装

将 APK 文件传输到手机
在手机上安装
测试所有功能

✅ 功能验证清单

安装后测试以下功能：

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

🐛 常见问题

1. Gradle 同步失败

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

解决:

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

2. 找不到 Vosk 库

检查:

# 确认文件存在
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. 应用闪退

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

检查:

<!-- 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

💡 提示

如果你有任何问题：

查看 Android Studio 的 Build 窗口查看详细错误
检查 Logcat 查看运行时错误
确保 Vosk AAR 文件正确复制到 libs 目录

5.6 KiB Raw Blame History Unescape Escape