安装react-native-geolocation-service遇Gradle 8.0兼容问题及配置求助

react-native-geolocation-service旧版本的构建配置与Gradle 8.0不兼容，核心原因包括：

• 使用了Gradle 8.0已废弃的compile依赖配置（需替换为implementation/api）
• 依赖的第三方定位库（如Google Play Services Location）版本过低，未适配Gradle 8.0的新规则
• 项目未满足Gradle 8.0的强制要求：如未显式声明namespace、compileSdkVersion低于33
• 库内置的AndroidManifest权限声明逻辑与Gradle 8.0的权限解析机制冲突

1. 升级react-native-geolocation-service到最新版本 #

先确保使用库的最新兼容版本，执行：

npm install react-native-geolocation-service@latest --save

2. 更新项目根目录build.gradle #

• 升级Android Gradle插件版本到适配8.0的稳定版，修改classpath：

  dependencies {
      classpath("com.android.tools.build:gradle:8.0.2") // 或更高兼容版本
      // 其他依赖...
  }
  

• 确保maven仓库优先级正确，将google()放在最前：

  repositories {
      google()
      mavenCentral()
      // 其他仓库...
  }
  

3. 修改app模块build.gradle #

• 替换所有废弃的compile配置为implementation（若需暴露依赖给其他模块则用api）
• 显式声明namespace（Gradle 8.0强制要求）：

  android {
      namespace "com.your.app.package" // 替换为你的实际包名
      // 其他配置...
  }
  

• 升级compileSdkVersion和targetSdkVersion到33+：

  android {
      compileSdkVersion 33
      defaultConfig {
          targetSdkVersion 33
          // 其他配置...
      }
  }
  

• 配置Google Play Services定位依赖的开关（若使用谷歌定位）：

  defaultConfig {
      manifestPlaceholders = [
          "reactNativeGeolocationUseGooglePlayServices": true
      ]
      // 其他配置...
  }
  

• 强制统一定位依赖版本（解决冲突）：

  android {
      // ...
      configurations.all {
          resolutionStrategy {
              force 'com.google.android.gms:play-services-location:21.0.1' // 适配Gradle8.0的版本
          }
      }
  }
  

4. 更新Gradle Wrapper版本 #

修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

5. 配置权限声明 #

在android/app/src/main/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" />

6. 清理缓存并重新构建 #

执行以下命令清除旧构建缓存并重新编译：

./gradlew clean
npm install
./gradlew assembleDebug

7. 代码中处理动态权限申请（Android 6.0+） #

Gradle 8.0适配的Android版本要求动态申请危险权限，示例代码：

import Geolocation from 'react-native-geolocation-service';
import { PermissionsAndroid } from 'react-native';

const getCurrentLocation = async () => {
  const hasPermission = await PermissionsAndroid.request(
    PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION,
    {
      title: '定位权限申请',
      message: '应用需要获取你的位置信息以提供服务',
      buttonPositive: '允许',
      buttonNegative: '拒绝',
    }
  );

  if (hasPermission === PermissionsAndroid.RESULTS.GRANTED) {
    Geolocation.getCurrentPosition(
      (position) => console.log('位置信息:', position),
      (error) => console.error('定位失败:', error),
      { enableHighAccuracy: true, timeout: 15000, maximumAge: 10000 }
    );
  } else {
    console.log('定位权限被拒绝');
  }
};

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