Gradle依赖解析失败：无法找到libausbc:3.3.3依赖求助

问题背景 #

我用Java开发一款Android应用，需要展示通过USB连接到手机的摄像头视频流，在引入依赖时遇到了问题：

依赖声明：

implementation 'com.github.jiangdongguo.AndroidUSBCamera:libausbc:3.3.3'

构建时错误日志：

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:checkDebugAarMetadata'.
> Could not resolve all files for configuration ':app:debugRuntimeClasspath'.
   > Could not find com.github.jiangdongguo.AndroidUSBCamera:libausbc:3.3.3.
     Searched in the following locations:
       - https://dl.google.com/dl/android/maven2/com/github/jiangdongguo/AndroidUSBCamera/libausbc/3.3.3/libausbc-3.3.3.pom
       - https://repo.maven.apache.org/maven2/com/github/jiangdongguo/AndroidUSBCamera/libausbc/3.3.3/libausbc-3.3.3.pom
     Required by:
         project :app

我的疑问 #

1. 是否有人遇到过该库或其他JitPack托管依赖的类似问题？
2. 为何仓库和版本看似正确，仍无法解析该依赖？
3. 还有哪些可行解决方案？

已尝试的操作 #

1. 配置JitPack仓库：

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

2. 确认JitPack上存在3.3.3版本，也尝试过其他版本，问题依旧。
3. 尝试用新的库目录声明：implementation libs.libausbc

问题解答 #

1. 是否有类似问题？ #

很多开发者都遇到过JitPack托管依赖的解析问题，这款库的部分版本确实存在构建失败记录，社区中也有不少相关讨论。

2. 依赖解析失败的原因 #

• 仓库配置位置错误：Android Gradle Plugin 7.0+版本已弃用allprojects下的仓库配置，需在settings.gradle的dependencyResolutionManagement块中配置JitPack，否则Gradle不会从JitPack搜索依赖。
• JitPack构建异常：JitPack是动态构建仓库，即使版本标签存在，也可能因为构建环境问题、代码编译错误导致未生成可下载的pom/aar文件。
• 依赖缓存问题：本地Gradle缓存可能留存了失效的依赖信息，导致无法拉取最新的构件。

3. 可行解决方案 #

• 修正仓库配置位置：
  在settings.gradle中添加JitPack仓库，移除根build.gradle中allprojects下的仓库配置：

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

• 清理依赖缓存并重新同步：
  执行以下Gradle命令：

  ./gradlew clean build --refresh-dependencies
  

  或在Android Studio中通过File > Invalidate Caches... > Invalidate and Restart清理缓存后重启。
• 验证JitPack构建状态：
  查看该库对应版本的构建日志，确认是否构建成功。若构建失败，尝试切换到更早的稳定版本，或向库作者提交Issue反馈问题。
• 手动引入构件：
  从JitPack下载对应版本的aar文件，放入项目libs目录，然后在app/build.gradle中声明：

  implementation files('libs/libausbc-3.3.3.aar')
  

• 替换为其他USB摄像头库：
  若该库问题无法解决，可尝试其他成熟的USB摄像头库，或基于Android原生USB Host API自行实现视频流解析逻辑。

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