Flutter项目中Gradle无法找到libs目录下的AAR文件求助

1. 确认libs目录与AAR文件状态 #

• 检查libs目录是否在android/app/ 层级下，别放错到项目根目录或其他位置
• 验证AAR文件完整性：把AAR后缀改成zip解压，确认内部有正常的文件结构，没有损坏

2. 检查App层级build.gradle配置 #

确保android/app/build.gradle（不是项目根目录的build.gradle）里正确配置了本地库依赖：

android {
    // 其他原有配置...
    repositories {
        flatDir {
            dirs 'libs' // 声明本地libs为仓库源
        }
    }
}

dependencies {
    // 替换成你的AAR文件名（不用带.aar后缀）
    implementation(name: 'your-aar-file-name', ext: 'aar')
    // 其他依赖...
}

• 如果AAR有依赖传递，要把这些依赖也加到dependencies里

3. 核对Flutter与Gradle插件版本兼容性 #

Flutter版本和Gradle插件版本不匹配也会出问题：

• 打开android/build.gradle，确认com.android.tools.build:gradle版本和当前Flutter版本适配（可对照Flutter官方的版本对应表）
• 执行flutter clean清缓存，再重新跑flutter run

4. 检查AndroidManifest.xml配置 #

如果AAR需要特定权限或组件，确保Manifest里正确添加：

<!-- 通话相关权限示例 -->
<uses-permission android:name="android.permission.CALL_PHONE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

<application
    android:label="your_app_name"
    android:name="${applicationName}"
    android:icon="@mipmap/ic_launcher">
    <!-- AAR自带的Service/Receiver等组件需声明 -->
    <service android:name="com.thirdparty.CallService" />
    <!-- 其他原有配置... -->
</application>

• 注意别犯XML语法错误，比如标签没闭合、权限拼写错

5. 从控制台错误信息定位问题 #

盯着控制台输出找关键错误：

• Could not find :xxx:：确认AAR文件名和build.gradle里写的完全一致（区分大小写）
• Failed to resolve dependency：检查有没有缺失的传递依赖
• Manifest merger failed：排查Manifest里的组件、权限冲突

6. 尝试本地Maven仓库引入（备选方案） #

如果上面的方法都不行，试试把AAR装到本地Maven仓库再引入：

1. 在android/app/build.gradle里加本地Maven仓库：

repositories {
    mavenLocal()
    // 其他仓库...
}

2. 执行命令把AAR安装到本地Maven：

mvn install:install-file -Dfile=你的AAR文件路径 -DgroupId=com.thirdparty -DartifactId=call-sdk -Dversion=1.0.0 -Dpackaging=aar

3. 在dependencies里加Maven依赖：

implementation 'com.thirdparty:call-sdk:1.0.0'

内容的提问来源于stack exchange，提问作者Zero0000-tech