仅需三步即可集成极光推送--指南

2024-05-07 11:38
文章标签 即可 推送 指南 集成 三步 极光

本文主要是介绍仅需三步即可集成极光推送--指南，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

本文就极光推送集成做了一个简化，仅需三步就可以快速集成极光推送。不用去看繁琐的极光推送的说明文档，仅仅看本文的说明步骤，三步即可集成极光推送功能。

  

1 仅需三步集成

  

第一步：配置build.gradle

在项目的app的主工程的build.gradle文件中添加如下内容：

android {compileSdkVersion 28defaultConfig {applicationId "Your App Id"...........ndk {abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64', 'mips', 'mips64'}manifestPlaceholders = [JPUSH_PKGNAME : defaultConfig.applicationId,JPUSH_APPKEY : "Your Key", //JPush 上注册的包名对应的 Appkey.JPUSH_CHANNEL : "developer-default", //暂时填写默认值即可.]}
}dependencies {implementation fileTree(dir: 'libs', include: ['*.jar'])..........implementation project(':jpushlib')
}

  

第二步：引入jpushlib模块

引入jpushlib module即可
jpushlib module下载地址：请点击这里

  

第三步：添加两行代码
class JGApplication: Application() {private val TAG = "JGApplication"override fun onCreate() {super.onCreate()JPushHelper.setJPushListener(absJPushListener)	//这一行代码设置Jpush回调监听JPushHelper.init(this, BuildConfig.DEBUG)		// 这一行代码初始化Jpush}// 重写抽象类AbstractJPushListener的相关方法即可，按需重载方法即可private val absJPushListener = object : AbstractJPushListener() {override fun onNotificationSettingsCheck(context: Context?, isOn: Boolean, i: Int) {super.onNotificationSettingsCheck(context, isOn, i)Log.i(TAG, "手机APP通知开关的回调-》  isOn:$isOn, i:$i")}override fun onConnected(context: Context?, b: Boolean) {super.onConnected(context, b)Log.i(TAG, "长连接状态回调:$b")}}
}

这一步仅需在application类的onCreate方法中设置JPushHelper类的初始化工作。
以上两行代码即可。

这两行代码顺序不要变动。先设置监听回调接口，再初始化即可通过监听获取回调状态通知。当然监听回调非必须的，可不设置或设置为空。

通过以上三步即可完成极光推送的集成。

  

2 检验集成是否成功

经过上面三步集成指南之后，启动APP，查看日志：
在这里插入图片描述
如果日志显示这样的状态，即表明JPush集成成功，并且长连接已经建立，可接收发送的推送通知

  

3 Demo效果

 
经过上面三步的操作之后，即可调用JPushHelper类的相关方法设置JPush推送相关的方法。

以上三步的集成效果，我做了一个Demo，具体地址： 请点击这里

Demo效果如下：
在这里插入图片描述
  
在这里插入图片描述
UI界面中使用到的方法均是JPushHelper类提供的方法，直接使用即可。

点击按钮，日志打印如下：
在这里插入图片描述
用户别名API日志：
在这里插入图片描述
用户标签API日志：
在这里插入图片描述
 

4 jpushlib模块JPushHelper类说明

 
该类是jpushlib模块的核心，是app中使用极光推送库的桥梁，通过该类即可设置极光推送的所有相关方法。

具体该类提供的方法接口如下：

//初始化
public static void init(Context context, boolean isDebug)
//清理
public static void cleanJPushListener()// ===========================================极光推送API
//停止推送
public static void stopPush()
//恢复推送服务
public static void resumePush()
//用来检查 Push Service 是否已经被停止
public static boolean isPushStoped()
// 获取当前连接状态
public static boolean getConnectionState()
//动态配置 channel，优先级比 AndroidManifest 里配置的高
public static void setChannel(String channel)
//允许推送的开始时间与结束时间
public static void setPushTime(Set<Integer> weekDays, int startHour, int endHour)
//调用此 API 来设置静音时段。如果在该时间段内收到消息，则：不会有铃声和震动
public static void setSilenceTime(int startHour, int startMinute,int endHour, int endMinute)
//在 Android 6.0 及以上的系统上，需要去请求一些用到的权限，
//JPush SDK 用到的一些需要请求如下权限
public static void requestPermission(Activity activity)
//JPush SDK 开启和关闭省电模式，默认为关闭
public static void setPowerSaveMode(Activity activity, boolean enable)
//调用此 API 设置手机号码
public static void setMobileNumber(int sequence, String mobileNumber)
//调用此 API 来取得应用程序对应的 RegistrationID。
public static String getRegistrationID()// ===========================================别名相关API
//调用此 API 来设置别名。
public static void setAlias(int sequence, String alias)
//调用此 API 来删除别名。
public static void deleteAlias(int sequence) 
//调用此 API 来查询别名
public static void getAlias(int sequence)// ===========================================标签相关API
//设置 tags 时，如果其中一个 tag 无效，则整个设置过程失败,可过滤无效的tag
public static Set<String> filterValidTags(Set<String> tags)
//调用此 API 来设置标签 
//需要理解的是，这个接口是覆盖逻辑，而不是增量逻辑。即新的调用会覆盖之前的设置
public static void setTags(int sequence, Set<String> tags)
//调用此 API 来新增标签
public static void addTags(int sequence, Set<String> tags)
//调用此 API 来删除指定标签
public static void deleteTags(int sequence, Set<String> tags)
//调用此 API 来清除所有标签
public static void cleanTags(int sequence)
//调用此 API 来查询所有标签
public static void getAllTags(int sequence) 
//调用此 API 来查询指定 tag 与当前用户绑定的状态
public static void checkTagBindState(int sequence, String tag)// ===========================================通知相关API
//此 API 提供清除通知的功能，包括：清除所有 JPush 展现的通知（不包括非 JPush SDK 展现的）
public static void clearAllNotifications()
//清除指定某个通知
public static void clearNotificationById(int notificationId)
//当用户需要定制默认的通知栏样式时，则可调用此方法
public static void setDefaultPushNotificationBuilder(DefaultPushNotificationBuilder builder)
//当开发者需要为不同的通知，指定不同的通知栏样式（行为）时，则需要调用此方法设置多个通知栏构建类
public static void setPushNotificationBuilder(Integer notificationBuilderId,BasicPushNotificationBuilder builder)
//限制保留的通知条数。默认为保留最近 5 条通知
public static void setLatestNotificationNumber(int maxNum)// ===========================================崩溃API
//关闭 CrashLog 上报
public static void stopCrashHandler()
//开启 CrashLog 上报
public static void initCrashHandler()// ===========================================本地通知API
//本地通知 API 不依赖于网络，无网条件下依旧可以触发
public static void addLocalNotification(JPushLocalNotification notification)
//移除指定的本地通知
public static void removeLocalNotification(long notificationId)
//移除所有的本地通知，注意notificationId为0或者负数时通知无法移除
public static void clearLocalNotifications()// ===========================================地理围栏功能API
//设置地理围栏监控周期，最小3分钟，最大1天。默认为15分钟，
public static void setGeofenceInterval(long interval) 
//设置最多允许保存的地理围栏数量，超过最大限制后，
//如果继续创建先删除最早创建的地理围栏。默认数量为10个，允许设置最小1个，最大100个。
public static void setMaxGeofenceNumber(int maxNumber)
//删除指定id的地理围栏
public static void deleteGeofence(String geofenceid)//设置角标数字(目前仅支持华为手机)
public static void setBadgeNumber(int num)// ===========================================手机APP通知开关API
//检查当前应用的通知开关是否开启
//返回结果：1表示开启，0表示关闭，-1表示检测失败
public static int isNotificationEnabled()
//跳转手机的应用通知设置页，可由用户操作开启通知开关
public static void goToAppNotificationSettings() // ===========================================统计分析API
public static void onResume(final Activity activity) 
public static void onPause(final Activity activity)// ===========================================设置监听器
public static void setJPushListener(AbstractJPushListener listener)
public static void cleanJPushListener()

以上JPushHelper接口完全可以满足开发者引入极光推送的全部功能。无需再去看Jpush极光推送的文档，仅仅引入我这里提供的jpushlib模块即可。

 

5 jpushlib模块AbstractJPushListener类回调监听说明

 

public abstract class AbstractJPushListener {public Notification getNotification(Context context,NotificationMessage notificationMessage,Notification notification) {return notification;}/*** 收到自定义消息回调** @param context Context* @param customMessage 接收自定义消息内容*/public void onMessage(Context context, CustomMessage customMessage) {}/*** 点击通知回调** @param context Context* @param notificationMessage 点击的通知内容*/public void onNotifyMessageOpened(Context context,NotificationMessage notificationMessage) {}/*** 收到通知回调** @param context Context* @param notificationMessage 接收到的通知内容*/public void onNotifyMessageArrived(Context context,NotificationMessage notificationMessage) {}/*** 清除通知回调** 说明:** 1.同时删除多条通知，可能不会多次触发清除通知的回调** 2.只有用户手动清除才有回调，调接口清除不会有回调** @param context Context* @param notificationMessage 清除的通知内容*/public void onNotifyMessageDismiss(Context context,NotificationMessage notificationMessage) {}/*** 注册成功回调** @param context Context* @param s  注册id*/public void onRegister(Context context, String s) {}/*** 长连接状态回调** @param context Context* @param b 长连接状态*/public void onConnected(Context context, boolean b) {}/*** 注册失败回调** @param context Context* @param cmdMessage 错误信息*/public void onCommandResult(Context context, CmdMessage cmdMessage) {}/*** 通知的MultiAction回调** @param context Context* @param intent 点击后触发的Intent**  说明 注意这个方法里面禁止再调super.onMultiActionClicked,因为会导致逻辑混乱*/public void onMultiActionClicked(Context context, Intent intent) {}/*** 通知开关的回调** 该方法会在以下情况触发时回调。** 1.sdk每次启动后都会检查通知开关状态并通过该方法回调给开发者。** 2.当sdk检查到通知状态变更时会通过该方法回调给开发者。** @param context Context* @param isOn 通知开关状态* @param i 触发场景，0为sdk启动，1为检测到通知开关状态变更*/public void onNotificationSettingsCheck(Context context, boolean isOn, int i) {}/*** tag 增删查改的操作会在此方法中回调结果** @param context Context* @param jPushMessage tag 相关操作返回的消息结果体*/public void onTagOperatorResult(Context context, JPushMessage jPushMessage) {}/*** 查询某个 tag 与当前用户的绑定状态的操作会在此方法中回调结果** @param context Context* @param jPushMessage check tag 与当前用户绑定状态的操作返回的消息结果体，* 具体参考 JPushMessage 类的说明*/public void onCheckTagOperatorResult(Context context, JPushMessage jPushMessage) {}/*** alias 相关的操作会在此方法中回调结果** @param context Context* @param jPushMessage alias 相关操作返回的消息结果体*/public void onAliasOperatorResult(Context context, JPushMessage jPushMessage) {}/*** 设置手机号码会在此方法中回调结果** @param context Context* @param jPushMessage 设置手机号码返回的消息结果体*/public void onMobileNumberOperatorResult(Context context, JPushMessage jPushMessage) {}/*** 应用被拉起时回调 onWake(Context context, int wakeType) 方法，* context 是上下文，wakeType 是拉起的类型，其取值对应的拉起方式如下：* wakeType值	拉起方式* 1	START_SERVICE* 2	BIND_SERVICE* 4	CONTENTPROVIDER*/public void onWake(Context context, int wakeType) {}
}

该类是一个抽象类，在文章开始位置，重写了其部分方法，通过回调监听部分方法，按需要重载其方法即可。

 

6 源码下载

源代码地址，请点击这里

欢迎关注公众号：技术印象

这篇关于仅需三步即可集成极光推送--指南的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/967246。

相关文章

Apache Ignite 与 Spring Boot 集成详细指南

Apache Ignite 与 Spring Boot 集成详细指南

《ApacheIgnite与SpringBoot集成详细指南》ApacheIgnite官方指南详解如何通过SpringBootStarter扩展实现自动配置,支持厚/轻客户端模式,简化Ign... 目录 一、背景：为什么需要这个集成？ 二、两种集成方式（对应两种客户端模型） 三、方式一：自动配置 Thick
阅读更多...
SQL Server跟踪自动统计信息更新实战指南

SQL Server跟踪自动统计信息更新实战指南

《SQLServer跟踪自动统计信息更新实战指南》本文详解SQLServer自动统计信息更新的跟踪方法,推荐使用扩展事件实时捕获更新操作及详细信息,同时结合系统视图快速检查统计信息状态,重点强调修... 目录SQL Server 如何跟踪自动统计信息更新：深入解析与实战指南 核心跟踪方法1️⃣ 利用系统目录
阅读更多...
使用IDEA部署Docker应用指南分享

使用IDEA部署Docker应用指南分享

《使用IDEA部署Docker应用指南分享》本文介绍了使用IDEA部署Docker应用的四步流程：创建Dockerfile、配置IDEADocker连接、设置运行调试环境、构建运行镜像,并强调需准备本... 目录一、创建 dockerfile 配置文件二、配置 IDEA 的 Docker 连接三、配置 Do
阅读更多...
Python进行JSON和Excel文件转换处理指南

Python进行JSON和Excel文件转换处理指南

《Python进行JSON和Excel文件转换处理指南》在数据交换与系统集成中,JSON与Excel是两种极为常见的数据格式,本文将介绍如何使用Python实现将JSON转换为格式化的Excel文件,... 目录将 jsON 导入为格式化 Excel将 Excel 导出为结构化 JSON处理嵌套 JSON：
阅读更多...
深入浅出SpringBoot WebSocket构建实时应用全面指南

深入浅出SpringBoot WebSocket构建实时应用全面指南

《深入浅出SpringBootWebSocket构建实时应用全面指南》WebSocket是一种在单个TCP连接上进行全双工通信的协议,这篇文章主要为大家详细介绍了SpringBoot如何集成WebS... 目录前言为什么需要 WebSocketWebSocket 是什么Spring Boot 如何简化 We
阅读更多...
Python极速搭建局域网文件共享服务器完整指南

Python极速搭建局域网文件共享服务器完整指南

《Python极速搭建局域网文件共享服务器完整指南》在办公室或家庭局域网中快速共享文件时,许多人会选择第三方工具或云存储服务,但这些方案往往存在隐私泄露风险或需要复杂配置,下面我们就来看看如何使用Py... 目录一、android基础版：HTTP文件共享的魔法命令1. 一行代码启动HTTP服务器2. 关键参
阅读更多...
Python对接支付宝支付之使用AliPay实现的详细操作指南

Python对接支付宝支付之使用AliPay实现的详细操作指南

《Python对接支付宝支付之使用AliPay实现的详细操作指南》支付宝没有提供PythonSDK,但是强大的github就有提供python-alipay-sdk,封装里很多复杂操作,使用这个我们就... 目录一、引言二、准备工作2.1 支付宝开放平台入驻与应用创建2.2 密钥生成与配置2.3 安装ali
阅读更多...
Redis MCP 安装与配置指南

Redis MCP 安装与配置指南

《RedisMCP安装与配置指南》本文将详细介绍如何安装和配置RedisMCP,包括快速启动、源码安装、Docker安装、以及相关的配置参数和环境变量设置,感兴趣的朋友一起看看吧... 目录一、Redis MCP 简介二、安www.chinasem.cn装 Redis MCP 服务2.1 快速启动（推荐）2.
阅读更多...
OpenCV在Java中的完整集成指南分享

OpenCV在Java中的完整集成指南分享

《OpenCV在Java中的完整集成指南分享》本文详解了在Java中集成OpenCV的方法,涵盖jar包导入、dll配置、JNI路径设置及跨平台兼容性处理,提供了图像处理、特征检测、实时视频分析等应用... 目录1. OpenCV简介与应用领域1.1 OpenCV的诞生与发展1.2 OpenCV的应用领域2
阅读更多...
MyBatis-Plus 自动赋值实体字段最佳实践指南

MyBatis-Plus 自动赋值实体字段最佳实践指南

《MyBatis-Plus自动赋值实体字段最佳实践指南》MyBatis-Plus通过@TableField注解与填充策略,实现时间戳、用户信息、逻辑删除等字段的自动填充,减少手动赋值,提升开发效率与... 目录1. MyBATis-Plus 自动赋值概述1.1 适用场景1.2 自动填充的原理1.3 填充策略
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2