如何使用GeoFire插件实现Flutter应用后台位置同步至Firebase

• 订阅变量作用域错误：你将位置流订阅对象backgroundStreamSubscription定义为didChangeAppLifecycleState方法内的局部变量，方法执行完成后该变量会被垃圾回收，对应的位置监听流直接被销毁，无法持续接收位置更新。
• 缺少系统后台定位权限配置：仅靠Flutter层的生命周期监听无法绕过系统对后台服务的限制，Android、iOS系统都要求额外配置权限和保活策略才能允许应用在后台获取位置信息。
• 定位流未开启后台模式：默认Geolocator.getPositionStream()没有开启后台定位配置，应用退后台后系统会自动暂停定位服务。

1. 调整订阅变量作用域 #

将订阅对象提升为State类的全局成员变量，同时增加前台恢复时的取消逻辑，避免重复监听：

import 'dart:io';
import 'package:geolocator/geolocator.dart';

class _HomeTabPageState extends State < HomeTabPage >
    with AutomaticKeepAliveClientMixin, WidgetsBindingObserver {
  // 把订阅变量提到类全局
  StreamSubscription<Position>? backgroundStreamSubscription;

  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
  }

  @override
  void dispose() {
    // 销毁时取消订阅
    backgroundStreamSubscription?.cancel();
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) async {
    super.didChangeAppLifecycleState(state);
    if (state == AppLifecycleState.inactive ||
        state == AppLifecycleState.detached) return;
    final isBackground = state == AppLifecycleState.paused;
    final isForeground = state == AppLifecycleState.resumed;

    if (isBackground) {
      print("### paused");
      // 开启后台定位前先取消已有订阅，避免重复创建
      backgroundStreamSubscription?.cancel();
      backgroundStreamSubscription =
          Geolocator.getPositionStream(
            locationSettings: _buildLocationSettings()
          ).listen((Position position) {
            initPositionPoint = position;
            Geofire.setLocation(
                currentFirebaseUser.uid, position.latitude, position.longitude);
          });
    } 
    // 回到前台时取消后台订阅，复用前台原有定位逻辑即可
    else if (isForeground) {
      backgroundStreamSubscription?.cancel();
      backgroundStreamSubscription = null;
    }
  }

  // 构建支持后台定位的配置参数
  LocationSettings _buildLocationSettings() {
    if (Platform.isAndroid) {
      return AndroidSettings(
        accuracy: LocationAccuracy.high,
        distanceFilter: 10,
        // Android后台定位必须配置前台通知保活
        foregroundNotificationConfig: ForegroundNotificationConfig(
          notificationId: 12345,
          notificationChannelId: "location_background",
          notificationChannelName: "后台定位服务",
          notificationContent: "应用正在后台获取位置信息",
          enableWakeLock: true,
        ),
      );
    } else if (Platform.isIOS) {
      return AppleSettings(
        accuracy: LocationAccuracy.high,
        distanceFilter: 10,
        // 开启iOS后台定位权限
        allowsBackgroundLocationUpdates: true,
        pauseLocationUpdatesAutomatically: false,
      );
    }
    return const LocationSettings(
      accuracy: LocationAccuracy.high,
      distanceFilter: 10,
    );
  }
}

2. 配置平台权限 #

Android端 #

在android/app/src/main/AndroidManifest.xml中添加以下权限：

<!-- 前台定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 后台定位权限，Android 10及以上需要 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 前台服务权限，Android 12及以上需要 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

iOS端 #

1. 在ios/Runner/Info.plist中添加权限说明：

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要始终获取位置信息以在后台更新位置到服务器</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>需要获取位置信息以更新位置到服务器</string>

2. 打开Xcode项目，进入Signing & Capabilities标签，添加Background Modes能力，勾选Location updates选项。

3. 权限申请逻辑调整 #

启动定位前需要先向用户申请「始终允许」的定位权限，仅申请使用时允许的权限无法支持后台定位。

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