导入Android Link Preview库时遭遇Gradle依赖解析失败问题

问题原因 #

原配置中使用的私有maven仓库已无对应版本的依赖文件，导致Gradle无法拉取到com.leocardz:link-preview:2.0.0包。

解决方案 #

步骤1：更新仓库配置 #

在settings.gradle的pluginManagement和dependencyResolutionManagement模块中，移除失效的私有maven仓库，添加JitPack仓库（该仓库托管了项目的构建产物）：

pluginManagement {
repositories {
    gradlePluginPortal()
    google()
    mavenCentral()
    maven { url 'https://jitpack.io' }
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
    google()
    mavenCentral()
    maven { url 'https://jitpack.io' }
}
}

注：JCenter已停止维护，建议同步移除jcenter()配置，避免构建警告。

步骤2：修改依赖引用 #

将原依赖替换为JitPack的标准引用格式，移除@aar后缀：

implementation 'androidx.core:core-ktx:1.7.0'
implementation 'androidx.appcompat:appcompat:1.5.1'
implementation 'com.google.android.material:material:1.6.1'
implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
implementation 'androidx.navigation:navigation-fragment-ktx:2.5.1'
implementation 'androidx.navigation:navigation-ui-ktx:2.5.1'
testImplementation 'junit:junit:4.13.2'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
implementation 'org.jsoup:jsoup:1.13.1' // required
// 替换为JitPack格式的依赖
implementation 'com.github.LeonardoCardoso:Android-Link-Preview:v2.0.0'

步骤3：重新构建项目 #

执行File -> Sync Project with Gradle Files，等待同步完成后重新运行项目。

备选方案（JitPack不可用时） #

如果JitPack拉取失败，可手动导入aar包：

• 下载项目对应版本的aar文件
• 将文件复制到app/libs目录
• 在app/build.gradle中添加本地依赖：

implementation files('libs/link-preview-2.0.0.aar')

内容的提问来源于stack exchange，提问作者android dev