如何在Flutter应用中实现锁屏前台场景下可用的Geofencing功能

核心原因：即使应用位于前台，锁屏后系统会自动将应用进程调整至低优先级组，部分厂商的电源优化策略也会直接切断位置相关事件的回调，导致地理围栏触发失败。 #

1. 基础权限配置 #

• 安卓端需要在AndroidManifest.xml中声明以下权限，仅申请精确定位权限无法满足锁屏场景需求：

<!-- 基础精确定位权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 安卓10+ 后台位置权限，锁屏状态下系统判定位置调用属于后台场景 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 前台服务相关权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />
<!-- 唤醒锁权限，防止锁屏后系统休眠 -->
<uses-permission android:name="android.permission.WAKE_LOCK" />

• iOS端需要在Info.plist中配置NSLocationAlwaysAndWhenInUseUsageDescription权限说明，不能仅配置使用时权限，地理围栏锁屏回调需要用户授权「始终允许位置访问」。

2. 开启前台服务锁进程优先级（安卓必做） #

绑定前台服务锁定应用进程优先级，避免锁屏后被系统回收或限制回调，可以通过前台服务相关Flutter插件快速实现，核心配置如下：

// 初始化前台服务配置
await FlutterForegroundTask.init(
  androidNotificationOptions: AndroidNotificationOptions(
    channelId: 'geofencing_service',
    channelName: '地理围栏服务',
    channelDescription: '正在运行地理围栏监测，锁屏时也可正常接收区域提醒',
    priority: NotificationPriority.HIGH,
  ),
  iosNotificationOptions: const IOSNotificationOptions(
    showNotification: true,
    playSound: false,
  ),
  foregroundTaskOptions: const ForegroundTaskOptions(
    interval: 5000,
    isOnceEvent: false,
    autoRunOnBoot: true,
    allowWakeLock: true, // 关键配置：持有唤醒锁，防止锁屏后系统休眠切断事件回调
    allowWifiLock: true,
  ),
);
// 启动前台服务
await FlutterForegroundTask.startService(
  notificationTitle: '地理围栏监测中',
  notificationText: '进入指定区域将自动推送提醒',
);

3. 地理围栏插件参数调整 #

• 地理围栏优先级设置为高精度模式，不要使用低功耗模式，避免系统为了省电延迟或过滤触发事件
• 安卓端需开启androidAllowWhileIdle参数，强制系统在低电空闲模式下也能响应地理围栏触发事件
• 触发响应延迟参数loiteringDelay设置为0，减少触发回调的等待时间

4. 国内定制系统适配 #

小米、华为、vivo、OPPO等厂商的定制系统有独立的电源管理策略，需要引导用户手动开启以下权限：

• 关闭应用的电池优化，设置为「无限制」
• 允许应用后台弹出界面
• 允许应用自启动和关联启动

5. 锁屏通知权限配置 #

需要提前申请通知权限，同时开启锁屏通知显示权限，避免地理围栏触发后通知被系统拦截不展示：

• iOS端请求通知权限时需同时开启alert、sound、badge三个选项
• 安卓端通知渠道优先级需设置为高，避免被系统归类为静默通知

注意：如果用户开启了系统超级省电模式，除系统白名单应用外所有第三方应用的位置回调都会被强制切断，该场景无法通过代码适配，需引导用户关闭超级省电模式。

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