手机APP消息提醒功能是APP开发得一个重要功能,它主要能做到及时提醒用户一些重要且需要及时处理的信息。目前比较常用的是极光推送,而且如果只是简单的消息推送的话,是免费的,无限制的推送。当然还有其他推送接口,例如:阿里云推送。。。。。但是个人推荐使用极光推送,它无论是到达率还是及时性都是比较高的。
那么如何将极光推送集成到Android项目中呢?网上大神们都给了许多例子,个人认为不是他们说的不好,只是有些细节过程大多都省略了,按照他们的方式来一步步操作会发现,没有什么卵用。所以最好的例子就是官网给的例子了,只要根据官网给的例子就基本没啥问题了。
首先我们要注册一个极光账号,自己注册就行了。注册完后让我们登录极光平台:极光:https://www.jiguang.cn
点击进入,然后我们要创建一个应用:
填写项目名称,和上传图片,注意这个图片是推送消息的时候会带上的图标。
提交后,找到推送设置,点击进入,填写包名,特别注意:包名一定要和你的项目名称一样
包名下面有一个下载推送demo,这个其实是一个apk安装包,也就是下载后手机可以直接安装,打开后通过极光平台创建推送的方式可以直接测试消息推送。其实这个老版本是一个实现消息推送的一个demo工程,直接打开稍作修改就可以直接用的。不知道怎末回事,现在变成了一个测试安装包了。
不过没关系,我们对着官方文档自己干就行了。
首先我们要新建一个工程:
工程建好后,登录极光官网,查看官方文档,找到Android SDK集成指南:
你要先下载一下,Android SDK:
下载后,得到一个文件夹,找到libs文件夹下:
在main下面新建一个文件夹名为 jniLibs,然后把1拷贝到该文件夹下, 选中2中的jar包右击找到addlibrary,点击就将jar包应用到工程中了:
找到工程中的libs文件夹,然后将2拷贝到该文件夹下面:
然后就开始进行极光推送的配置了,让我们看一下配置文档:
将下面的AndroidManifest里面的东西全部拷贝到你的工程中去:特别注意:绿圈的两个必须要加上,不然推送不成功。
拷贝到工程中后,把”你的应用包名“都改成自己工程里面额应用包名,同时这个应用包名也是你在极光平台上创建的应用的包名。这两个包名一定要一样。:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:versionCode="316" android:versionName="3.1.6" package="com.example.demojiguang"> <uses-sdk android:minSdkVersion="16" android:targetSdkVersion="30" tools:ignore="GradleOverrides" /> <!-- Required --> <permission android:name="com.example.demojiguang.permission.JPUSH_MESSAGE" android:protectionLevel="signature" /> <!-- Required --> <uses-permission android:name="com.example.demojiguang.permission.JPUSH_MESSAGE" /> <uses-permission android:name="android.permission.RECEIVE_USER_PRESENT" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" tools:ignore="ProtectedPermissions" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- Optional. Required for location feature --> <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <!-- 用于开启 debug 版本的应用在 6.0 系统上的层叠窗口权限 --> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <uses-permission android:name="android.permission.GET_TASKS" /> <uses-permission android:name="android.permission.VIBRATE" /> <application android:allowBackup="true" android:name=".App" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:roundIcon="@mipmap/ic_launcher_round" android:supportsRtl="true" android:theme="@style/Theme.Demojiguang"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <!-- Required SDK 核心功能--> <!-- 可配置 android:process 参数将 PushService 放在其他进程中 --> <service android:name="cn.jpush.android.service.PushService" android:enabled="true" android:exported="false" > <intent-filter> <action android:name="cn.jpush.android.intent.REGISTER" /> <action android:name="cn.jpush.android.intent.REPORT" /> <action android:name="cn.jpush.android.intent.PushService" /> <action android:name="cn.jpush.android.intent.PUSH_TIME" /> </intent-filter> </service> <!-- since 3.0.9 Required SDK 核心功能--> <provider android:authorities="com.example.demojiguang.DataProvider" android:name="cn.jpush.android.service.DataProvider" android:exported="true" /> <!-- since 1.8.0 option 可选项。用于同一设备中不同应用的 JPush 服务相互拉起的功能。 --> <!-- 若不启用该功能可删除该组件,或把 enabled 设置成 false ;App 不会被其他 App 拉起,但会拉起其他的 App。 --> <service android:name="cn.jpush.android.service.DaemonService" android:enabled="true" android:exported="true"> <intent-filter > <action android:name="cn.jpush.android.intent.DaemonService" /> <category android:name="com.example.demojiguang"/> </intent-filter> </service> <!-- since 3.1.0 Required SDK 核心功能--> <provider android:authorities="com.example.demojiguang.DownloadProvider" android:name="cn.jpush.android.service.DownloadProvider" android:exported="true" /> <!-- Required SDK 核心功能--> <receiver android:name="cn.jpush.android.service.PushReceiver" android:enabled="true" > <intent-filter android:priority="1000"> <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" /> <category android:name="com.example.demojiguang"/> </intent-filter> <intent-filter> <action android:name="android.intent.action.USER_PRESENT" /> <action android:name="android.net.conn.CONNECTIVITY_CHANGE" /> </intent-filter> <!-- Optional --> <intent-filter> <action android:name="android.intent.action.PACKAGE_ADDED" /> <action android:name="android.intent.action.PACKAGE_REMOVED" /> <data android:scheme="package" /> </intent-filter> </receiver> <!-- Required SDK 核心功能--> <activity android:name="cn.jpush.android.ui.PushActivity" android:configChanges="orientation|keyboardHidden" android:theme="@android:style/Theme.NoTitleBar" android:exported="false" > <intent-filter> <action android:name="cn.jpush.android.ui.PushActivity" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="com.example.demojiguang" /> </intent-filter> </activity> <!-- SDK 核心功能--> <activity android:name="cn.jpush.android.ui.PopWinActivity" android:configChanges="orientation|keyboardHidden" android:exported="false" android:theme="@style/MyDialogStyle"> <intent-filter> <category android:name="android.intent.category.DEFAULT" /> <category android:name="com.example.demojiguang" /> </intent-filter> </activity> <!-- 注意此配置在 JPush 3.2.0 及以前版本是必须配置,3.2.0 以后版本已废弃此配置--> <service android:name="cn.jpush.android.service.DownloadActivity" android:enabled="true" android:exported="false" tools:ignore="Instantiatable,MissingClass"> </service> <!-- Since JCore2.0.0 Required SDK核心功能--> <!-- 可配置android:process参数将Service放在其他进程中;android:enabled属性不能是false --> <!-- 这个是自定义Service,要继承极光JCommonService,可以在更多手机平台上使得推送通道保持的更稳定 --> <service android:name=".JService" android:enabled="true" android:exported="false" android:process=":pushcore"> <intent-filter> <action android:name="cn.jiguang.user.service.action" /> </intent-filter> </service> <!-- Required SDK 核心功能--> <receiver android:name="cn.jpush.android.service.AlarmReceiver" /> <!-- Required since 3.0.7 --> <!-- 新的 tag/alias 接口结果返回需要开发者配置一个自定的广播 --> <!-- 3.3.0开始所有事件将通过该类回调 --> <!-- 该广播需要继承 JPush 提供的 JPushMessageReceiver 类, 并如下新增一个 Intent-Filter --> <receiver android:name=".Receiver" android:enabled="true" android:exported="false" > <intent-filter> <action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE" /> <category android:name="com.example.demojiguang" /> </intent-filter> </receiver> <!-- User defined. 用户自定义的广播接收器--> <!-- 这是3.3.0之前版本的接收方式,3.3.0开始是通过继承 JPushMessageReceiver并配置来接收所有事件回调。--> <!--如-果仍然需要在这个Receiver里接收,需要在JPushMessageReceiver 的子类里不重写对应的回调方法,或者重写方法且调用super--> <receiver android:name=".MyReceiver" android:enabled="true" android:exported="false"> <intent-filter> <!--Required 用户注册 SDK 的 intent--> <action android:name="cn.jpush.android.intent.REGISTRATION" /> <!--Required 用户接收 SDK 消息的 intent--> <action android:name="cn.jpush.android.intent.MESSAGE_RECEIVED" /> <!--Required 用户接收 SDK 通知栏信息的 intent--> <action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED" /> <!--Required 用户打开自定义通知栏的 intent--> <action android:name="cn.jpush.android.intent.NOTIFICATION_OPENED" /> <!-- 接收网络变化 连接/断开 since 1.6.3 --> <action android:name="cn.jpush.android.intent.CONNECTION" /> <category android:name="com.example.demojiguang" /> </intent-filter> </receiver> <!-- User defined. 用户自定义 Receiver 接收被拉起回调--> <!-- 自定义 Receiver 组件,继承cn.jpush.android.service.MyWakedResultReceiver类,复写onWake(int wakeType)或 onWake(Context context, int wakeType)方法以监听被拉起 --> <receiver android:name=".MyWakedResultReceiver"> <intent-filter> <action android:name="cn.jpush.android.intent.WakedReceiver" /> <category android:name="${applicationId}" /> </intent-filter> </receiver> <!--Required SDK核心功能 since 3.3.0--> <activity android:name="cn.jpush.android.service.JNotifyActivity" android:exported="true" android:taskAffinity="jpush.custom" android:theme="@android:style/Theme.Translucent.NoTitleBar"> <intent-filter> <action android:name="cn.jpush.android.intent.JNotifyActivity" /> <category android:name="com.example.demojiguang" /> </intent-filter> </activity> <!-- Required. For publish channel feature --> <!-- JPUSH_CHANNEL 是为了方便开发者统计 APK 分发渠道。--> <!-- 例如: --> <!-- 发到 Google Play 的 APK 可以设置为 google-play; --> <!-- 发到其他市场的 APK 可以设置为 xxx-market。 --> <meta-data android:name="JPUSH_CHANNEL" android:value="developer-default"/> <!-- Required. AppKey copied from Portal --> <meta-data android:name="JPUSH_APPKEY" android:value="4f35d1870bb127eaa59ae13d"/> </application> </manifest>
同时还有一些自定义的推送类会报错,应为你工程离并没有建这些类,你只需要新建一个类按照官方说的集成一下就行了:
注意由于官方给的文档不知道多久没更新了,但是SDK版本可能一直在更新,所以有些类找不到,仔细发现只是类名字换了而已,自己改一下就行了。
换掉后,就不会报红了。然后把自定义类建一下,根据官方文档集成类就行了,如果只是做简单的消息推送,不需要对类方法进行实现。
import android.app.Application; import cn.jpush.android.api.JPushInterface; public class App extends Application { @Override public void onCreate() { super.onCreate(); JPushInterface.setDebugMode(true); JPushInterface.init(this); } } package com.example.demojiguang; import cn.jpush.android.service.JCommonService; public class JService extends JCommonService { } package com.example.demojiguang; import cn.jpush.android.service.JPushMessageReceiver; public class MyReceiver extends JPushMessageReceiver { } package com.example.demojiguang; import android.content.Context; import cn.jpush.android.service.WakedResultReceiver; public class MyWakedResultReceiver extends WakedResultReceiver { public void onWake(Context context, int wakeType){ } } package com.example.demojiguang; import cn.jpush.android.service.JPushMessageReceiver; public class Receiver extends JPushMessageReceiver { }
紧接着把极光平台的appkey拷贝到对应的地方,就行了。
然后在application里面添加Android:name
APP类型上面已经给出,实现推送的主要代码就是:
JPushInterface.setDebugMode(true); JPushInterface.init(this);
然后整个推送配置就完成了,下面就是推送测试了,首先先运行一下我们建的工程,启动后,我们登入极光平台,找的自己建的应用,创建一个推送:
点击下方的推送,注意目前是广推,也就是只要是登录app的客户端都能街道推送。:
点击发送预览,就能实现推送了。:
当然这个是广推,我们可以选择给特定用户去做推送:
例如利用RegistrationID,这个是什么意思呢?大致意思就是,当用户使用app登录后,系统自动会生成一个该手机的一个唯一ID,用来识别单个用户的。这就说明一个问题,极光推送同一个账号,只能推送给一个手机,比如张三登陆了a账号,消息推送给他推送了,但是如果李四接着登录a账号,李四能收到推送,而张三就不能了。
如何得到RegistrationID,官方给了方法:
String registrationID = JPushInterface.getRegistrationID(this.getApplicationContext()); Log.i("registrationID",registrationID);//打印
机关推送到这里基本实现了,至于后续要怎末自己定义一些推动方式,就看个人了。