3分钟上手！Flutter Go本地通知完全指南：从配置到推送

吴毓佳

756人浏览 · 2025-10-08 05:28:10

吴毓佳 · 2025-10-08 05:28:10 发布

3分钟上手！Flutter Go本地通知完全指南：从配置到推送

【免费下载链接】flutter-go flutter 开发者帮助 APP，包含 flutter 常用 140+ 组件的demo 演示与中文文档项目地址: https://gitcode.com/gh_mirrors/fl/flutter-go

你是否还在为Flutter应用的消息触达烦恼？用户错过重要更新、活动提醒转化率低？本文将带你3步实现Flutter Go本地通知功能，让用户再也不会错过关键信息。读完本文你将掌握：极光推送SDK集成、跨平台配置技巧、3种场景化通知实现方案，以及完整的代码示例与项目文件路径指引。

技术选型：为什么选择极光推送？

Flutter Go项目已集成极光推送（JPush）SDK，通过flutter_jpush: ^0.0.4插件实现跨平台通知功能。该方案优势在于：

同时支持本地通知与远程推送
提供完善的Android/iOS原生适配
已在项目pubspec.yaml中配置，无需重复引入

准备工作：确认项目依赖与权限

1. 检查核心依赖

打开项目根目录的pubspec.yaml，确认已包含以下依赖：

dependencies:
  flutter_jpush: ^0.0.4  # 极光推送核心依赖
  permission_handler: ^3.0.0  # 权限管理

2. 权限配置验证

Android平台：检查android/app/src/main/AndroidManifest.xml，确保已添加网络权限：

<uses-permission android:name="android.permission.INTERNET" />

iOS平台：验证ios/Runner/Info.plist中的通知权限描述：

<key>NSUserNotificationUsageDescription</key>
<string>接收应用重要通知</string>

快速集成：3步完成通知初始化

步骤1：启动极光推送服务

在应用入口文件lib/main.dart中，已实现JPush初始化代码：

void _startupJpush() async {
  print("初始化jpush");
  await FlutterJPush.startup();  // 关键初始化方法
  print("初始化jpush成功");
}

// 在initState中调用
@override
void initState() {
  super.initState();
  _reqsMainPageIsOpen();
  _startupJpush();  // 启动推送服务
}

步骤2：配置设备注册监听

同样在lib/main.dart中，实现设备注册ID获取逻辑，用于标识唯一设备：

FlutterJPush.getRegistrationID().then((String regId) {
  print("设备注册ID:$regId");
  // 可将regId发送到后端，用于定向推送
});

步骤3：设置通知接收回调

完善通知接收与点击事件处理：

// 接收通知监听
FlutterJPush.addReceiveNotificationListener((JPushNotification notification) {
  print("收到推送: ${notification.title} - ${notification.content}");
  // 处理通知内容，如更新UI或本地存储
});

// 点击通知监听
FlutterJPush.addReceiveOpenNotificationListener((JPushNotification notification) {
  print("点击推送: ${notification.extras}");
  // 实现通知跳转逻辑，如打开特定页面
});

实战场景：3种本地通知实现方案

场景1：定时提醒通知

实现每日固定时间推送，如学习打卡提醒：

void scheduleDailyNotification() {
  // 设置每天9点推送
  FlutterJPush.sendLocalNotification(
    LocalNotification(
      id: 1001,
      title: "Flutter学习打卡",
      content: "今天也别忘了学习Flutter组件哦！",
      fireTime: DateTime.now().add(Duration(hours: 9)),
      repeatType: RepetitionType.DAILY,  // 每日重复
    )
  );
}

场景2：应用内事件触发通知

在用户完成特定操作后推送，如收藏成功提示：

// 在收藏按钮点击事件中调用
onPressed: () {
  // 收藏逻辑...
  FlutterJPush.sendLocalNotification(
    LocalNotification(
      id: 1002,
      title: "收藏成功",
      content: "已将该组件添加到您的收藏夹",
      fireTime: DateTime.now().add(Duration(seconds: 1)),
    )
  );
}

场景3：带自定义参数的通知

实现通知点击跳转特定页面，如组件详情页：

void sendTargetedNotification() {
  FlutterJPush.sendLocalNotification(
    LocalNotification(
      id: 1003,
      title: "新组件上线",
      content: "查看最新的Cupertino风格组件",
      fireTime: DateTime.now(),
      extras: {"route": "/widgetDetail", "id": "cupertinoButton"},  // 自定义参数
    )
  );
}

// 在点击监听中处理跳转
FlutterJPush.addReceiveOpenNotificationListener((JPushNotification notification) {
  String route = notification.extras["route"];
  if (route == "/widgetDetail") {
    // 使用Fluro路由跳转
    Application.router.navigateTo(context, "$route?id=${notification.extras["id"]}");
  }
});

项目文件结构与扩展建议

功能扩展建议

添加通知权限管理，处理权限申请逻辑
实现通知历史记录，使用SQLite存储
开发自定义通知设置界面

常见问题与解决方案

问题场景	解决方法	涉及文件
Android通知不显示	检查渠道配置	android/app/src/main/res/values/strings.xml
iOS通知权限被拒	引导用户开启权限	lib/utils/permission_utils.dart
应用后台不接收通知	配置保活机制	android/app/src/main/AndroidManifest.xml