Android Studio中无法解析com.serenegiant:common:0.0.3依赖求助

报错信息 #

Caused by:
org.gradle.api.internal.artifacts.ivyservice.DefaultLenientConfiguration$ArtifactResolveException: Could not resolve all files for configuration ':app:debugCompileClasspath'.

Caused by:
org.gradle.internal.resolve.ModuleVersionNotFoundException: Could not find com.serenegiant:common:0.0.3.

当前settings.gradle.kts配置 #

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

}

rootProject.name = "Project"
include(":app")

问题原因及解决办法 #

1. 目标版本不存在或格式错误 #

JitPack上的依赖版本对应GitHub仓库的标签/发布版本，先确认com.serenegiant:common是否有0.0.3版本：

• 检查对应GitHub仓库的标签列表，部分仓库版本标签带v前缀（比如v0.0.3），此时依赖需写为com.serenegiant:common:v0.0.3；
• 若该版本未发布，替换为仓库已存在的版本号。

2. 仓库优先级或网络问题 #

• 调整仓库顺序，让JitPack优先被检索：

  repositories {
      maven(url = "https://jitpack.io")
      google()
      mavenCentral()
  }
  

• 检查网络是否能正常访问JitPack，国内环境可尝试切换网络或使用代理。

3. 依赖声明拼写错误 #

确认app模块build.gradle.kts中的依赖声明是否完全正确，比如：

implementation("com.serenegiant:common:0.0.3")

核对groupId、artifactId、版本号的拼写，无多余空格或符号。

4. 移除废弃仓库干扰 #

Jcenter已停止维护，直接从仓库列表中删除jcenter()，避免依赖解析流程被干扰。

5. 清理Gradle缓存 #

• 执行Android Studio菜单File -> Invalidate Caches... -> Invalidate and Restart；
• 手动删除项目根目录下的.gradle文件夹和app模块的build文件夹，重新同步项目。

内容的提问来源于stack exchange，提问作者문혁진