Flutter集成Firebase：后台/关闭状态下徽章计数无法重置

问题根源 #

• 重置逻辑仅在NotificationView的initState中触发，但应用从后台/关闭状态通过通知打开时，可能直接进入HomeView，未执行重置代码。
• 未在FCM的消息处理回调（getInitialMessage、onMessageOpenedApp）中添加徽章重置逻辑，导致从通知启动应用时无法触发重置。
• didChangeAppLifecycleState的resumed状态仅加载计数，未处理重置需求。

修复步骤 #

1. 完善FCM消息处理回调，添加重置逻辑
   实现_handleMessage方法，在用户点击通知打开应用时重置徽章计数：

   void _handleMessage(RemoteMessage? message) {
     if (message != null) {
       // 点击通知打开应用时重置徽章
       BadgeCounter.resetBadgeCount();
       // 可按需添加跳转到对应页面的逻辑
     }
   }
   

2. 在应用恢复活跃状态时重置徽章
   修改_HomeViewState的didChangeAppLifecycleState，当应用从后台回到前台时执行重置：

   @override
   void didChangeAppLifecycleState(AppLifecycleState state) {
     super.didChangeAppLifecycleState(state);
     if (state == AppLifecycleState.resumed) {
       debugPrint('AppLifecycleState.resumed');
       // 直接重置徽章计数，而非仅加载旧值
       BadgeCounter.resetBadgeCount();
     }
   }
   

3. 同步更新系统徽章（可选但关键）
   如果需要更新应用图标上的系统徽章，需在resetBadgeCount中同步操作（以flutter_app_badger插件为例）：

   static Future<void> resetBadgeCount() async {
     final prefs = await SharedPreferences.getInstance();
     badgeNotifier.value = 0;
     await prefs.setInt(keyBadgeCount, badgeNotifier.value);
     // 同步清除系统图标上的徽章
     await FlutterAppBadger.removeBadge();
   }
   

   注意：需先在pubspec.yaml中添加flutter_app_badger依赖。

4. 优化NotificationView的重置时机
   保持NotificationView的重置逻辑，添加延迟确保SharedPreferences操作完成：

   @override
   void initState() {
     super.initState();
     WidgetsBinding.instance.addPostFrameCallback((_) {
       BadgeCounter.resetBadgeCount();
     });
   }
   

完整修改后的关键代码片段 #

// 补充_handleMessage方法
void _handleMessage(RemoteMessage? message) {
  if (message != null) {
    BadgeCounter.resetBadgeCount();
    // 示例：跳转到通知页面
    // Navigator.pushNamed(context, '/notification');
  }
}

class NotificationApi {
  Future initNotifications() async {
    // 其他初始化代码
    await initPushNotifications();
  }

  Future<void> initPushNotifications() async {
    FirebaseMessaging.instance.getInitialMessage().then(_handleMessage);
    FirebaseMessaging.onMessageOpenedApp.listen(_handleMessage);
    FirebaseMessaging.onBackgroundMessage(_firebaseMessagingBackgroundHandler);
    FirebaseMessaging.onMessage.listen((message) {
      debugPrint('onMessage: ${BadgeCounter.badgeNotifier.value}');
      BadgeCounter.incrementBadgeCount();
      showNotification(message);
    });
  }
}

class _HomeViewState extends ConsumerState<HomeView> {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    NotificationApi().initNotifications();
    BadgeCounter.loadBadgeCount(); 
  }

  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    super.didChangeAppLifecycleState(state);
    if (state == AppLifecycleState.resumed) {
      debugPrint('AppLifecycleState.resumed');
      BadgeCounter.resetBadgeCount();
    }
  }

  @override
  void dispose() {
    super.dispose();
    WidgetsBinding.instance.removeObserver(this);
  }
}

class _NotificationViewState extends ConsumerState<NotificationView> {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addPostFrameCallback((_) {
      BadgeCounter.resetBadgeCount();
    });
  }
}

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