You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

为什么Flutter接入广告时会触发':app:checkDebugAarMetadata'构建失败错误?

错误原因

该报错的核心原因是依赖库的最低编译SDK版本要求与项目当前配置的编译SDK版本不匹配:

  • 你当前Flutter项目的安卓模块配置的compileSdkVersion为30
  • 你接入的广告SDK间接依赖了androidx.work:work-runtime:2.7.0库,该库的AAR元数据明确要求最低编译SDK版本必须为31,版本不匹配触发了checkDebugAarMetadata任务执行失败。
解决方法

你可以根据项目情况选择以下任意一种方案解决:

  • 方案一(优先推荐):升级项目编译SDK版本
    打开Flutter项目安卓目录下的android/app/build.gradle文件,找到compileSdkVersion配置项,将数值从30修改为31或更高的稳定版本即可,修改示例:
android {
    compileSdkVersion 31 // 原有其他配置保持不变即可
    defaultConfig {
        // 原有配置无需修改
    }
}

修改完成后重新构建项目即可。

  • 方案二:强制指定work-runtime依赖版本
    如果暂时不想升级compileSdkVersion,可以在安卓项目根目录的android/build.gradle文件中添加强制依赖配置,指定使用兼容compileSdk30的work-runtime版本:
allprojects {
    repositories {
        // 原有仓库配置无需修改
    }
    configurations.all {
        resolutionStrategy { force 'androidx.work:work-runtime:2.6.0' }
    }
}

注意:该方案存在兼容性风险,若低版本work-runtime和广告SDK不兼容导致功能异常,请切换至方案一。

  • 方案三:降级广告SDK版本
    若你接入的广告SDK有多个版本可选,可以尝试更换为不需要依赖androidx.work:work-runtime:2.7.0的更低版本广告SDK,即可规避该版本冲突问题。

内容的提问来源于stack exchange,提问作者nepapp

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.25 07:06:05