如何使用 Flutter Local Notifications 插件

最新推荐文章于 2025-02-12 10:16:08 发布

马琥承

最新推荐文章于 2025-02-12 10:16:08 发布

阅读量1.4k

点赞数 12

本文链接：https://blog.csdn.net/gitblog_00306/article/details/141770128

版权

如何使用 Flutter Local Notifications 插件

local_notificationsNo longer in development -Flutter plugin for creating notifications项目地址:https://gitcode.com/gh_mirrors/lo/local_notifications

项目介绍

Flutter Local Notifications 是一个为 Flutter 应用程序提供本地通知功能的插件。它支持Android、iOS、macOS等多个平台，并提供了丰富的API来定制通知的表现形式和行为，如设置通知渠道、处理点击通知后的响应、以及实现周期性通知等。这个插件特别适合那些需要提醒或基于时间触发功能的应用，例如日程提醒、消息通知等。

项目快速启动

环境要求

Flutter SDK 最新版本。
Android API 16（Jelly Bean）及以上。
iOS 8.0及以上。
对于macOS开发，也有相应的支持版本。

安装

在你的 Flutter 项目的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  flutter_local_notifications: ^latest_version

然后运行 flutter pub get 来安装插件。

初始化

在应用程序启动时初始化 Flutter Local Notifications 插件：

对于Flutter应用主入口：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
      FlutterLocalNotificationsPlugin();

  var initializationSettingsAndroid =
      AndroidInitializationSettings('@mipmap/ic_launcher');
  var initializationSettingsIOS = IOSInitializationSettings();
  
  var initializationSettings = InitializationSettings(
    android: initializationSettingsAndroid,
    iOS: initializationSettingsIOS,
  );

  await flutterLocalNotificationsPlugin.initialize(initializationSettings,
      onDidReceiveNotificationResponse: onDidReceiveNotificationResponse);

  runApp(MyApp());
}

// 处理通知点击响应
Future<void> onDidReceiveNotificationResponse(NotificationResponse response) async {
  final payload = response.payload;
  if (payload == null) {
    debugPrint('通知无有效载荷');
  } else {
    await Navigator.push(
        context, MaterialPage.route(builder: (_) => SecondScreen(payload)));
  }
}

显示通知

展示一个简单的通知示例：

const AndroidNotificationDetails androidDetails =
    AndroidNotificationDetails('channel_id', 'channel_name',
        'Channel description', Importance.max, priority: Priority.high);
const NotificationDetails details =
    NotificationDetails(android: androidDetails);

await flutterLocalNotificationsPlugin.show(
  0, // 通知ID
  '通知标题', // 通知标题
  '这是通知的内容', // 通知正文
  details, // 通知细节
  payload: '自定义数据', // 当通知被点击时传递的数据
);

应用案例和最佳实践

深链接集成：通过在通知payload中携带页面标识符，当用户点击通知时，可以直接导航到对应的页面。
日常提醒：利用周期性通知设定每日提醒，提高用户参与度。
个性化通知：根据用户行为动态生成通知内容，提升用户体验。

代码示例 - 周期性通知

对于周期性通知的实现，需遵循平台特定的初始化逻辑，并配置重复通知的调度，例如：

final int id = 1;
final String recurringId = 'daily_at_7am';
final Time time = Time(7, 0, 0); // 每天早上7点
await flutterLocalNotificationsPlugin.zonedSchedule(
    id,
    'Daily Reminder',
    'Remember to do your tasks.',
    zonedScheduleDateTime,
    const NotificationDetails(android: androidDetails),
    androidAllowWhileIdle: true,
    uiLocalNotificationDateInterpretation:
        UILocalNotificationDateInterpretation.absoluteTime,
);

确保对各个平台的特殊初始化需求有所了解，比如iOS和macOS上的额外配置。