Flutter中应用关闭/后台移除后如何持续运行倒计时计时器？

核心逻辑 #

应用被后台移除时，内存中的计时器状态会被系统销毁，所以必须持久化记录倒计时的关键时间节点，再结合后台任务保障时间计算的准确性，重启应用时从持久化存储中恢复状态，而非依赖内存中的临时数据。

具体实现步骤 #

1. 持久化存储倒计时结束时间戳 #

不要直接存储剩余秒数，而是存储倒计时的结束时间戳（当前时间毫秒数加上总倒计时时长的毫秒数）。这样即使应用重启，也能通过当前时间与结束时间的差值，精准计算剩余时间。推荐使用shared_preferences实现轻量存储：

import 'package:shared_preferences/shared_preferences.dart';

// 保存倒计时结束时间戳
Future<void> saveCountdownEndTime(int endTimeMillis) async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.setInt('countdown_end_time', endTimeMillis);
}

// 获取保存的结束时间戳
Future<int?> getCountdownEndTime() async {
  final prefs = await SharedPreferences.getInstance();
  return prefs.getInt('countdown_end_time');
}

// 倒计时完成后清除存储数据
Future<void> clearCountdownData() async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.remove('countdown_end_time');
}

2. 应用启动时恢复倒计时状态 #

在应用初始化阶段，读取存储的结束时间戳，计算当前剩余时间并恢复倒计时：

void initCountdown() async {
  final endTimeMillis = await getCountdownEndTime();
  if (endTimeMillis != null) {
    final currentTimeMillis = DateTime.now().millisecondsSinceEpoch;
    final remainingMillis = endTimeMillis - currentTimeMillis;
    
    if (remainingMillis > 0) {
      // 仍有剩余时间，启动倒计时
      startCountdown(remainingMillis);
    } else {
      // 倒计时已结束，清理存储数据
      await clearCountdownData();
    }
  } else {
    // 无存储数据，启动初始倒计时（示例为60秒）
    startCountdown(60000);
  }
}

void startCountdown(int durationMillis) {
  // 重新计算并保存结束时间，防止中途退后台丢失状态
  final endTimeMillis = DateTime.now().millisecondsSinceEpoch + durationMillis;
  saveCountdownEndTime(endTimeMillis);
  
  Timer.periodic(const Duration(milliseconds: 1000), (timer) {
    final currentMillis = DateTime.now().millisecondsSinceEpoch;
    final remaining = endTimeMillis - currentMillis;
    
    if (remaining <= 0) {
      timer.cancel();
      clearCountdownData();
      // 这里添加倒计时结束的业务逻辑
    } else {
      // 更新UI显示剩余时间
      updateCountdownUI(remaining);
    }
  });
}

3. 后台场景补充处理 #

如果需要在应用退后台时，依然能触发倒计时结束的通知（比如提醒用户），可以借助后台任务插件：

• Android端使用workmanager，设置周期性任务检查倒计时是否结束；
• iOS端受系统限制，无法频繁执行后台任务，可直接通过UNNotificationRequest设置本地通知，指定结束时间触发。

示例Android后台任务实现：

import 'package:workmanager/workmanager.dart';

void callbackDispatcher() {
  Workmanager().executeTask((task, inputData) async {
    final endTimeMillis = await getCountdownEndTime();
    if (endTimeMillis != null) {
      final currentMillis = DateTime.now().millisecondsSinceEpoch;
      if (currentMillis >= endTimeMillis) {
        // 倒计时结束，发送通知
        showNotification();
        await clearCountdownData();
      }
    }
    return Future.value(true);
  });
}

// 初始化后台任务
void initWorkmanager() {
  Workmanager().initialize(
    callbackDispatcher,
    isInDebugMode: false,
  );
  // 每15分钟检查一次（Android后台任务最小间隔为15分钟）
  Workmanager().registerPeriodicTask(
    'countdown_check',
    'countdownTask',
    frequency: const Duration(minutes: 15),
  );
}

关键注意事项 #

• 不要依赖前台Timer在后台运行，系统会暂停应用线程，导致计时器停止；
• iOS对后台任务限制严格，主要依赖持久化时间戳恢复状态，若需通知直接用本地通知指定触发时间；
• 测试时建议用真实设备，模拟器的“强制停止”行为可能与真实设备不一致。

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