Android Studio Giraffe添加GPS功能后编译报错求助

• 使用Android Studio Giraffe开发教程项目，添加GPS功能前可正常运行，添加后编译出现大量无法解析的错误，核心错误信息如下：

Failed to transform common-27.1.3.jar
(com.android.tools:common:27.1.3) to match attributes
{artifactType=android-classes-jar, org.gradle.category=library,
org.gradle.libraryelements=jar, org.gradle.status=release,
org.gradle.usage=java-api}.

已提供AndroidManifest.xml、app级build.gradle和项目级build.gradle文件，请求排查配置问题。

1. 排查依赖冲突 #

• 执行终端命令./gradlew app:dependencies生成依赖树，检查是否存在与com.android.tools:common:27.1.3冲突的依赖项。
• 若发现版本冲突，可通过强制指定版本解决：

  configurations.all {
      resolutionStrategy.force 'com.android.tools:common:27.1.3'
      // 或尝试升级至适配Giraffe的版本，如28.0.0及以上
  }
  

2. 校验Gradle版本兼容性 #

Android Studio Giraffe对应Gradle插件版本需为7.4.0及以上，确保项目配置匹配：

• 项目级build.gradle中插件版本配置：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2'
      // 其他classpath依赖
  }
  

• gradle/wrapper/gradle-wrapper.properties中的Gradle版本：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

3. 清理重建项目 #

• 依次执行Build > Clean Project、Build > Rebuild Project，清除编译缓存后重新编译。
• 也可手动删除项目根目录下的.gradle、build文件夹，重启Android Studio后重新构建。

4. 检查GPS配置正确性 #

• 确认AndroidManifest.xml中已添加必要定位权限：

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <!-- Android 10及以上如需后台定位，需添加以下权限 -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  

• 若使用Google Play服务定位，确保依赖添加正确：

  dependencies {
      implementation 'com.google.android.gms:play-services-location:21.0.1'
  }
  

5. 更新Android Studio组件 #

• 打开Settings > Appearance & Behavior > System Settings > Updates，检查并更新Android Studio、SDK Tools、Gradle插件至最新兼容版本。

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