Flutter使用geolocator 6.2.1报warnings found and -Werror错误如何解决

报错原因 #

该报错是因为项目依赖的geolocator 6.2.1版本的安卓原生代码使用了Android SDK已废弃的API，同时你的安卓编译配置开启了-Werror规则（所有警告视为错误），导致编译直接中断。
完整报错日志如下：

/Users/sdaemoninfotech/Flutter/flutter/.pub-cache/hosted/pub.dartlang.org/geolocator-6.2.1/android/src/main/java/com/baseflow/geolocator/location/LocationManagerClient.java:10: warning: [deprecation] LocationProvider in android.location has been deprecated
import android.location.LocationProvider;
                       ^
error: warnings found and -Werror specified
/Users/sdaemoninfotech/Flutter/flutter/.pub-cache/hosted/pub.dartlang.org/geolocator-6.2.1/android/src/main/java/com/baseflow/geolocator/location/LocationMapper.java:29: warning: [deprecation] isFromMockProvider() in Location has been deprecated
      position.put("is_mocked", location.isFromMockProvider());
                                        ^
1 error
2 warnings
warnings found and -Werror specified

报错截图：

解决方案 #

方案1：升级geolocator依赖（最推荐） #

旧版本geolocator的废弃API兼容问题官方已在后续版本修复，你只需要修改项目根目录下pubspec.yaml文件中的geolocator依赖版本至官方最新稳定版即可，示例：

dependencies:
  flutter:
    sdk: flutter
  # 替换为当前最新稳定版即可，推荐使用10.0及以上版本
  geolocator: ^10.1.0

修改完成后执行flutter pub get重新拉取依赖，再重新编译项目即可。

方案2：修改安卓编译配置，忽略废弃警告 #

如果你的项目因为兼容性问题无法升级geolocator版本，可以通过调整编译规则解决报错：
打开项目android/build.gradle文件，在allprojects代码块中添加如下配置：

allprojects {
    // 原有配置保持不变，新增以下内容
    gradle.projectsEvaluated {
        tasks.withType(JavaCompile) {
            // 忽略废弃API的编译警告
            options.compilerArgs.add("-Xlint:-deprecation")
            // 也可以选择直接移除-Werror规则
            options.compilerArgs.remove("-Werror")
        }
    }
}

保存配置后重新编译项目即可。

方案3：临时修改缓存代码（仅适用于临时调试，不推荐长期使用） #

你可以直接修改本地Pub缓存中的geolocator代码，替换废弃API：

• 打开报错的LocationManagerClient.java文件，删除废弃的LocationProvider导入，替换为新版定位API对应的类
• 打开报错的LocationMapper.java文件，将location.isFromMockProvider()替换为兼容写法：androidx.core.location.LocationCompat.isMock(location)
  保存修改后重新编译即可。注意该方案在清空Pub缓存后会失效。

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