极光推送配置流程
相关文章
推送配置共三篇(如下链接) 【Flutter】极光推送配置流程(极光通道/华为厂商/IOS) 章一 【Flutter】极光推送配置流程(小米厂商通道) 章二 【Flutter】极光推送配置流程(VIVO/OPPO/荣耀厂商通道) 章三
极光通道（在线）
配置时间 2024年3月11日
创建应用
应用列表 - 创建应用 Android - 选中消息推送 - 下一步
创建Flutter项目 填写包名
创建完成
项目配置
运行命令行 flutter pub add jpush_flutter
Android -> app -> build.gradle 更改JPUSH_APPKEY的值
工具类注册JPush Android
import 'package:flutter/services.dart';
import 'package:get/get.dart';
import 'package:jpush_flutter/jpush_flutter.dart';
class JPushUtil {
JPushUtil._internal();
static final _instance = JPushUtil._internal();
factory JPushUtil() => _instance;
final JPush jPush = JPush();
Future
String? platformVersion;
try {
jPush.addEventHandler(
onReceiveNotification: (message) async {
print("flutter onReceiveNotification: $message");
},
onOpenNotification: (message) async {
print("flutter onOpenNotification: $message");
},
onReceiveMessage: (message) async {
print("flutter onReceiveMessage: $message");
},
onReceiveNotificationAuthorization: (message) async {
print("flutter onReceiveNotificationAuthorization: $message");
},
onConnected: (message) {
print("flutter onConnected: $message");
return Future(() => null);
},
);
} on PlatformException {
platformVersion = 'Failed to get platform version.';
print(platformVersion);
}
jPush.isNotificationEnabled().then((bool value) {
print("通知授权是否打开: $value");
if (!value) {
Get.snackbar(
"提示",
"没有通知权限,点击跳转打开通知设置界面",
duration: const Duration(seconds: 6),
onTap: (_) {
jPush.openSettingsForNotification();
},
);
}
}).catchError((onError) {
print("通知授权是否打开: ${onError.toString()}");
});
jPush.enableAutoWakeup(enable: true);
jPush.setup(
appKey: '7f684a39ff1f95ef1657acdd',
production: true,
debug: true,
);
jPush.applyPushAuthority(
const NotificationSettingsIOS(
sound: true,
alert: true,
badge: true,
),
);
final rid = await jPush.getRegistrationID();
print("flutter getRegistrationID: $rid");
}
setAlias(String aliasStr) {
final alias = jPush.setAlias(aliasStr);
print("Alias is $alias");
}
}
main.dart
import 'package:demonstration_project/jPushUtil.dart';
import 'package:flutter/material.dart';
import 'package:get/get.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
// This widget is the root of your application.
@override
Widget build(BuildContext context) {
return GetMaterialApp(
title: 'Flutter 极光推送',
home: HomePage(),
);
}
}
class HomePage extends StatefulWidget {
@override
State
}
class _HomePageState extends State
@override
void initState() {
JPushUtil().initPlatformState();
super.initState();
}
@override
Widget build(BuildContext context) {
return const Scaffold(
body: Center(
child: Text("极光推送配置"),
),
);
}
}
运行项目
运行项目在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文件
buildscript {
ext.kotlin_version = '1.9.0'
repositories {
google()
mavenCentral()
// 配置HMS Core SDK的Maven仓地址。
maven { url 'https://developer.huawei.com/repo/' }
}
dependencies {
classpath 'com.android.tools.build:gradle:7.1.3'
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
classpath 'com.huawei.agconnect:agcp:1.6.0.300'
}
}
allprojects {
repositories {
google()
mavenCentral()
maven { url 'https://developer.huawei.com/repo/' }
}
}
若出现以下报错 那说明漏了配置AGC插件，参考相关链接 接着添加依赖
dependencies {
// 极光推送 'cn.jiguang.sdk:jpush:5.2.3' 和 'cn.jiguang.sdk.plugin:huawei:5.2.3' 版本需一致
implementation 'cn.jiguang.sdk:jpush:5.2.3'
implementation 'com.huawei.agconnect:agconnect-core:1.8.1.300'
implementation 'com.huawei.hms:push:6.12.0.300'
implementation 'cn.jiguang.sdk.plugin:huawei:5.2.3' // 这里版本一定要和极光插件版本一致！！！
}
最后配置签名文件，若出现以下错误，就代表没有配置签名
signingConfigs {
debug {
//keystore中key的别名
keyAlias 'demo_key'
//keystore中key的密码
keyPassword '123456'
//keystore的文件路径，可以是绝对路径也可以是相对路径
storeFile file('../demostration_project_key.jks')
//keystore的密码l
storePassword '123456'
}
}
最后在极光平台厂商通道配置设置App ID 和App Secret，并启用
华为平台配置
回执配置参考链接 这里的自分类是华为控制滥发消息的，需要设置一下，参考链接 选一个要发的场景 填写信息，和场景相关的信息 激活功能
找一台华为手机来运行项目
若出现以下这句，就代表配置成功了 这里的检测会有延迟，真机测试能离线收到消息就ok
错误集锦
1、版本不一致
1、极光厂商插件版本和JPush版本不一致，即便输出huawei token，也是收不到离线消息的
// 极光推送 'cn.jiguang.sdk:jpush:5.2.3' 和 'cn.jiguang.sdk.plugin:huawei:5.2.3' 版本需一致
implementation 'cn.jiguang.sdk:jpush:5.2.3'
// 华为
implementation 'com.huawei.agconnect:agconnect-core:1.8.1.300'
implementation 'com.huawei.hms:push:6.12.0.300'
implementation 'cn.jiguang.sdk.plugin:huawei:5.2.3'
2、权限
网络权限记得加上
Ios
官方配置参考链接
Push
Podfile
pod 'JPush'
pod 'JOperate'
pod 'JCore'
终端 pod install
Token Authentication配置
developer.apple.com 后续步骤直接参考上面的链接，很详细 最后获取到的
运行项目
配置完成
推送API
推送API参考文档
鉴权方式
用冒号拼接appkey和masterSecret，并用base64加密该字符串，最终再拼上"Basic "
final content = utf8.encode("$appKey:$masterSecret");
String base64AuthString = "Basic ${base64Encode(content)}";
测试代码
import 'dart:convert';
import 'dart:io';
import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
title: '推送',
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
useMaterial3: true,
),
home: const MyHomePage(title: '信息推送'),
);
}
}
class MyHomePage extends StatefulWidget {
const MyHomePage({super.key, required this.title});
final String title;
@override
State
}
class _MyHomePageState extends State
final String appKey = "XXX";
final String masterSecret = "XXX";
late String base64AuthString;
final Dio dio = Dio();
late String notificationAlert;
late String notificationTitle;
late String notificationAudienceAlias;
@override
void initState() {
final content = utf8.encode("$appKey:$masterSecret");
base64AuthString = "Basic ${base64Encode(content)}";
super.initState();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
title: Text(widget.title),
),
body: Center(
child: Padding(
padding: const EdgeInsets.all(8.0),
child: ListView(
children: [
TextField(
decoration: const InputDecoration(
labelText: "主标题",
hintText: "请输入...",
),
onChanged: (s) {
notificationAlert = s;
},
),
TextField(
decoration: const InputDecoration(
labelText: "副标题",
hintText: "请输入...",
),
onChanged: (s) {
notificationTitle = s;
},
),
TextField(
decoration: const InputDecoration(
labelText: "别名",
hintText: "请输入...",
),
onChanged: (s) {
notificationAudienceAlias = s;
},
),
Padding(
padding: const EdgeInsets.all(8.0),
child: ElevatedButton(
onPressed: () {
showDialog(
context: context,
builder: (context) {
return SimpleDialog(
title: const Text("确定发送？"),
children: [
SimpleDialogOption(
child: const Text("确定"),
onPressed: () {
pushMessage(
notificationAlert: notificationAlert,
notificationTitle: notificationTitle,
notificationAudienceAlias: [
notificationAudienceAlias
],
);
Navigator.of(context).pop();
},
),
SimpleDialogOption(
child: const Text("取消"),
onPressed: () {
Navigator.of(context).pop();
},
)
],
);
});
},
child: const Text("推送消息"),
),
),
],
),
),
),
);
}
/// 推送
pushMessage({
required String notificationAlert,
required String notificationTitle,
required List
}) async {
const String url = "https://api.jpush.cn/v3/push";
var data = json.encode({
"platform": ["android", "ios"],
"inapp_message": {"inapp_message": false},
"options": {
"classification": 0,
"time_to_live": 86400,
"apns_production": false,
"third_party_channel": {
"huawei": {
"skip_quota": false,
"distribution": "secondary_push",
"channel_id": "",
"category": "DEVICE_REMINDER",
"receipt_id": ""
}
}
},
"notification": {
"alert": notificationAlert,
"android": {
"alert": notificationAlert,
"title": notificationTitle,
"intent": {"url": "intent:#Intent;action=android.intent.action.MAIN;end"},
"sound": "",
"priority": 0,
"category": "",
"alert_type": 7,
"style": 0,
"builder_id": 0,
"large_icon": "",
"badge_add_num": 1,
"extras": {
"param": "123"
}
},
"ios": {
"alert": {
"title": notificationAlert,
"body": notificationTitle,
},
"content-available": 0,
"mutable-content": 1,
"sound": "default",
"badge": "+1",
"thread-id": "",
"interruption-level": "active",
"filter-criteria": "",
"extras": {
"参数": "A"
}
}
},
"audience": {
"alias": notificationAudienceAlias,
}
});
final response = await dio.request(
url,
data: data,
options: Options(
headers: {
HttpHeaders.authorizationHeader: base64AuthString,
},
method: "POST",
),
);
print(response.data.toString());
}
}
相关链接
发表评论