集成FMOD音频库的Qt应用在Android启动时崩溃求助

问题背景 #

桌面端编译为EXE可正常运行，但打包成APK后，在Redmi 4X（Android 7，API 24）上启动即崩溃；移除FMOD依赖后应用可正常运行。使用环境：FMOD 2.02.16、JDK 17、NDK 22、Qt 6.2.4，仅构建armeabi-v7a架构的Release包。

崩溃核心原因（来自原崩溃报告） #

崩溃堆栈显示，问题出在FMOD::System::init调用阶段，底层触发了android_get_device_api_level函数未找到的错误——该函数是Android 8.0（API 26）才新增的，而Redmi 4X的系统版本不支持，最终导致启动崩溃。

具体解决方案 #

1. 替换FMOD的低版本兼容库 #

FMOD 2.02.16针对低版本Android提供了兼容库，不要使用默认的fmod.so，改用对应架构的fmodL.so（调试版）或专门的兼容发行版库，确保库文件支持API 24及以下系统。

2. 调整Qt项目配置 #

在.pro文件中明确指定Android最低兼容版本，并链接必要系统库：

# 指定最低和目标SDK版本为24（Android 7）
ANDROID_MIN_SDK_VERSION = 24
ANDROID_TARGET_SDK_VERSION = 24
# 链接Android系统日志和平台库
LIBS += -llog -landroid
# 强制编译时适配API 24
QMAKE_CXXFLAGS += -DANDROID_API_LEVEL=24

3. 兼容FMOD初始化逻辑 #

在调用FMOD::System::init前，针对Android 7做参数调整，避免触发高版本API特性：

FMOD::System* fmodSystem;
FMOD_RESULT result = FMOD::System_Create(&fmodSystem);
if (result != FMOD_OK) {
    // 处理创建失败
    return;
}

int driverCount = 0;
fmodSystem->getNumDrivers(&driverCount);
// 无音频驱动时禁用声音输出
if (driverCount == 0) {
    fmodSystem->setOutput(FMOD_OUTPUTTYPE_NOSOUND);
}

// 针对Android 7及以下调整初始化标志
FMOD_INITFLAGS initFlags = FMOD_INIT_NORMAL;
#if __ANDROID_API__ <= 24
initFlags |= FMOD_INIT_3D_RIGHTHANDED;
#endif
// 减少初始音频通道数，降低系统负载
result = fmodSystem->init(16, initFlags, nullptr);
if (result != FMOD_OK) {
    // 处理初始化失败
    fmodSystem->release();
    return;
}

4. 严格匹配架构 #

确认使用的FMOD库是armeabi-v7a架构，和Qt的构建架构完全一致；在Qt的Android构建配置中，仅勾选armeabi-v7a，避免多架构兼容导致的库文件不匹配。

5. 降级NDK版本（可选） #

NDK 22对Android 7的兼容性有限，尝试降级到NDK 21或NDK 19，这两个版本对低版本Android的支持更完善，且能和Qt 6.2.4正常配合构建。

内容的提问来源于stack exchange，提问作者8Observer8