当前位置：首页 > news >正文

如何使用 Flutter Local Notifications 插件

news 2025/7/2 14:25:47

如何使用 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上的额外配置。