尧图网站建设 
MNN TTS Android Demo 构建实战从 NDK 环境配置到 CMake 原生库链接的全流程解析【免费下载链接】MNNMNN: A blazing-fast, lightweight inference engine battle-tested by Alibaba, powering high-performance on-device LLMs and Edge AI.项目地址: https://gitcode.com/GitHub_Trending/mn/MNN本文基于 MNN 仓库中 MNN TTS Android Demo 构建文档 展开完整覆盖 Demo 的工具链前置要求、Gradle/CMake 双层构建配置、MNN 核心库依赖链与安装运行验证方法。读完本文你可以独立完成该 TTS 演示应用的编译、安装、启动与常见故障排查并理解构建配置背后与源码的直接对应关系。一、项目概述与模块结构MNN TTS Android Demo 是基于 MNNMobile Neural Network推理引擎的文本转语音Text-to-Speech演示应用位于apps/frameworks/mnn_tts/目录下。它展示了如何在 Android 平台上调用 MNN TTS SDK 完成语音合成当前内置了 BertVits2 与 Supertonic 两套 TTS 引擎实现PIPER 为可选构建。整个mnn_tts模块由三部分构成mnn_tts/ ├── android/ # MNN TTS Android 库模块Gradle library module │ ├── build.gradle # 库模块构建配置 │ ├── java/ # Java/Kotlin 源代码 │ └── src/ │ └── main/java/com/alibaba/mnn/tts/ │ └── MNNTTS.kt # SDK 的 Kotlin 封装入口 ├── demo/android/ # Android Demo 应用 │ ├── build.gradle # 应用构建配置 │ ├── settings.gradle # Gradle 项目设置挂载 :mnn_tts 模块 │ ├── src/main/ │ │ ├── java/ # Kotlin 源代码 │ │ └── res/ # Android 资源文件 │ └── build/ # 构建输出目录 ├── include/ # C 头文件mnn_tts_sdk.hpp 等 ├── src/ # C 源代码实现 └── CMakeLists.txt # CMake 构建配置两个 Gradle 模块之间通过 settings.gradle 完成装配根工程名为MNNTTSDemo其中include :mnn_tts一行将库模块的projectDir指向上级../../android目录因此只需打开demo/android一个目录即可同时构建库与应用rootProject.name MNNTTSDemo include :mnn_tts project(:mnn_tts).projectDir new File(../../android)该文件同时通过pluginManagement统一声明了 AGP 与 Kotlin 插件版本com.android.application/com.android.library均为 8.7.3应用侧 Kotlin 插件为 1.9.22。二、前置要求工具链版本与 MNN 核心库依赖2.1 必需的工具与版本以下版本信息来自构建文档并与仓库中的 Gradle 配置逐一核对一致工具要求版本仓库中的依据Android StudioArctic Fox 或更高构建文档推荐Android SDKCompile SDK 35 / Min SDK 21Android 5.0/ Target SDK 35demo build.gradle 中compileSdk 35、minSdk 21、targetSdk 35Android NDK27.2.12479018推荐库模块 build.gradle 中ndkVersion 27.2.12479018JDK17 或更高Gradle 构建构建文档要求Gradle8.9由 Wrapper 自动管理gradle-wrapper.properties 中distributionUrl指向gradle-8.9-bin.zipCMake3.22.1 或更高库模块 build.gradle 中version 3.22.1此外gradle.properties 中开启了 AndroidX、Jetifier 与nonTransitiveRClass并将 Gradle JVM 堆内存设为 2048m。2.2 依赖预编译的 MNN 核心库该 Demo 的 C 层并非从零编译 MNN而是链接一份预编译的libMNN.so。这一点在 CMakeLists.txt 中有明确体现set(MNN_SOURCE_ROOT ${CMAKE_CURRENT_LIST_DIR}/../../../) set(MNN_INSTALL_ROOT ${MNN_SOURCE_ROOT}/project/android/build_64) set(LIB_PATH ${MNN_INSTALL_ROOT}/lib) set(MNN_EXPRESS_PATH ${LIB_PATH}/libMNN_Express.so) add_library(MNN SHARED IMPORTED) set_target_properties(MNN PROPERTIES IMPORTED_LOCATION ${LIB_PATH}/libMNN.so)从源码结构看MNN_SOURCE_ROOT以apps/frameworks/mnn_tts/向上回溯三层定位到仓库根目录因此 MNN 库的期望位置为仓库内的project/android/build_64/lib/libMNN.so构建文档中写作作者本机的绝对路径实际均以仓库根目录为准。如果该库不存在需要先执行仓库提供的 Android 构建脚本cd project/android ./build_64.sh另外两处值得注意的实现细节可选的libMNN_Express.soCMake 会检查build_64/lib/libMNN_Express.so是否存在若存在则一并声明为MNNExpress导入目标并链接注释为 legacy split runtime不存在时自动降级为只链接libMNN.soAndroid 专属链接选项BUILD_ANDROID开启时会追加-Wl,-z,max-page-size16384链接选项用于适配 16KB 内存页大小的 Android 设备。BUILD_ANDROID标志无需手动指定CMake 在检测到ANDROID平台变量后会自动强制置为 ONoption(BUILD_ANDROID Build for Android OFF) if(ANDROID) set(BUILD_ANDROID ON CACHE BOOL Build for Android FORCE) endif()三、构建步骤3.1 方法一Gradle 命令行推荐在apps/frameworks/mnn_tts/demo/android目录下依次执行cd apps/frameworks/mnn_tts/demo/android # 1. 清理之前的构建可选 ./gradlew clean # 2. 构建 Debug APK ./gradlew assembleDebug # 3. 构建 Release APK ./gradlew assembleRelease # 4. 查看构建输出 ls -lh build/outputs/apk/debug/生成的 APK 文件Debugbuild/outputs/apk/debug/MNNTTSDemo-arm64-v8a-debug.apk约 15 MBReleasebuild/outputs/apk/release/MNNTTSDemo-arm64-v8a-release-unsigned.apk约 8 MBQUICKREF.md 中给出了构建耗时的参考Clean 约 5 秒、首次构建约 23 分钟、增量构建约 3060 秒、安装到设备约 10 秒。一个实操细节当前仓库的 demo build.gradle 在preBuild之前挂接了一个downloadAndUnzipNativeLibs任务当src/main/jniLibs/arm64-v8a/中缺少libsherpa-mnn-jni.so时会从 CDN 自动下载并解压 arm64-v8a 原生库包因此首次构建需要网络可用。3.2 方法二Android Studio打开项目选择 Open an Existing Project导航到apps/frameworks/mnn_tts/demo/android目录并确认Gradle 同步Android Studio 会自动开始同步若未触发点击 File → Sync Project with Gradle Files配置构建变体在左下角 Build Variants 中选择debug或release构建 APK点击 Build → Build Bundle(s) / APK(s) → Build APK(s)或使用快捷键 CtrlShiftAWindows/Linux/ CmdShiftAMac查看构建结果构建成功后点击通知中的 locate 查看 APK 位置。四、构建配置详解4.1 应用配置demo/android/build.gradle应用 build.gradle 的关键配置android { namespace com.alibaba.mnn.tts.demo compileSdk 35 // 编译 SDK 版本 defaultConfig { applicationId com.alibaba.mnn.tts.demo minSdk 21 // 最低支持 Android 5.0 targetSdk 35 // 目标 SDK versionCode 1 // 应用版本号 versionName 1.0 // 应用版本名称 testInstrumentationRunner androidx.test.runner.AndroidJUnitRunner } splits { abi { enable true reset() include arm64-v8a // 仅构建 ARM64 版本 universalApk false // 不生成通用 APK } } }依赖清单与构建文档一致Kotlin 侧依赖 androidx 基础组件 协程dependencies { implementation project(:mnn_tts) // MNN TTS 库 implementation androidx.appcompat:appcompat:1.6.1 implementation com.google.android.material:material:1.10.0 implementation androidx.constraintlayout:constraintlayout:2.1.4 implementation androidx.lifecycle:lifecycle-runtime-ktx:2.7.0 implementation org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3 implementation androidx.core:core-ktx:1.16.0 implementation androidx.recyclerview:recyclerview:1.3.2 implementation androidx.cardview:cardview:1.0.0 }4.2 库模块配置android/build.gradle库模块 build.gradle 是原生代码构建的核心实际配置比构建文档摘录的更完整android { namespace com.alibaba.mnn.tts compileSdk 34 ndkVersion 27.2.12479018 // NDK 版本 sourceSets { main.java.srcDirs [java] } defaultConfig { minSdk 21 targetSdk 35 externalNativeBuild { cmake { cppFlags -stdc17 arguments -DANDROID_STLc_shared, -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZESON } } ndk { abiFilters arm64-v8a } } externalNativeBuild { cmake { path file(../CMakeLists.txt) // 指向 mnn_tts/CMakeLists.txt version 3.22.1 } } buildFeatures { buildConfig true prefab true } prefab { mnn_tts { headers include/mnn_tts } } }几个配置项的含义cppFlags -stdc17与 CMake 中CMAKE_CXX_STANDARD 17保持一致-DANDROID_STLc_shared使用动态 C 标准库即最终 APK 中携带的libc_shared.so-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZESON与 CMake 侧的 16KB 页对齐选项配合支持新的内存页大小abiFilters arm64-v8a原生代码同样只编译 ARM64prefab配置将include/mnn_tts下的头文件如 common.h暴露给消费方模块。4.3 CMake 配置选项CMakeLists.txtmnn_tts/CMakeLists.txt 定义了四个关键选项选项默认值说明BUILD_BERTVITS2ON构建 BertVits2 TTS 引擎中文/英文 G2P、Bert 音素预测、声学模型生成BUILD_PIPEROFF构建 PIPER TTS 引擎依赖 espeak-ng 子模块默认不启用BUILD_SUPERTONICON构建 Supertonic TTS 引擎BUILD_ANDROIDOFF自动检测Android 平台标志检测到ANDROID变量后强制置 ON各选项直接决定编译哪些源文件并追加哪些头文件目录。例如BUILD_BERTVITS2开启时纳入src/bertvits2/下共 11 个源文件text_preprocessor、chinese_g2p、english_bert、tts_generator 等BUILD_ANDROID开启时额外纳入src/android/tts_service.cpp与src/android/tts_service_jni.cpp两个 JNI 服务源文件——这正是 Android 平台上 TTS 引擎服务的原生实现入口。最终产物为动态库libmnn_tts.soadd_library(${PROJECT_NAME} SHARED ...)链接log、MNNAndroid 平台另链接系统 log 库形成如下原生库组合libMNN.soMNN 核心推理引擎来自project/android/build_64预构建产物libmnn_tts.soMNN TTS SDK 实现由本 CMake 工程构建libc_shared.soC 标准库c_sharedSTL 模式。五、安装、运行与验证5.1 安装到设备# 方式一Gradle 命令 ./gradlew installDebug # 方式二adb 命令 adb install build/outputs/apk/debug/MNNTTSDemo-arm64-v8a-debug.apk # 方式三Android Studio 工具栏 Run 按钮选择目标设备后自动安装并启动5.2 启动应用# 启动 Demo 主界面 adb shell am start -n com.alibaba.mnn.tts.demo/.MainActivity # 停止 / 卸载 / 清数据来自 QUICKREF.md 的常用命令 adb shell am force-stop com.alibaba.mnn.tts.demo adb uninstall com.alibaba.mnn.tts.demo adb shell pm clear com.alibaba.mnn.tts.demo从 AndroidManifest.xml 可以看到这个 Demo 除了普通 Launcher 应用之外还有一个值得注意的身份它声明了一个com.mnn.tts.demo.MnnTtsService服务并匹配android.intent.action.TTS_SERVICE意图附带xml/tts_engine元数据——也就是说它同时注册为系统 TTS 引擎用户可以在系统设置 → 语言和输入法 → 文字转语音中选择 MNN TTS Engine配套的设置界面由MnnTtsSettingsActivity匹配TTS_SERVICE_SETTINGS意图提供。应用还申请了RECORD_AUDIO、MODIFY_AUDIO_SETTINGS等权限并通过queries声明了对 TTS 服务意图的可见性。5.3 日志与性能分析# 查看应用日志 adb logcat -s MNN_TTS:* AndroidRuntime:E # 查看原生日志 adb logcat -s DEBUG:* native:*性能侧可使用 Android Studio 的 ProfilerView → Tool Windows → Profiler监控 CPU/内存或使用 Systrace 抓取系统级调度轨迹python systrace.py -t 10 -o trace.html sched freq idle。六、常见问题与解决方案以下五项 FAQ 均继承自构建文档并补充了仓库内可核对的路径1. NDK 未找到NDK not configured在local.properties中配置 NDK 与 SDK 路径以本机实际路径替换echo ndk.dir/path/to/sdk/ndk/27.2.12479018 local.properties echo sdk.dir/path/to/sdk local.properties2. MNN 库未找到libMNN.so not found先构建 MNN 核心库对应 CMakeLists.txt 中MNN_INSTALL_ROOT指向的位置cd project/android ./build_64.sh ls project/android/build_64/lib/libMNN.so # 验证产物存在3. Gradle 同步失败清理缓存并强制刷新依赖./gradlew clean rm -rf .gradle build ./gradlew build --refresh-dependencies4. CMake 构建失败按顺序检查NDK 版本是否为 27.2.12479018、CMake 版本是否 ≥ 3.22.1、project/android/build_64/lib/libMNN.so是否存在。可用./gradlew assembleDebug --info查看详细构建日志。5. ABI 不匹配INSTALL_FAILED_NO_MATCHING_ABIS应用仅支持 ARM64arm64-v8a设备需确保测试设备为 ARM64 架构或修改build.gradle的splits.abi与ndk.abiFilters添加其他 ABI 支持。七、性能优化建议Release 构建优化构建文档建议的 Release 优化开关当前 demo build.gradle 中minifyEnabled默认为false以下为发布时的可选增强buildTypes { release { minifyEnabled true proguardFiles getDefaultProguardFile(proguard-android-optimize.txt) shrinkResources true } }Release 构建同时会自动使用优化后的原生库编译选项。运行时优化模型加载首次加载 TTS 模型耗时较长建议走异步加载路径Demo 中使用 Kotlin 协程封装内存管理及时释放不再使用的模型资源线程池使用合理的线程数量进行推理。八、运行时架构MainActivity.kt ├── ModelAdapter.kt # 模型列表适配器 ├── AudioChunksPlayer.kt # 分块音频播放器实时播放合成音频 └── MNN TTS SDK (libmnn_tts.so) ├── BertVits2 TTS # BertVits2 语音合成src/bertvits2/ ├── Supertonic TTS # Supertonic 语音合成src/supertonic/ └── MNN Engine # MNN 推理引擎libMNN.so对应的源码目录与 include/ 下的公开头文件一一对应BertVits2 引擎的对外实现头为 mnn_bertvits2_tts_impl.hppSupertonic 引擎为 mnn_supertonic_tts_impl.hppSDK 统一入口为 mnn_tts_sdk.hpp。关键功能文本转语音输入文本经 G2P/文本前端处理后由声学模型生成语音模型管理支持多种 TTS 模型切换Demo 中由ModelConfig/ModelAdapter管理音频播放AudioChunksPlayer分块播放生成的语音实现低延迟实时收听性能监控显示推理时间和资源使用系统 TTS 引擎注册通过MnnTtsService接入 Android 系统 TTS 框架见第五节清单分析。九、版本信息与适用前提应用版本1.0versionCode 1最低 Android 版本5.0API 21目标 Android 版本14.0API 35支持的架构ARM64arm64-v8a许可证遵循 MNN 项目许可证条款适用前提说明本文所有构建步骤均以当前仓库状态为准MNN 核心库必须由仓库内的 build_64.sh 先行产出构建文档中出现的作者本机绝对路径如/Users/...在仓库内均应理解为相对仓库根目录的路径。配套的快速开始与常用命令速查可参考同目录的 README.md 和 QUICKREF.md。【免费下载链接】MNNMNN: A blazing-fast, lightweight inference engine battle-tested by Alibaba, powering high-performance on-device LLMs and Edge AI.项目地址: https://gitcode.com/GitHub_Trending/mn/MNN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MNN TTS Android Demo 构建实战：从 NDK 环境配置到 CMake 原生库链接的全流程解析
MNN TTS Android Demo 构建实战从 NDK 环境配置到 CMake 原生库链接的全流程解析【免费下载链接】MNNMNN: A blazing-fast, lightweight inference engine battle-tested by Alibaba, powering high-performance on-device LLMs and Edge AI.项目地址: https://gitcode.com/GitHub_Trending/mn/MNN本文基于 MNN 仓库中 MNN TTS Android Demo 构建文档 展开完整覆盖 Demo 的工具链前置要求、Gradle/CMake 双层构建配置、MNN 核心库依赖链与安装运行验证方法。读完本文你可以独立完成该 TTS 演示应用的编译、安装、启动与常见故障排查并理解构建配置背后与源码的直接对应关系。一、项目概述与模块结构MNN TTS Android Demo 是基于 MNNMobile Neural Network推理引擎的文本转语音Text-to-Speech演示应用位于apps/frameworks/mnn_tts/目录下。它展示了如何在 Android 平台上调用 MNN TTS SDK 完成语音合成当前内置了 BertVits2 与 Supertonic 两套 TTS 引擎实现PIPER 为可选构建。整个mnn_tts模块由三部分构成mnn_tts/ ├── android/ # MNN TTS Android 库模块Gradle library module │ ├── build.gradle # 库模块构建配置 │ ├── java/ # Java/Kotlin 源代码 │ └── src/ │ └── main/java/com/alibaba/mnn/tts/ │ └── MNNTTS.kt # SDK 的 Kotlin 封装入口 ├── demo/android/ # Android Demo 应用 │ ├── build.gradle # 应用构建配置 │ ├── settings.gradle # Gradle 项目设置挂载 :mnn_tts 模块 │ ├── src/main/ │ │ ├── java/ # Kotlin 源代码 │ │ └── res/ # Android 资源文件 │ └── build/ # 构建输出目录 ├── include/ # C 头文件mnn_tts_sdk.hpp 等 ├── src/ # C 源代码实现 └── CMakeLists.txt # CMake 构建配置两个 Gradle 模块之间通过 settings.gradle 完成装配根工程名为MNNTTSDemo其中include :mnn_tts一行将库模块的projectDir指向上级../../android目录因此只需打开demo/android一个目录即可同时构建库与应用rootProject.name MNNTTSDemo include :mnn_tts project(:mnn_tts).projectDir new File(../../android)该文件同时通过pluginManagement统一声明了 AGP 与 Kotlin 插件版本com.android.application/com.android.library均为 8.7.3应用侧 Kotlin 插件为 1.9.22。二、前置要求工具链版本与 MNN 核心库依赖2.1 必需的工具与版本以下版本信息来自构建文档并与仓库中的 Gradle 配置逐一核对一致工具要求版本仓库中的依据Android StudioArctic Fox 或更高构建文档推荐Android SDKCompile SDK 35 / Min SDK 21Android 5.0/ Target SDK 35demo build.gradle 中compileSdk 35、minSdk 21、targetSdk 35Android NDK27.2.12479018推荐库模块 build.gradle 中ndkVersion 27.2.12479018JDK17 或更高Gradle 构建构建文档要求Gradle8.9由 Wrapper 自动管理gradle-wrapper.properties 中distributionUrl指向gradle-8.9-bin.zipCMake3.22.1 或更高库模块 build.gradle 中version 3.22.1此外gradle.properties 中开启了 AndroidX、Jetifier 与nonTransitiveRClass并将 Gradle JVM 堆内存设为 2048m。2.2 依赖预编译的 MNN 核心库该 Demo 的 C 层并非从零编译 MNN而是链接一份预编译的libMNN.so。这一点在 CMakeLists.txt 中有明确体现set(MNN_SOURCE_ROOT ${CMAKE_CURRENT_LIST_DIR}/../../../) set(MNN_INSTALL_ROOT ${MNN_SOURCE_ROOT}/project/android/build_64) set(LIB_PATH ${MNN_INSTALL_ROOT}/lib) set(MNN_EXPRESS_PATH ${LIB_PATH}/libMNN_Express.so) add_library(MNN SHARED IMPORTED) set_target_properties(MNN PROPERTIES IMPORTED_LOCATION ${LIB_PATH}/libMNN.so)从源码结构看MNN_SOURCE_ROOT以apps/frameworks/mnn_tts/向上回溯三层定位到仓库根目录因此 MNN 库的期望位置为仓库内的project/android/build_64/lib/libMNN.so构建文档中写作作者本机的绝对路径实际均以仓库根目录为准。如果该库不存在需要先执行仓库提供的 Android 构建脚本cd project/android ./build_64.sh另外两处值得注意的实现细节可选的libMNN_Express.soCMake 会检查build_64/lib/libMNN_Express.so是否存在若存在则一并声明为MNNExpress导入目标并链接注释为 legacy split runtime不存在时自动降级为只链接libMNN.soAndroid 专属链接选项BUILD_ANDROID开启时会追加-Wl,-z,max-page-size16384链接选项用于适配 16KB 内存页大小的 Android 设备。BUILD_ANDROID标志无需手动指定CMake 在检测到ANDROID平台变量后会自动强制置为 ONoption(BUILD_ANDROID Build for Android OFF) if(ANDROID) set(BUILD_ANDROID ON CACHE BOOL Build for Android FORCE) endif()三、构建步骤3.1 方法一Gradle 命令行推荐在apps/frameworks/mnn_tts/demo/android目录下依次执行cd apps/frameworks/mnn_tts/demo/android # 1. 清理之前的构建可选 ./gradlew clean # 2. 构建 Debug APK ./gradlew assembleDebug # 3. 构建 Release APK ./gradlew assembleRelease # 4. 查看构建输出 ls -lh build/outputs/apk/debug/生成的 APK 文件Debugbuild/outputs/apk/debug/MNNTTSDemo-arm64-v8a-debug.apk约 15 MBReleasebuild/outputs/apk/release/MNNTTSDemo-arm64-v8a-release-unsigned.apk约 8 MBQUICKREF.md 中给出了构建耗时的参考Clean 约 5 秒、首次构建约 23 分钟、增量构建约 3060 秒、安装到设备约 10 秒。一个实操细节当前仓库的 demo build.gradle 在preBuild之前挂接了一个downloadAndUnzipNativeLibs任务当src/main/jniLibs/arm64-v8a/中缺少libsherpa-mnn-jni.so时会从 CDN 自动下载并解压 arm64-v8a 原生库包因此首次构建需要网络可用。3.2 方法二Android Studio打开项目选择 Open an Existing Project导航到apps/frameworks/mnn_tts/demo/android目录并确认Gradle 同步Android Studio 会自动开始同步若未触发点击 File → Sync Project with Gradle Files配置构建变体在左下角 Build Variants 中选择debug或release构建 APK点击 Build → Build Bundle(s) / APK(s) → Build APK(s)或使用快捷键 CtrlShiftAWindows/Linux/ CmdShiftAMac查看构建结果构建成功后点击通知中的 locate 查看 APK 位置。四、构建配置详解4.1 应用配置demo/android/build.gradle应用 build.gradle 的关键配置android { namespace com.alibaba.mnn.tts.demo compileSdk 35 // 编译 SDK 版本 defaultConfig { applicationId com.alibaba.mnn.tts.demo minSdk 21 // 最低支持 Android 5.0 targetSdk 35 // 目标 SDK versionCode 1 // 应用版本号 versionName 1.0 // 应用版本名称 testInstrumentationRunner androidx.test.runner.AndroidJUnitRunner } splits { abi { enable true reset() include arm64-v8a // 仅构建 ARM64 版本 universalApk false // 不生成通用 APK } } }依赖清单与构建文档一致Kotlin 侧依赖 androidx 基础组件 协程dependencies { implementation project(:mnn_tts) // MNN TTS 库 implementation androidx.appcompat:appcompat:1.6.1 implementation com.google.android.material:material:1.10.0 implementation androidx.constraintlayout:constraintlayout:2.1.4 implementation androidx.lifecycle:lifecycle-runtime-ktx:2.7.0 implementation org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3 implementation androidx.core:core-ktx:1.16.0 implementation androidx.recyclerview:recyclerview:1.3.2 implementation androidx.cardview:cardview:1.0.0 }4.2 库模块配置android/build.gradle库模块 build.gradle 是原生代码构建的核心实际配置比构建文档摘录的更完整android { namespace com.alibaba.mnn.tts compileSdk 34 ndkVersion 27.2.12479018 // NDK 版本 sourceSets { main.java.srcDirs [java] } defaultConfig { minSdk 21 targetSdk 35 externalNativeBuild { cmake { cppFlags -stdc17 arguments -DANDROID_STLc_shared, -DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZESON } } ndk { abiFilters arm64-v8a } } externalNativeBuild { cmake { path file(../CMakeLists.txt) // 指向 mnn_tts/CMakeLists.txt version 3.22.1 } } buildFeatures { buildConfig true prefab true } prefab { mnn_tts { headers include/mnn_tts } } }几个配置项的含义cppFlags -stdc17与 CMake 中CMAKE_CXX_STANDARD 17保持一致-DANDROID_STLc_shared使用动态 C 标准库即最终 APK 中携带的libc_shared.so-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZESON与 CMake 侧的 16KB 页对齐选项配合支持新的内存页大小abiFilters arm64-v8a原生代码同样只编译 ARM64prefab配置将include/mnn_tts下的头文件如 common.h暴露给消费方模块。4.3 CMake 配置选项CMakeLists.txtmnn_tts/CMakeLists.txt 定义了四个关键选项选项默认值说明BUILD_BERTVITS2ON构建 BertVits2 TTS 引擎中文/英文 G2P、Bert 音素预测、声学模型生成BUILD_PIPEROFF构建 PIPER TTS 引擎依赖 espeak-ng 子模块默认不启用BUILD_SUPERTONICON构建 Supertonic TTS 引擎BUILD_ANDROIDOFF自动检测Android 平台标志检测到ANDROID变量后强制置 ON各选项直接决定编译哪些源文件并追加哪些头文件目录。例如BUILD_BERTVITS2开启时纳入src/bertvits2/下共 11 个源文件text_preprocessor、chinese_g2p、english_bert、tts_generator 等BUILD_ANDROID开启时额外纳入src/android/tts_service.cpp与src/android/tts_service_jni.cpp两个 JNI 服务源文件——这正是 Android 平台上 TTS 引擎服务的原生实现入口。最终产物为动态库libmnn_tts.soadd_library(${PROJECT_NAME} SHARED ...)链接log、MNNAndroid 平台另链接系统 log 库形成如下原生库组合libMNN.soMNN 核心推理引擎来自project/android/build_64预构建产物libmnn_tts.soMNN TTS SDK 实现由本 CMake 工程构建libc_shared.soC 标准库c_sharedSTL 模式。五、安装、运行与验证5.1 安装到设备# 方式一Gradle 命令 ./gradlew installDebug # 方式二adb 命令 adb install build/outputs/apk/debug/MNNTTSDemo-arm64-v8a-debug.apk # 方式三Android Studio 工具栏 Run 按钮选择目标设备后自动安装并启动5.2 启动应用# 启动 Demo 主界面 adb shell am start -n com.alibaba.mnn.tts.demo/.MainActivity # 停止 / 卸载 / 清数据来自 QUICKREF.md 的常用命令 adb shell am force-stop com.alibaba.mnn.tts.demo adb uninstall com.alibaba.mnn.tts.demo adb shell pm clear com.alibaba.mnn.tts.demo从 AndroidManifest.xml 可以看到这个 Demo 除了普通 Launcher 应用之外还有一个值得注意的身份它声明了一个com.mnn.tts.demo.MnnTtsService服务并匹配android.intent.action.TTS_SERVICE意图附带xml/tts_engine元数据——也就是说它同时注册为系统 TTS 引擎用户可以在系统设置 → 语言和输入法 → 文字转语音中选择 MNN TTS Engine配套的设置界面由MnnTtsSettingsActivity匹配TTS_SERVICE_SETTINGS意图提供。应用还申请了RECORD_AUDIO、MODIFY_AUDIO_SETTINGS等权限并通过queries声明了对 TTS 服务意图的可见性。5.3 日志与性能分析# 查看应用日志 adb logcat -s MNN_TTS:* AndroidRuntime:E # 查看原生日志 adb logcat -s DEBUG:* native:*性能侧可使用 Android Studio 的 ProfilerView → Tool Windows → Profiler监控 CPU/内存或使用 Systrace 抓取系统级调度轨迹python systrace.py -t 10 -o trace.html sched freq idle。六、常见问题与解决方案以下五项 FAQ 均继承自构建文档并补充了仓库内可核对的路径1. NDK 未找到NDK not configured在local.properties中配置 NDK 与 SDK 路径以本机实际路径替换echo ndk.dir/path/to/sdk/ndk/27.2.12479018 local.properties echo sdk.dir/path/to/sdk local.properties2. MNN 库未找到libMNN.so not found先构建 MNN 核心库对应 CMakeLists.txt 中MNN_INSTALL_ROOT指向的位置cd project/android ./build_64.sh ls project/android/build_64/lib/libMNN.so # 验证产物存在3. Gradle 同步失败清理缓存并强制刷新依赖./gradlew clean rm -rf .gradle build ./gradlew build --refresh-dependencies4. CMake 构建失败按顺序检查NDK 版本是否为 27.2.12479018、CMake 版本是否 ≥ 3.22.1、project/android/build_64/lib/libMNN.so是否存在。可用./gradlew assembleDebug --info查看详细构建日志。5. ABI 不匹配INSTALL_FAILED_NO_MATCHING_ABIS应用仅支持 ARM64arm64-v8a设备需确保测试设备为 ARM64 架构或修改build.gradle的splits.abi与ndk.abiFilters添加其他 ABI 支持。七、性能优化建议Release 构建优化构建文档建议的 Release 优化开关当前 demo build.gradle 中minifyEnabled默认为false以下为发布时的可选增强buildTypes { release { minifyEnabled true proguardFiles getDefaultProguardFile(proguard-android-optimize.txt) shrinkResources true } }Release 构建同时会自动使用优化后的原生库编译选项。运行时优化模型加载首次加载 TTS 模型耗时较长建议走异步加载路径Demo 中使用 Kotlin 协程封装内存管理及时释放不再使用的模型资源线程池使用合理的线程数量进行推理。八、运行时架构MainActivity.kt ├── ModelAdapter.kt # 模型列表适配器 ├── AudioChunksPlayer.kt # 分块音频播放器实时播放合成音频 └── MNN TTS SDK (libmnn_tts.so) ├── BertVits2 TTS # BertVits2 语音合成src/bertvits2/ ├── Supertonic TTS # Supertonic 语音合成src/supertonic/ └── MNN Engine # MNN 推理引擎libMNN.so对应的源码目录与 include/ 下的公开头文件一一对应BertVits2 引擎的对外实现头为 mnn_bertvits2_tts_impl.hppSupertonic 引擎为 mnn_supertonic_tts_impl.hppSDK 统一入口为 mnn_tts_sdk.hpp。关键功能文本转语音输入文本经 G2P/文本前端处理后由声学模型生成语音模型管理支持多种 TTS 模型切换Demo 中由ModelConfig/ModelAdapter管理音频播放AudioChunksPlayer分块播放生成的语音实现低延迟实时收听性能监控显示推理时间和资源使用系统 TTS 引擎注册通过MnnTtsService接入 Android 系统 TTS 框架见第五节清单分析。九、版本信息与适用前提应用版本1.0versionCode 1最低 Android 版本5.0API 21目标 Android 版本14.0API 35支持的架构ARM64arm64-v8a许可证遵循 MNN 项目许可证条款适用前提说明本文所有构建步骤均以当前仓库状态为准MNN 核心库必须由仓库内的 build_64.sh 先行产出构建文档中出现的作者本机绝对路径如/Users/...在仓库内均应理解为相对仓库根目录的路径。配套的快速开始与常用命令速查可参考同目录的 README.md 和 QUICKREF.md。【免费下载链接】MNNMNN: A blazing-fast, lightweight inference engine battle-tested by Alibaba, powering high-performance on-device LLMs and Edge AI.项目地址: https://gitcode.com/GitHub_Trending/mn/MNN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考