Android Studio添加GitHub PDF依赖遇Gradle构建错误求助

核心问题原因 #

你使用的com.github.barteksc:android-pdf-viewer:2.8.2托管在Jitpack仓库，而你的项目配置中未在正确位置添加该仓库地址，导致Gradle无法找到对应的依赖资源。

修复步骤 #

1. 修改settings.gradle.kts添加Jitpack仓库
   在dependencyResolutionManagement的repositories块中加入Jitpack仓库地址，这是新版Gradle（Android Studio Arctic Fox及以上）管理仓库的标准位置，替代了旧版的allprojects块。修改后的文件如下：

   pluginManagement {
       repositories {
           google()
           mavenCentral()
           gradlePluginPortal()
       }
   }
   
   dependencyResolutionManagement {
       repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
       repositories {
           google()
           mavenCentral()
           // 添加Jitpack仓库
           maven("https://jitpack.io")
       }
   }
   
   rootProject.name = "Pdfviewtest"
   include(":app")
   

2. 同步Gradle并清理缓存

   • 点击Android Studio顶部工具栏的Sync Project with Gradle Files按钮完成同步
   • 如果同步仍失败，执行File > Invalidate Caches... > Invalidate and Restart清理IDE缓存，避免旧配置干扰

3. 验证依赖可用性
   同步完成后，检查build.gradle.kts (Module :app)中的依赖是否正常识别：

   implementation("com.github.barteksc:android-pdf-viewer:2.8.2")
   

额外检查点 #

• 你的项目minSdk=26满足android-pdf-viewer:2.8.2的最低要求（该库最低支持SDK 14），无需调整版本
• 确保网络环境可正常访问Jitpack仓库，若存在网络限制，可配置镜像或使用代理

内容的提问来源于stack exchange，提问作者Roberto Pacheco