Flutter中屏幕关闭时持续运行BLE扫描的问题求助

针对你遇到的Android屏幕关闭后BLE扫描暂停的问题，核心原因是Android系统电源管理机制（Doze模式、App Standby）对后台操作的限制，加上BLE扫描所需权限、服务配置不完整导致的。以下是具体解决步骤：

1. 补全必要权限 #

在AndroidManifest.xml中添加以下权限：

<!-- 基础BLE权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- Android 12+专属BLE权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

<!-- 后台扫描必需权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

<!-- 声明前台服务类型 -->
<service
    android:name=".YourForegroundService"
    android:foregroundServiceType="location" />

注意：必须动态申请ACCESS_FINE_LOCATION和ACCESS_BACKGROUND_LOCATION权限，仅在Manifest声明无效。

2. 配置带位置类型的前台服务 #

Android 8+要求前台服务必须显示通知，且扫描类服务需指定foregroundServiceType="location"。可以用flutter_foreground_task简化实现，或手动编写原生服务：

• 使用flutter_foreground_task时，初始化需设置服务类型为ForegroundServiceType.location，确保通知持续显示。
• 确保BLE扫描逻辑运行在前台服务进程中，普通Isolate在屏幕关闭后可能被系统回收。

3. 调整BLE扫描参数 #

修改扫描代码，避免使用ScanMode.lowLatency（后台会被系统强制限制），同时指定具体服务UUID而非空数组：

@pragma('vm:entry-point')
void someFunction(String arg) async {
  final flutterReactiveBle = FlutterReactiveBle();
  
  // 指定目标设备的服务UUID，不要传空数组
  const targetServiceUuids = [Uuid.parse("0000ffe0-0000-1000-8000-00805f9b34fb")];
  
  flutterReactiveBle.scanForDevices(
    withServices: targetServiceUuids,
    scanMode: ScanMode.lowPower, // 后台推荐用lowPower或balanced模式
  ).listen((device) {
    print("device: ${device.id}");
  }, onError: (e) {
    print("error: $e");
  });
}

原因：空数组的全量扫描会被系统判定为高功耗操作，后台限制更严格；指定服务UUID后，系统会放宽扫描限制。

4. 避开电池优化 #

引导用户将应用加入电池优化白名单，代码中可跳转系统设置页面让用户操作：

import 'package:flutter/services.dart';

void requestIgnoreBatteryOptimizations() async {
  const platform = MethodChannel('com.example.app/battery');
  try {
    await platform.invokeMethod('requestIgnoreBatteryOptimizations');
  } on PlatformException catch (e) {
    print(e.message);
  }
}

对应原生Android代码（Kotlin）：

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.example.app/battery"

    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "requestIgnoreBatteryOptimizations") {
                val intent = Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS).apply {
                    data = Uri.parse("package:$packageName")
                }
                startActivity(intent)
                result.success(null)
            } else {
                result.notImplemented()
            }
        }
    }
}

5. 验证Isolate有效性 #

确保Isolate入口函数正确标记@pragma('vm:entry-point')，且启动Isolate时绑定到前台服务上下文。若普通Isolate仍有问题，可尝试用android_alarm_manager_plus触发定时扫描（适合低频率场景）。

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