Flutter中如何在后台运行Dart代码实现Beacon扫描与数据上报

1. 核心实现逻辑 #

• Beacon扫描的后台保活依赖原生端的权限和进程优先级配置，Dart层代码可以通过绑定原生端的扫描回调，在后台触发执行
• 不需要自行实现原生层和Dart层的跨线程通信，现有成熟插件已经封装了对应能力，可直接调用

2. Android端适配要点 #

• 先在AndroidManifest.xml中配置必要权限：

<!-- 前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- 后台定位权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<!-- 蓝牙扫描权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

• 扫描Beacon的同时启动前台服务，在通知栏展示常驻通知，提升App进程优先级，避免被系统回收，扫描回调可直接绑定Dart层处理函数

3. iOS端适配要点 #

• 在Info.plist中配置后台运行权限：

<key>UIBackgroundModes</key>
<array>
    <!-- 蓝牙后台扫描权限 -->
    <string>bluetooth-central</string>
    <!-- 后台定位权限 -->
    <string>location</string>
</array>
<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>需要始终定位权限以在后台扫描Beacon设备</string>

• iOS退后台后会通过区域监听能力自动唤醒App执行扫描回调，回调内的Dart代码可以正常运行

4. Dart层代码参考 #

// 初始化Beacon扫描，注册回调函数
beaconManager.listen((List<Beacon> beacons) {
  // 此处Dart代码在后台也可正常执行
  final reportData = beacons.map((beacon) => {
    "uuid": beacon.uuid,
    "major": beacon.major,
    "minor": beacon.minor,
    "rssi": beacon.rssi
  }).toList();
  // 直接调用Dart的HTTP库上报数据到后端
  http.post(Uri.parse("你的后端接口地址"), body: reportData);
});
// 启动后台扫描
beaconManager.startBackgroundScan(region: BeaconRegion(identifier: "custom_region"));

注意事项 #

• 不要将上报逻辑和主UI的生命周期绑定，避免App退后台后主Isolate被暂停导致逻辑中断
• 高版本Android系统需要引导用户手动开启后台活动权限、自启动权限，避免进程被厂商省电策略回收
• iOS后台扫描的触发频率受系统限制，无法达到和前台一致的扫描频率，属于系统原生限制

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