Android Studio中Gradle无法解析Google Sheets API依赖问题

可能的原因 #

• 依赖版本无效：你指定的v4-rev20220328-1.32.1版本可能未在google()或mavenCentral()仓库中发布，或是版本号格式存在错误
• 仓库配置异常：尽管已添加仓库，但可能存在配置位置错误、仓库顺序问题，或是项目级与模块级仓库配置冲突
• Gradle本地缓存损坏：本地缓存的依赖数据已损坏，导致Gradle无法正确解析依赖

调试步骤 #

1. 验证依赖版本有效性
   手动确认该版本是否符合Google API依赖的命名规范，或是尝试更换为更近期的稳定版本，确认目标版本是否在官方仓库中存在。

2. 检查仓库配置正确性

   • 确保settings.gradle中dependencyResolutionManagement块下的repositories包含google()和mavenCentral()，配置示例如下：

     dependencyResolutionManagement {
         repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
         repositories {
             google()
             mavenCentral()
         }
     }
     rootProject.name = "YourAppName"
     include ':app'
     

   • 避免在应用级build.gradle中重复配置仓库，防止出现仓库优先级冲突。

3. 清理Gradle缓存

   • 通过Android Studio菜单执行File > Invalidate Caches...，勾选"Clear file system cache and local history"后重启IDE
   • 手动删除本地Gradle缓存目录：Windows路径为C:\Users\<你的用户名>\.gradle\caches，Mac/Linux路径为~/.gradle/caches

4. 强制刷新依赖

   • 点击Android Studio右侧Gradle面板中的「Refresh all Gradle projects」按钮
   • 或在项目根目录终端执行命令：

     # Mac/Linux
     ./gradlew clean build --refresh-dependencies
     # Windows
     gradlew.bat clean build --refresh-dependencies
     

解决步骤 #

1. 替换为有效依赖版本
   使用Google Sheets API的最新稳定版本，确保三个依赖的核心版本保持一致，示例如下：

   implementation 'com.google.api-client:google-api-client-android:2.0.0'
   implementation 'com.google.api-client:google-api-client-gson:2.0.0'
   implementation 'com.google.apis:google-api-services-sheets:v4-rev20240526-2.0.0'
   

2. 确认仓库配置生效
   同步项目前，再次检查settings.gradle中的仓库配置，确保google()仓库优先于mavenCentral()（部分Google专属依赖仅在google()仓库中存在）。

3. 重新同步项目
   完成上述操作后，点击Android Studio顶部的「Sync Project with Gradle Files」按钮，重新执行依赖同步。

内容的提问来源于stack exchange，提问作者אורי עזריה