如何在Gradle8.7+AGP8.5环境下集成mvnrepository第三方库

云上老周

2026-6-16

问题解答

1. 正确集成Maven Repository第三方库的步骤

你的项目级build.gradle里的dependencyResolutionManagement配置方向正确，按以下步骤调整即可：

移除冗余仓库配置：mavenCentral()是官方提供的快捷配置，本质就是指向https://repo.maven.apache.org/maven2/，所以可以删掉手动添加的maven { url 'https://repo.maven.apache.org/maven2' }，避免重复配置。
准确声明依赖坐标：从Maven Repository获取目标库的完整坐标（Group ID、Artifact ID、Version），直接在模块级build.gradle（或build.gradle.kts）的dependencies块中声明，示例：
```
dependencies {
    implementation 'com.example:target-library:1.2.3'
}
```
排查解析失败问题：若仍无法解析，执行以下操作：
- 执行Android Studio的File > Invalidate Caches...，选择Invalidate and Restart清理缓存
- 确认目标库确实存在于Maven Central（部分旧库仅存于已停止服务的JCenter，需找替代库或手动引入本地jar/aar）
- 检查网络连接，确保能正常访问Maven Central仓库

JCenter已停止服务，无需保留任何相关配置，注意以下两点：

全局清理jcenter()：检查所有项目级、模块级build.gradle文件，删除任何jcenter()声明
替换JCenter独有的依赖：若项目中存在仅在JCenter托管的依赖，必须替换为Maven Central或其他活跃仓库的替代库；若无替代方案，可将库的jar/aar文件放入项目libs目录，通过implementation files('libs/xxx.jar')引入本地依赖

JVM版本兼容性：AGP 8.5要求JVM版本至少为17，你当前使用的17.0.9符合要求；若切换到JVM 21，Gradle 8.7已提供支持，同时确保Android Studio 24.1.1兼容JVM 21（新版本AS通常支持）
版本匹配要求：Kotlin 1.9.0与AGP 8.5兼容，但后续升级Kotlin时需遵循官方版本匹配规则，避免编译错误
仓库配置限制：Gradle 8.x默认启用RepositoriesMode.FAIL_ON_PROJECT_REPOS，禁止在模块级配置仓库，所有仓库必须统一在项目级dependencyResolutionManagement中配置，你的现有配置符合要求
编译选项对齐：在模块级build.gradle中，确保Kotlin的JVM目标版本与项目JVM版本一致，示例：
```
kotlinOptions {
    jvmTarget = "17" // 若使用JVM 21则改为"21"
}
```
AGP 8.5默认特性：AGP 8.5默认启用R8全模式缩减，若遇到混淆问题，可检查proguard-rules.pro规则，或暂时通过android.buildTypes.release.minifyEnabled = false关闭缩减排查问题

内容的提问来源于stack exchange，提问作者Ahsan Murtaza