如何让Flutter Cubit在后台监听位置变化？

1. 补全平台权限与后台配置 #

平台层面的权限和后台模式是基础，缺失的话插件后台功能无法生效：

• Android：在AndroidManifest.xml中添加后台位置权限，并声明插件所需的后台服务：

  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
  <service android:name="com.lyokone.location.LocationService" />
  

• iOS：在Info.plist中配置永久位置权限描述，同时开启后台位置更新模式：

  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>需要在后台获取您的位置信息</string>
  <key>NSLocationAlwaysUsageDescription</key>
  <string>需要在后台获取您的位置信息</string>
  <key>UIBackgroundModes</key>
  <array>
      <string>location</string>
  </array>
  

2. 把位置监听逻辑移至后台Isolate #

前台Cubit在App进入后台后会被系统限制资源，需将核心监听逻辑放到独立Isolate中，通过消息通道和前台Cubit通信：

class LocationCubit extends Cubit<LocationData> {
  late ReceivePort _receivePort;
  Isolate? _backgroundIsolate;

  LocationCubit() : super(LocationData()) {
    _initBackgroundIsolate();
  }

  void _initBackgroundIsolate() async {
    _receivePort = ReceivePort();
    // 启动后台Isolate，传入SendPort用于回传位置数据
    _backgroundIsolate = await Isolate.spawn(
      _backgroundLocationListener,
      _receivePort.sendPort,
    );
    // 监听后台传来的数据，更新Cubit状态
    _receivePort.listen((data) {
      if (data is LocationData) {
        emit(data);
      }
    });
  }

  // 后台Isolate的入口函数
  static void _backgroundLocationListener(SendPort sendPort) async {
    final location = Location();
    // 请求后台位置权限
    await location.requestBackgroundPermission();
    // 开启插件后台模式
    await location.enableBackgroundMode(enable: true);
    
    // 监听位置变化，将数据通过SendPort传给前台Cubit
    location.onLocationChanged.listen((currentLocation) {
      sendPort.send(currentLocation);
    });
  }

  @override
  Future<void> close() {
    _receivePort.close();
    _backgroundIsolate?.kill(priority: Isolate.immediate);
    return super.close();
  }
}

3. 处理系统休眠限制 #

• Android：系统进入Doze模式会限制后台任务，可使用workmanager插件定期唤醒任务，或申请忽略电池优化权限。
• iOS：App后台运行时长有限，可结合background_fetch插件，让系统定期唤醒App获取位置并同步到Cubit。

4. 验证插件后台兼容性 #

优先选择维护活跃、文档明确支持后台监听的位置插件（如geolocator或官方维护的location插件），避免使用仅支持前台延续的插件。

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