Flutter后台任务完全指南:App关闭后,你的代码还在运行吗?

dependencies:  flutter_background_service: ^5.0.0

// 注意：这个注解在release模式下至关重要！@pragma('vm:entry-point')voidonStart(ServiceInstance service) {  // 监听来自UI的消息  service.on('stopService').listen((event) {    service.stopSelf();  });  // 定时任务示例：每5秒打印一次  Timer.periodic(Duration(seconds: 5), (timer) {    print("后台服务运行中: ${DateTime.now()}");    // 可以通知UI（如果UI存活）    service.invoke('update', {"time": DateTime.now().toString()});  });}

voidmain() async {  WidgetsFlutterBinding.ensureInitialized();  // 配置并初始化后台服务  await FlutterBackgroundService.initialize(onStart);  runApp(MyApp());}// 启动服务voidstartBackgroundService() {  final service = FlutterBackgroundService();  service.startService();}// 停止服务voidstopBackgroundService() {  final service = FlutterBackgroundService();  service.invoke("stopService");}

<!-- 权限 --><uses-permissionandroid:name="android.permission.FOREGROUND_SERVICE" /><uses-permissionandroid:name="android.permission.WAKE_LOCK" /><!-- 针对Android 14+ --><uses-permissionandroid:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" /><!-- 服务声明 --><application...>    <service        android:name="com.ekasetiawans.flutter_background_service.BackgroundService"        android:exported="false" /></application>

// UI端：发送消息到后台服务ElevatedButton(  onPressed: () {    FlutterBackgroundService().invoke('doSync', {"force": true});  },  child: Text("立即同步"),);// UI端：监听后台服务消息FlutterBackgroundService().on('syncProgress').listen((event) {  print("同步进度: ${event?['percent']}%");});// 后台服务端：处理消息service.on('doSync').listen((event) async {  bool force = event?['force'] ?? false;  // 执行同步操作  for (int i = 0; i < 100; i+=10) {    await Future.delayed(Duration(seconds: 1));    service.invoke('syncProgress', {"percent": i});  }});

// 导入依赖import 'package:workmanager/workmanager.dart';voidmain() {  WidgetsFlutterBinding.ensureInitialized();  // 初始化WorkManager  Workmanager().initialize(    callbackDispatcher, // 回调分发器    isInDebugMode: true, // 调试模式（正式版设为false）  );  // 注册周期性任务  Workmanager().registerPeriodicTask(    "dailySync",           // 任务唯一标识    "syncData",            // 任务名称    frequency: Duration(hours: 24), // 执行频率    constraints: Constraints(      networkType: NetworkType.connected, // 需要网络      requiresBatteryNotLow: true,        // 电量不低    ),  );  runApp(MyApp());}// 回调分发器（必须顶层函数）voidcallbackDispatcher() {  Workmanager().executeTask((task, inputData) async {    print("后台任务执行: $task");    switch (task) {      case "syncData":        await performDataSync();        break;      case "cleanCache":        await cleanOldCache();        break;    }    return Future.value(true); // 返回执行结果  });}Future<void> performDataSync() async {  // 实际的数据同步逻辑  print("同步数据中... ${DateTime.now()}");}

// 类似这样的诊断逻辑if(Platform.isAndroid) {  final isBatteryOptimized = await checkBatteryOptimization();  if(isBatteryOptimized) {    showDialog(      context: context,      builder: (_) => AlertDialog(        title: Text("后台受限"),        content: Text("电池优化可能阻止后台同步，是否前往设置解除？"),        actions: [          TextButton(            onPressed: () => openBatteryOptimizationSettings(),            child: Text("去设置"),          ),        ],      ),    );  }}

┌─────────────────┐│   UI层          │  ← 用户界面、设置选项├─────────────────┤│   Service层     │  ← flutter_background_service (持续运行)├─────────────────┤│   Scheduler层   │  ← workmanager (定时触发)├─────────────────┤│   Platform层    │  ← 系统API、厂商适配└─────────────────┘

// background_service.dartclass BackgroundSyncService {  static final _service = FlutterBackgroundService();  static Future<void> initialize() async {    await FlutterBackgroundService.initialize(onStart);  }  staticvoidstart() {    _service.startService();  }  staticvoidstop() {    _service.invoke("stop");  }  staticvoidtriggerSync() {    _service.invoke("syncNow");  }}@pragma('vm:entry-point')voidonStart(ServiceInstance service) {  // 监听同步触发  service.on('syncNow').listen((event) async {    await _performSync(manual: true);  });  // 监听停止  service.on('stop').listen((event) {    service.stopSelf();  });  // 定时检查（每30分钟）  Timer.periodic(Duration(minutes: 30), (timer) async {    await _performSync(manual: false);  });  // 标记服务已就绪  service.setForegroundMode(true);}Future<void> _performSync({required bool manual}) async {  try {    // 检查网络    if (!await _hasNetwork()) {      print("无网络，跳过同步");      return;    }    // 检查电量（非手动同步时）    if (!manual && await _isLowBattery()) {      print("电量低，跳过自动同步");      return;    }    // 执行实际同步    print("开始同步数据...");    await DataSyncHelper.syncAll();    print("同步完成");    // 记录最后同步时间    await SharedPreferences.getInstance().then((prefs) {      prefs.setString('last_sync', DateTime.now().toIso8601String());    });  } catch (e) {    print("同步失败: $e");  }}

// settings_page.dartclassBackgroundSettingsPageextendsStatelessWidget{  @override  Widget build(BuildContext context) {    return Scaffold(      appBar: AppBar(title: Text("后台同步设置")),      body: ListView(        children: [          SwitchListTile(            title: Text("允许后台同步"),            value: _isBackgroundEnabled,            onChanged: _toggleBackground,          ),          ListTile(            title: Text("最后同步时间"),            subtitle: Text(_lastSyncTime ?? "从未同步"),          ),          ListTile(            title: Text("同步频率"),            trailing: DropdownButton(              value: _syncInterval,              items: [15, 30, 60, 120].map((minutes) {                return DropdownMenuItem(                  value: minutes,                  child: Text("每 $minutes 分钟"),                );              }).toList(),              onChanged: _changeInterval,            ),          ),          if(_isBatteryOptimized)            ListTile(              title: Text("⚠️ 电池优化已开启"),              subtitle: Text("可能影响后台同步"),              trailing: TextButton(                child: Text("去关闭"),                onPressed: _openBatterySettings,              ),            ),        ],      ),    );  }}