【Flutter】极光推送配置流程(极光通道/华为厂商/IOS) 章一 ...

极光推送配置流程
干系文章

推送配置共三篇(如下链接)
【Flutter】极光推送配置流程(极光通道/华为厂商/IOS) 章一
【Flutter】极光推送配置流程(小米厂商通道) 章二
【Flutter】极光推送配置流程(VIVO/OPPO/荣耀厂商通道) 章三
极光通道（在线）

配置时间 2024年3月11日
创建应用

应用列表 - 创建应用

Android - 选中消息推送 - 下一步
创建Flutter项目

填写包名

创建完成

项目配置

运行下令行 flutter pub add jpush_flutter

Android -> app -> build.gradle 更改JPUSH_APPKEY的值

工具类注册JPush Android

1. import 'package:flutter/services.dart';
2. import 'package:get/get.dart';
3. import 'package:jpush_flutter/jpush_flutter.dart';
5. class JPushUtil {
6.   JPushUtil._internal();
8.   static final _instance = JPushUtil._internal();
10.   factory JPushUtil() => _instance;
12.   final JPush jPush = JPush();
14.   Future<void> initPlatformState() async {
15.     String? platformVersion;
16.     try {
17.       jPush.addEventHandler(
18.         onReceiveNotification: (message) async {
19.           print("flutter onReceiveNotification: $message");
20.         },
21.         onOpenNotification: (message) async {
22.           print("flutter onOpenNotification: $message");
23.         },
24.         onReceiveMessage: (message) async {
25.           print("flutter onReceiveMessage: $message");
26.         },
27.         onReceiveNotificationAuthorization: (message) async {
28.           print("flutter onReceiveNotificationAuthorization: $message");
29.         },
30.         onConnected: (message) {
31.           print("flutter onConnected: $message");
32.           return Future(() => null);
33.         },
34.       );
35.     } on PlatformException {
36.       platformVersion = 'Failed to get platform version.';
37.       print(platformVersion);
38.     }
39.     jPush.isNotificationEnabled().then((bool value) {
40.       print("通知授权是否打开: $value");
41.       if (!value) {
42.         Get.snackbar(
43.           "提示",
44.           "没有通知权限,点击跳转打开通知设置界面",
45.           duration: const Duration(seconds: 6),
46.           onTap: (_) {
47.             jPush.openSettingsForNotification();
48.           },
49.         );
50.       }
51.     }).catchError((onError) {
52.       print("通知授权是否打开: ${onError.toString()}");
53.     });
55.     jPush.enableAutoWakeup(enable: true);
56.     jPush.setup(
57.       appKey: '7f684a39ff1f95ef1657acdd',
58.       production: true,
59.       debug: true,
60.     );
61.     jPush.applyPushAuthority(
62.       const NotificationSettingsIOS(
63.         sound: true,
64.         alert: true,
65.         badge: true,
66.       ),
67.     );
68.     final rid = await jPush.getRegistrationID();
69.     print("flutter getRegistrationID: $rid");
70.   }
72.   setAlias(String aliasStr) {
73.     final alias = jPush.setAlias(aliasStr);
74.     print("Alias is $alias");
75.   }
76. }

复制代码

main.dart

1. import 'package:demonstration_project/jPushUtil.dart';
2. import 'package:flutter/material.dart';
3. import 'package:get/get.dart';
5. void main() {
6.   runApp(const MyApp());
7. }
9. class MyApp extends StatelessWidget {
10.   const MyApp({super.key});
12.   // This widget is the root of your application.
13.   @override
14.   Widget build(BuildContext context) {
15.     return GetMaterialApp(
16.       title: 'Flutter 极光推送',
17.       home: HomePage(),
18.     );
19.   }
20. }
22. class HomePage extends StatefulWidget {
23.   @override
24.   State<HomePage> createState() => _HomePageState();
25. }
27. class _HomePageState extends State<HomePage> {
28.   @override
29.   void initState() {
30.     JPushUtil().initPlatformState();
31.     super.initState();
32.   }
34.   @override
35.   Widget build(BuildContext context) {
36.     return const Scaffold(
37.       body: Center(
38.         child: Text("极光推送配置"),
39.       ),
40.     );
41.   }
42. }

复制代码

运行项目

运行项目在Android端，有getRegistrationID,则注册成功

测试接收推送之前，先打开接收关照的权限

在极光平台检测集成

推送消息

平台推送

直接在平台客户端输入对应的数值来推送消息

注：当APP被杀死后，极光通道的推送就不能实时收到了，以是要配置厂商通道
推送API

通过接口调用推送
厂商通道（华为）

创建项目 创建应用

应用服务 - PUSH

继承

选择中国

开通推送服务

添加应用

输入干系信息

下载agconnect-services.json

放到应用级目录下

SHA256证书指纹

天生签名jks

天生签名文件的参考文档链接

创建新的Key

天生签名证书指纹

** keytool -list -v -keystore ./demostration_project_key.jks**

配置SHA256证书指纹

项目配置

若出现以下报错

修改Manifest.xml文件

修改android/build.gradle文件

1. buildscript {
2.     ext.kotlin_version = '1.9.0'
3.     repositories {
4.         google()
5.         mavenCentral()
6.         // 配置HMS Core SDK的Maven仓地址。
7.         maven { url 'https://developer.huawei.com/repo/' }
8.     }
10.     dependencies {
11.         classpath 'com.android.tools.build:gradle:7.1.3'
12.         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
13.         classpath 'com.huawei.agconnect:agcp:1.6.0.300'
14.     }
15. }
16. allprojects {
17.     repositories {
18.         google()
19.         mavenCentral()
20.         maven { url 'https://developer.huawei.com/repo/' }
21.     }
22. }

复制代码

若出现以下报错

那说明漏了配置AGC插件，参考干系链接

接着添加依靠

1. dependencies {
2.     // 极光推送  'cn.jiguang.sdk:jpush:5.2.3' 和 'cn.jiguang.sdk.plugin:huawei:5.2.3' 版本需一致
3.     implementation 'cn.jiguang.sdk:jpush:5.2.3'
4.     implementation 'com.huawei.agconnect:agconnect-core:1.8.1.300'
5.     implementation 'com.huawei.hms:push:6.12.0.300'
6.     implementation 'cn.jiguang.sdk.plugin:huawei:5.2.3' // 这里版本一定要和极光插件版本一致！！！
7. }

复制代码

最后配置签名文件，若出现以下错误，就代表没有配置签名

1.     signingConfigs {
2.         debug {
3.             //keystore中key的别名
4.             keyAlias 'demo_key'
5.             //keystore中key的密码
6.             keyPassword '123456'
7.             //keystore的文件路径，可以是绝对路径也可以是相对路径
8.             storeFile file('../demostration_project_key.jks')
9.             //keystore的密码l
10.             storePassword '123456'
11.         }
12.     }

复制代码

最后在极光平台厂商通道配置设置App ID 和App Secret，并启用

华为平台配置

回执配置参考链接

这里的自分类是华为控制滥发消息的，需要设置一下，参考链接

选一个要发的场景

填写信息，和场景干系的信息

激活功能

找一台华为手机来运行项目

若出现以下这句，就代表配置成功了

这里的检测会有延迟，真机测试能离线收到消息就ok

错误集锦

1、版本不同等

1、极光厂商插件版本和JPush版本不同等，即便输出huawei token，也是收不到离线消息的

1.     // 极光推送  'cn.jiguang.sdk:jpush:5.2.3' 和 'cn.jiguang.sdk.plugin:huawei:5.2.3' 版本需一致
2.     implementation 'cn.jiguang.sdk:jpush:5.2.3'
3.     // 华为
4.     implementation 'com.huawei.agconnect:agconnect-core:1.8.1.300'
5.     implementation 'com.huawei.hms:push:6.12.0.300'
6.     implementation 'cn.jiguang.sdk.plugin:huawei:5.2.3'

复制代码

2、权限

网络权限记得加上

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

复制代码

Ios

官方配置参考链接
Push

Podfile

1.   pod 'JPush'
2.   pod 'JOperate'
3.   pod 'JCore'

复制代码

终端 pod install

Token Authentication配置

developer.apple.com

后续步调直接参考上面的链接，很具体
最后获取到的

运行项目

配置完成
推送API

推送API参考文档
鉴权方式

用冒号拼接appkey和masterSecret，并用base64加密该字符串，终极再拼上"Basic "

1.     final content = utf8.encode("$appKey:$masterSecret");
2.     String base64AuthString = "Basic ${base64Encode(content)}";

复制代码

测试代码

1. import 'dart:convert';
2. import 'dart:io';
4. import 'package:dio/dio.dart';
5. import 'package:flutter/material.dart';
7. void main() {
8.   runApp(const MyApp());
9. }
11. class MyApp extends StatelessWidget {
12.   const MyApp({super.key});
14.   @override
15.   Widget build(BuildContext context) {
16.     return MaterialApp(
17.       title: '推送',
18.       theme: ThemeData(
19.         colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
20.         useMaterial3: true,
21.       ),
22.       home: const MyHomePage(title: '信息推送'),
23.     );
24.   }
25. }
27. class MyHomePage extends StatefulWidget {
28.   const MyHomePage({super.key, required this.title});
30.   final String title;
32.   @override
33.   State<MyHomePage> createState() => _MyHomePageState();
34. }
36. class _MyHomePageState extends State<MyHomePage> {
37.   final String appKey = "XXX";
38.   final String masterSecret = "XXX";
39.   late String base64AuthString;
40.   final Dio dio = Dio();
42.   late String notificationAlert;
43.   late String notificationTitle;
44.   late String notificationAudienceAlias;
46.   @override
47.   void initState() {
48.     final content = utf8.encode("$appKey:$masterSecret");
49.     base64AuthString = "Basic ${base64Encode(content)}";
50.     super.initState();
51.   }
53.   @override
54.   Widget build(BuildContext context) {
55.     return Scaffold(
56.       appBar: AppBar(
57.         backgroundColor: Theme.of(context).colorScheme.inversePrimary,
58.         title: Text(widget.title),
59.       ),
60.       body: Center(
61.         child: Padding(
62.           padding: const EdgeInsets.all(8.0),
63.           child: ListView(
64.             children: [
65.               TextField(
66.                 decoration: const InputDecoration(
67.                   labelText: "主标题",
68.                   hintText: "请输入...",
69.                 ),
70.                 onChanged: (s) {
71.                   notificationAlert = s;
72.                 },
73.               ),
74.               TextField(
75.                 decoration: const InputDecoration(
76.                   labelText: "副标题",
77.                   hintText: "请输入...",
78.                 ),
79.                 onChanged: (s) {
80.                   notificationTitle = s;
81.                 },
82.               ),
83.               TextField(
84.                 decoration: const InputDecoration(
85.                   labelText: "别名",
86.                   hintText: "请输入...",
87.                 ),
88.                 onChanged: (s) {
89.                   notificationAudienceAlias = s;
90.                 },
91.               ),
92.               Padding(
93.                 padding: const EdgeInsets.all(8.0),
94.                 child: ElevatedButton(
95.                   onPressed: () {
96.                     showDialog(
97.                         context: context,
98.                         builder: (context) {
99.                           return SimpleDialog(
100.                             title: const Text("确定发送？"),
101.                             children: [
102.                               SimpleDialogOption(
103.                                 child: const Text("确定"),
104.                                 onPressed: () {
105.                                   pushMessage(
106.                                     notificationAlert: notificationAlert,
107.                                     notificationTitle: notificationTitle,
108.                                     notificationAudienceAlias: [
109.                                       notificationAudienceAlias
110.                                     ],
111.                                   );
112.                                   Navigator.of(context).pop();
113.                                 },
114.                               ),
115.                               SimpleDialogOption(
116.                                 child: const Text("取消"),
117.                                 onPressed: () {
118.                                   Navigator.of(context).pop();
119.                                 },
120.                               )
121.                             ],
122.                           );
123.                         });
124.                   },
125.                   child: const Text("推送消息"),
126.                 ),
127.               ),
128.             ],
129.           ),
130.         ),
131.       ),
132.     );
133.   }
135.   /// 推送
136.   pushMessage({
137.     required String notificationAlert,
138.     required String notificationTitle,
139.     required List<String> notificationAudienceAlias,
140.   }) async {
141.     const String url = "https://api.jpush.cn/v3/push";
142.     var data = json.encode({
143.       "platform": ["android", "ios"],
144.       "inapp_message": {"inapp_message": false},
145.       "options": {
146.         "classification": 0,
147.         "time_to_live": 86400,
148.         "apns_production": false,
149.         "third_party_channel": {
150.           "huawei": {
151.             "skip_quota": false,
152.             "distribution": "secondary_push",
153.             "channel_id": "",
154.             "category": "DEVICE_REMINDER",
155.             "receipt_id": ""
156.           }
157.         }
158.       },
159.       "notification": {
160.         "alert": notificationAlert,
161.         "android": {
162.           "alert": notificationAlert,
163.           "title": notificationTitle,
164.           "intent": {"url": "intent:#Intent;action=android.intent.action.MAIN;end"},
165.           "sound": "",
166.           "priority": 0,
167.           "category": "",
168.           "alert_type": 7,
169.           "style": 0,
170.           "builder_id": 0,
171.           "large_icon": "",
172.           "badge_add_num": 1,
173.           "extras": {
174.             "param": "123"
175.           }
176.         },
177.         "ios": {
178.           "alert": {
179.             "title": notificationAlert,
180.             "body": notificationTitle,
181.           },
182.           "content-available": 0,
183.           "mutable-content": 1,
184.           "sound": "default",
185.           "badge": "+1",
186.           "thread-id": "",
187.           "interruption-level": "active",
188.           "filter-criteria": "",
189.           "extras": {
190.             "参数": "A"
191.           }
192.         }
193.       },
194.       "audience": {
195.         "alias": notificationAudienceAlias,
196.       }
197.     });
198.     final response = await dio.request(
199.       url,
200.       data: data,
201.       options: Options(
202.         headers: {
203.           HttpHeaders.authorizationHeader: base64AuthString,
204.         },
205.         method: "POST",
206.       ),
207.     );
208.     print(response.data.toString());
209.   }
210. }

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。