Android Studio新版本中android-pdf-viewer库运行异常问题咨询

问题说明 #

android-pdf-viewer库在Android Studio 2.3.3中可正常运行，但升级至新版本Android Studio后，仅Java文件出现报错，XML文件无任何异常。已尝试切换该库的不同版本，并在settings.gradle文件中添加了GradlePluginPortal()配置。

可行解决方向 #

• 匹配Android Gradle Plugin（AGP）版本：新版本Android Studio默认搭载更高版本的AGP，旧版库可能存在兼容性问题。检查项目根目录的build.gradle（或build.gradle.kts），将AGP版本调整为库官方文档推荐的稳定版本，或升级库到适配高版本AGP的最新版。
• 指定Java兼容版本：新版本AS通常默认使用Java 11及以上版本，而部分旧版库依赖Java 8语法。在模块的build.gradle中添加如下配置：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_1_8
          targetCompatibility JavaVersion.VERSION_1_8
      }
      // 若项目使用Kotlin，补充以下配置
      kotlinOptions {
          jvmTarget = "1.8"
      }
  }
  

• 排查依赖冲突：新版本AS的依赖解析逻辑有调整，可能导致库与其他依赖冲突。执行命令./gradlew app:dependencies查看依赖树，找到冲突依赖后通过exclude排除：

  implementation('com.github.barteksc:android-pdf-viewer:3.2.0-beta.1') {
      exclude group: 'com.android.support' // 示例：排除冲突的support库
  }
  

• 清理项目缓存：新版本AS可能存在缓存异常，执行File -> Invalidate Caches...并重启AS，同时删除项目根目录的.gradle文件夹和模块下的build文件夹，之后重新构建项目。

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