Flutter中点击已调度本地通知如何打开指定页面？

应用完全关闭后点击通知，常规的onSelectNotification回调无法捕获payload，原因是此时应用处于冷启动状态，回调还未完成注册。以下是可行的解决方案：

核心思路 #

通过插件提供的getNotificationAppLaunchDetails方法，在应用初始化阶段获取冷启动时的通知数据，区分冷启动和热启动场景分别处理导航逻辑。

具体实现步骤 #

1. 初始化通知插件并获取冷启动详情 #

在应用启动时，先完成通知插件的初始化，紧接着调用getNotificationAppLaunchDetails获取启动来源信息。如果是通过点击通知启动，提取对应的payload。

2. 区分冷启动/热启动处理导航 #

• 冷启动：根据获取到的payload，直接指定初始路由或在首页初始化后触发导航
• 热启动：保留onSelectNotification回调处理通知点击事件

完整代码示例 #

import 'package:flutter/material.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';

final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
    FlutterLocalNotificationsPlugin();
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化通知配置
  const AndroidInitializationSettings androidInitSettings =
      AndroidInitializationSettings('@mipmap/ic_launcher');
  const InitializationSettings initSettings =
      InitializationSettings(android: androidInitSettings);
  
  await flutterLocalNotificationsPlugin.initialize(
    initSettings,
    onSelectNotification: (String? payload) async {
      // 处理热启动时的通知点击
      if (payload == 'this') {
        navigatorKey.currentState?.pushNamed('/targetPage');
      }
    },
  );

  // 获取冷启动的通知启动详情
  final NotificationAppLaunchDetails? launchDetails =
      await flutterLocalNotificationsPlugin.getNotificationAppLaunchDetails();
  
  // 判断是否通过通知冷启动应用
  final String? initialPayload = launchDetails?.didNotificationLaunchApp == true
      ? launchDetails?.payload
      : null;

  runApp(MyApp(initialPayload: initialPayload));
}

class MyApp extends StatelessWidget {
  final String? initialPayload;

  const MyApp({super.key, this.initialPayload});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey,
      // 根据初始payload指定启动页面
      initialRoute: initialPayload == 'this' ? '/targetPage' : '/',
      routes: {
        '/': (context) => const HomePage(),
        '/targetPage': (context) => const TargetPage(),
      },
    );
  }
}

// 主页
class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('主页')),
    );
  }
}

// 目标页面
class TargetPage extends StatelessWidget {
  const TargetPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('指定页面')),
    );
  }
}

额外配置提示 #

• Android端：建议在AndroidManifest.xml中把MainActivity的launchMode设为singleTop，避免点击通知时重复创建Activity实例：

  <activity
      android:name=".MainActivity"
      android:launchMode="singleTop"
      ...>
  

• iOS端：确保已在Info.plist中配置通知权限，插件会自动处理冷启动的payload获取，无需额外原生代码。

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