Android项目依赖库无法找到的解决方案

 更新时间:2025年03月14日 11:39:18   作者:帅次  
最近,我在编译一个 Android 老项目时遇到了一个问题,错误信息显示无法找到 com.gyf.immersionbar:immersionbar:3.0.0 这个依赖,经过一些排查和调试,我找到了几种解决方法,今天就来分享一下如何解决这个问题,需要的朋友可以参考下

错误信息解析

FAILURE: Build completed with 14 failures.
 
1: Task failed with an exception.
-----------
* What went wrong:
Execution failed for task ':app:checkCommonDebugAarMetadata'.
> Could not resolve all files for configuration ':app:commonDebugRuntimeClasspath'.
   > Could not find com.gyf.immersionbar:immersionbar:3.0.0.
     Searched in the following locations:
       - https://dl.google.com/dl/android/maven2/com/gyf/immersionbar/immersionbar/3.0.0/immersionbar-3.0.0.pom
       - https://jcenter.bintray.com/com/gyf/immersionbar/immersionbar/3.0.0/immersionbar-3.0.0.pom
       - https://repo.maven.apache.org/maven2/com/gyf/immersionbar/immersionbar/3.0.0/immersionbar-3.0.0.pom
       - https://jitpack.io/com/gyf/immersionbar/immersionbar/3.0.0/immersionbar-3.0.0.pom
     Required by:
         project :app
   > Could not find com.tencent:mmkv:1.0.19.
     Searched in the following locations:
       - https://dl.google.com/dl/android/maven2/com/tencent/mmkv/1.0.19/mmkv-1.0.19.pom
       - https://jcenter.bintray.com/com/tencent/mmkv/1.0.19/mmkv-1.0.19.pom
       - https://repo.maven.apache.org/maven2/com/tencent/mmkv/1.0.19/mmkv-1.0.19.pom
       - https://jitpack.io/com/tencent/mmkv/1.0.19/mmkv-1.0.19.pom
     Required by:
         project :app > com.gitee.zhang-yanqiang:easypermission:v2.0.12
 
* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
==============================================================================

从错误信息中可以看出,Gradle 无法在常见的 Maven 仓库中找到指定版本的 immersionbar 依赖库。具体的错误是它无法解析 com.gyf.immersionbar:immersionbar:3.0.0,说明该依赖在指定的仓库中不存在,或者配置出现了问题。

解决方案

1. 检查依赖版本

首先,我们需要确保 immersionbar 库的版本号是正确的。在很多时候,问题可能是因为指定的版本号不存在,或者该版本的库被移除了。检查一下 build.gradle 文件中的依赖部分,确保版本号正确。

例如,可以尝试使用稍新的版本,或者回退到较为稳定的版本:

dependencies { 
    implementation 'com.gyf.immersionbar:immersionbar:3.0.1' 
}

如果 3.0.0 版本存在问题,尝试更新为 3.0.1 或其他稳定版本,其他SDK可能能解决这个问题(该库换了引用地址,单纯的改版本无效)。

2. 检查 Maven 仓库配置

另一个可能导致问题的原因是仓库配置不正确。确保你的项目的 build.gradle 文件(通常是项目级 build.gradle)中配置了正确的仓库地址。默认情况下,Android Studio 会使用 Google 的 Maven 仓库和 Maven Central,但如果没有正确配置,可能导致无法下载依赖。

确保 repositories 块包括以下内容:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }  // Jitpack 是常见的 Android 库托管平台
    }
}

高级AGP在项目级 settings.gradle。

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

添加 maven { url 'https://jitpack.io' } 可以解决一些第三方库的下载问题,特别是当它们托管在 Jitpack 上时。

3. 强制刷新 Gradle 缓存

有时候 Gradle 会缓存旧的依赖信息,导致无法找到最新版本的库。为了避免缓存问题,可以通过以下命令强制 Gradle 刷新缓存并重新构建项目。

Android Studio -->Build-->Clean Project。

Android Studio -->Build-->Rebuild Project。

清除缓存,重新编译,分别尝试一下。

此外,你也可以在 Android Studio 中选择 File -> Invalidate Caches / Restart,然后选择 Invalidate and Restart,这样会清除缓存并重新启动 IDE。

4. 检查网络连接

如果你所在的网络环境对 Maven 仓库的访问有所限制,可能会导致依赖下载失败。例如,如果你在国内,访问外部 Maven 仓库(如 Maven Central 或 Jitpack)可能会受到一些限制。

在这种情况下,可以尝试使用国内的 Maven 镜像,或者配置 HTTP 代理来确保可以顺利访问依赖库。

5. 手动下载依赖

如果以上方法都不起作用,作为最后的手段,你可以手动下载 immersionbar 的 JAR 文件,然后将其放入项目的 libs 目录中。

首先,从其他源下载 immersionbar 的 JAR 文件,然后将 JAR 文件放入 libs 目录下,最后在 build.gradle 文件中引用:

dependencies { 
    implementation files('libs/immersionbar-3.0.0.jar') 
}

总结

作者是因为 immersionbar 换了路径,因此更换i mmersionbar 路径,重新引用 mmkv 解决当前问题:

dependencies { 
    implementation 'com.geyifeng.immersionbar:immersionbar:3.2.2'
    implementation 'com.tencent:mmkv:1.3.9'  
}

当你在 Android Studio 中遇到类似的构建问题时,通常是由于依赖版本、仓库配置或者网络连接问题导致的。通过逐步排查版本号、仓库配置、Gradle 缓存等问题,大多数依赖问题都可以得到解决。如果以上步骤仍无法解决问题,可以尝试手动下载依赖并添加到项目中。

以上就是Android项目依赖库无法找到的解决方案的详细内容,更多关于Android依赖库无法找到的资料请关注脚本之家其它相关文章!

相关文章

  • Android广播事件流程与广播ANR原理深入刨析

    Android广播事件流程与广播ANR原理深入刨析

    这篇文章主要介绍了Android广播事件流程与广播ANR原理,ANR应用程序未响应,当主线程被阻塞时,就会弹出如下弹窗,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可任意参考一下
    2022-10-10
  • Android中实现WebView和JavaScript的互相调用详解

    Android中实现WebView和JavaScript的互相调用详解

    这篇文章主要给大家介绍了关于Android中实现WebView和JavaScript的互相调用的相关资料,文中通过示例代码介绍的非常详细,对各位Android开发者们具有一定的参考学习价值,需要的朋友下面来一起看看吧。
    2018-03-03
  • Android绘图之Paint的使用方法详解

    Android绘图之Paint的使用方法详解

    这篇文章主要给大家介绍了关于Android绘图之Paint使用的相关资料,文中通过示例代码介绍的非常详细,并给大家介绍了DrawText 基线确定的方法,需要的朋友可以参考借鉴,下面随着小编来一些学习学习吧。
    2017-11-11
  • Android中的sqlite查询数据时去掉重复值的方法实例

    Android中的sqlite查询数据时去掉重复值的方法实例

    今天小编就为大家分享一篇关于Android中的sqlite查询数据时去掉重复值的方法实例,小编觉得内容挺不错的,现在分享给大家,具有很好的参考价值,需要的朋友一起跟随小编来看看吧
    2019-01-01
  • Android 二维码 生成和识别二维码 附源码下载

    Android 二维码 生成和识别二维码 附源码下载

    这篇文章主要介绍了Android 生成和识别二维码的方法,提供源码下载,需要的朋友可以参考下。
    2016-06-06
  • android中RecyclerView自定义分割线实现

    android中RecyclerView自定义分割线实现

    本篇文章主要介绍了android中RecyclerView自定义分割线实现,由于RecyclerView的布局方式多种多样,所以它的分割线也根据布局的不同有所差异,本文只针对LinearLayoutManager线性布局。
    2017-03-03
  • android 仿ios数字密码解锁界面的实例

    android 仿ios数字密码解锁界面的实例

    下面小编就为大家分享一篇android 仿ios数字密码解锁界面的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2017-12-12
  • Android自定义view实现阻尼效果的加载动画

    Android自定义view实现阻尼效果的加载动画

    这篇文章主要介绍了Android自定义view实现阻尼效果的加载动画的相关资料,非常不错,具有一定的参考借鉴加载,需要的朋友可以参考下
    2016-11-11
  • Kotlin基础学习之lambda中return语句详解

    Kotlin基础学习之lambda中return语句详解

    这篇文章主要给大家介绍了关于Kotlin基础学习之lambda中return语句的相关资料,文中通过示例代码介绍的非常详细,对大家学习或使用Kotlin具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2018-07-07
  • Android  指纹识别开发实例

    Android 指纹识别开发实例

    这篇文章主要介绍了Android6.0 指纹识别开发实例的相关资料,需要的朋友可以参考下
    2016-09-09

最新评论