Flutter通知管理插件eazy_notification的使用

本文将介绍如何使用Flutter的通知管理插件eazy_notification来处理不同平台的通知。此插件通过桥接其他通知包（如Awesome Notifications、Local Notifier和Elegant Notifications）来为每个平台提供通知功能。

1. 定制基于平台的通知

注意：对于每个平台，都需要按照相应平台的要求进行必要的初始化。

2. 创建并初始化通知服务

该插件使用mplatform来确定当前运行的平台。

步骤：

1. 创建通知服务实例

根据当前平台选择不同的通知服务类。

final EazyNotificationService _service = switch (Mplatform.current) {
  Mplatform.ios => MobileNotificationService(
      channels: NotificationChannelEnum.values.map((e) => e.channel).toList(),
      channelGroups: NotificationChannelEnum.values.map((e) => e.channelGroup).toList(),
    ),
  Mplatform.android => MobileNotificationService(
      channels: NotificationChannelEnum.values.map((e) => e.channel).toList(),
      channelGroups: NotificationChannelEnum.values.map((e) => e.channelGroup).toList(),
    ),
  Mplatform.web => WebNotificationService(),
  Mplatform.fuchsia => WebNotificationService(),
  Mplatform.linux => DesktopNotificationService(appName: AppConfig.appName),
  Mplatform.windows => DesktopNotificationService(appName: AppConfig.appName),
  Mplatform.macos => DesktopNotificationService(appName: AppConfig.appName),
};

2. 在main()函数中初始化服务

在应用启动时调用init()方法来初始化通知服务。

await _service.init();

3. 显示通知

使用pushNotification方法向用户发送通知。

bool sent = await _service.pushNotification(
  context: context,
  desktopOptions: desktopOptions,
  mobileOptions: mobileOptions,
  webOptions: webOptions,
);

3. Android 和 iOS 平台

Android 和 iOS 平台使用Awesome Notifications插件来实现通知功能。

创建通知选项

class MobileOptions {
  NotificationChannel channel;
  int notificationId;
  String title;
  String message;
  bool requireInputText = false;
  bool wakeUpScreen = false;
  bool locked = false;
  bool autoDismissible = true;
  Duration? timeout;
  Duration? chronometer;
  ActionType actionType = ActionType.Default;
  NotificationLayout notificationLayout = NotificationLayout.BigText;
  NotificationCategory notificationCategory = NotificationCategory.Event;
  String? bigPicture;
  String? largeIcon;
  String? icon;
  Map<String, String?>? payload;
  List<NotificationActionButton> actions = const [];
  NotificationCalendar? schedule;
  Future<bool> Function()? hasAllowedPermissionRational;

  MobileOptions({
    required this.channel,
    required this.notificationId,
    required this.title,
    required this.message,
    this.requireInputText = false,
    this.wakeUpScreen = false,
    this.locked = false,
    this.autoDismissible = true,
    this.timeout,
    this.chronometer,
    this.actionType = ActionType.Default,
    this.notificationLayout = NotificationLayout.BigText,
    this.notificationCategory = NotificationCategory.Event,
    this.bigPicture,
    this.largeIcon,
    this.icon,
    this.payload,
    this.actions = const [],
    this.schedule,
    this.hasAllowedPermissionRational,
  });
}

请求通知权限

在iOS和Android上请求通知权限时，可以使用以下代码：

Future<bool> hasAllowedPermissionRational(BuildContext context) async {
  bool allowed = false;
  await showGenericDialog(
    context: context,
    title: '允许通知',
    brief: '我们希望通知您更新信息',
    confirmButtonText: '允许',
    onConfirm: (c) async {
      Navigator.of(context).pop();
      allowed = true;
    },
    denyButtonText: '稍后再说',
    onDeny: (c) async {
      Navigator.of(context).pop();
      allowed = false;
    },
  );
  return allowed;
}

4. Windows、Linux 和 macOS 平台

桌面端使用Local Notifier插件来实现通知功能。

创建通知选项

class DesktopOptions {
  String notificationId;
  String title;
  String? subTitle;
  String message;
  bool silent;
  Function(LocalNotification)? onShow;
  Function(LocalNotificationCloseReason)? onClose;
  Function(LocalNotification)? onClick;
  Function(int)? onClickAction;

  DesktopOptions({
    required this.notificationId,
    required this.title,
    this.subTitle,
    required this.message,
    this.silent = true,
    this.onShow,
    this.onClose,
    this.onClick,
    this.onClickAction,
  });
}

5. Web 平台

Web 端使用Elegant Notifications插件来实现通知功能。

创建通知选项

class WebOptions {
  final Widget? title;
  final Widget description;
  final Widget icon;
  final Function() onDismiss;
  final ProgressIndicatorBar? progressIndicator;
  final NotificationAction? notificationAction;
  final NotificationCloseButton? notificationCloseButton;
  final NotificationStyle? notificationStyle;
  final bool autoDismiss;

  WebOptions({
    this.title,
    required this.description,
    required this.icon,
    required this.onDismiss,
    this.progressIndicator,
    this.notificationAction,
    this.notificationCloseButton,
    this.notificationStyle,
    this.autoDismiss = true,
  });
}