flutter集成极光推送

一、简述

极光推送，英文简称 JPush，免费的第三方消息推送服务，官方也推出众多平台的SDK以及插件。

参考链接

名称	地址
客户端集成插件	客户端集成插件 - 极光文档

二、操作步骤

2.1 添加插件

flutter项目中集成官方提供的 极光推送flutter插件

在根目录执行以下命令

flutter pub add jpush_flutter

2.2 初始化极光推送

在项目启动入口增加以下代码块

import 'package:flutter/material.dart'; import 'package:jpush_flutter/jpush_flutter.dart';import 'index_page.dart';///程序入口 void main() => runApp(RootApp());class RootApp extends StatefulWidget{@overrideState<StatefulWidget> createState() {return RottAppState();}}class RottAppState extends State<RootApp>{///根布局的初始化@overridevoid initState() {super.initState();///创建 JPushJPush jpush = new JPush();///配置应用 Keyjpush.setup(appKey: "替换成你自己的 appKey",channel: "theChannel",production: false,/// 设置是否打印 debug 日志debug: true, );}@overrideWidget build(BuildContext context) {///来构建return MaterialApp(///应用程序默认显示的页面home: IndexPage(),);} }

2.3 配置 flutter

2.3.1 Android项目

在 android 目录下配置 build.gradle

android: {....defaultConfig {applicationId "替换成自己应用 ID"...ndk {//选择要添加的对应 cpu 类型的 .so 库。abiFilters 'armeabi', 'armeabi-v7a', 'x86', 'x86_64', 'mips', 'mips64', 'arm64-v8a', }manifestPlaceholders = [JPUSH_PKGNAME : applicationId,JPUSH_APPKEY : "appkey", // NOTE: JPush 上注册的包名对应的 Appkey.JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.]} }

2.3.2 IOS项目

在 xcode8 之后需要点开推送选项： TARGETS -> Capabilities -> Push Notification 设为 on 状态

2.4 创建应用程序

在极光开发者平台中创建你的应用程序

极光开发者平台主页：portal

推送证书生成：证书设置指南 - 极光文档

2.5 常见错误

android ios 平台无法接收到推送消息

在注册推送的时候，可以先添加上接收通知消息的权限申请，申请成功权限后再进行注册。

三、JPush主要API

参考链接：https://github.com/jpush/jpush-flutter-plugin/blob/master/documents/APIs.md

3.1 初始化

添加初始化方法，调用 setup 方法会执行两个操作：

• 初始化 JPush SDK
• 将缓存的事件下发到 dart 环境中。

注意： 插件版本 >= 0.0.8 android 端支持在 setup 方法中动态设置 channel，动态设置的 channel 优先级比 manifestPlaceholders 中的 JPUSH_CHANNEL 优先级要高。

JPush jpush = new JPush(); jpush.setup(appKey: "替换成你自己的 appKey",channel: "theChannel",production: false,debug: false, // 设置是否打印 debug 日志);

3.2 事件监听

添加事件监听方法。

注意：addEventHandler 方法建议放到 setup 之前，其他方法需要在 setup 方法之后调用。

JPush jpush = new JPush(); jpush.addEventHandler(// 接收通知回调方法。onReceiveNotification: (Map<String, dynamic> message) async {print("flutter onReceiveNotification: $message");},// 点击通知回调方法。onOpenNotification: (Map<String, dynamic> message) async {print("flutter onOpenNotification: $message");},// 接收自定义消息回调方法。onReceiveMessage: (Map<String, dynamic> message) async {print("flutter onReceiveMessage: $message");},);

3.3 推送通知

JPush jpush = new JPush(); //获取 registrationId，这个 JPush 运行通过 registrationId 来进行推送. jpush.getRegistrationID().then((rid) { }); //停止推送功能，调用该方法将不会接收到通知。 jpush.stopPush(); //调用 stopPush 后，可以通过 resumePush 方法恢复推送。 jpush.resumePush();//指定触发时间，添加本地推送通知。 // 延时 3 秒后触发本地通知。 var fireDate = DateTime.fromMillisecondsSinceEpoch(DateTime.now().millisecondsSinceEpoch + 3000); var localNotification = LocalNotification(id: 234,title: 'notification title',buildId: 1,content: 'notification content',fireTime: fireDate,subtitle: 'notification subtitle', // 该参数只有在 iOS 有效badge: 5, // 该参数只有在 iOS 有效extras: {"fa": "0"} // 设置 extras ，extras 需要是 Map<String, String>); jpush.sendLocalNotification(localNotification).then((res) {});//清楚通知栏上所有通知。 jpush.clearAllNotifications();

3.4 IOS独有

JPush jpush = new JPush(); //申请推送权限，注意这个方法只会向用户弹出一次推送权限请求（如果用户不同意，之后只能用户到设置页面里面勾选相应权限），需要开发者选择合适的时机调用。 jpush.applyPushAuthority(new NotificationSettingsIOS(sound: true,alert: true,badge: true));//设置应用 badge 值，该方法还会同步 JPush 服务器的的 badge 值，JPush 服务器的 badge 值用于推送 badge 自动 +1 时会用到。 jpush.setBadge(66).then((map) {});//获取 iOS 点击推送启动应用的那条通知。 jpush.getLaunchAppNotification().then((map) {});