好久没写博客了,之前项目中也集成过极光,时隔半年在集成时却发现有点找不到头绪,于是又想到了博客,此篇记录一下极光推送简单集成。
首先下载官方Damo 找到SDK
将libs下的两个jar包复制到自己项目的libs下
将.so文件复制到main包下的jniLibs下 没有jniLibs自行创建
然后就开始我们的简单集成之旅了
第一步在AndroidManifest.xml文件中添加权限
<!-- 极光 -->
<uses-sdk
android:minSdkVersion="9"
android:targetSdkVersion="21"/>
<permission
android:name="自己app的包名.permission.JPUSH_MESSAGE"
android:protectionLevel="signature"/>
<!-- Required -->
<uses-permission android:name="自己app的包名.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.WAKE_LOCK"/>
<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.VIBRATE"/>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.WRITE_SETTINGS"/>
<!-- Optional. Required for location feature -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<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"/>
添加极光推送的服务和广播以及Key
<!-- 可配置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:name="cn.jpush.android.service.DataProvider"
android:authorities="自己app的包名.DataProvider"
android:exported="true"/>
<!-- since 1.8.0 option 可选项。用于同一设备中不同应用的JPush服务相互拉起的功能。 -->
<!-- 若不启用该功能可删除该组件,将不拉起其他应用也不能被其他应用拉起 -->
<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="自己app的包名"/>
</intent-filter>
</service>
<!-- 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="自己app的包名"/>
</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:exported="false"
android:theme="@android:style/Theme.NoTitleBar">
<intent-filter>
<action android:name="cn.jpush.android.ui.PushActivity"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="自己app的包名"/>
</intent-filter>
</activity>
<!-- Required SDK核心功能-->
<receiver android:name="cn.jpush.android.service.AlarmReceiver"/>
<!-- Required since 3.0.7 -->
<!-- 新的tag/alias接口结果返回需要开发者配置一个自定的广播 -->
<!-- 该广播需要继承JPush提供的JPushMessageReceiver类, 并如下新增一个 Intent-Filter -->
<receiver
android:name=".JPushMessage" <!-- 极光推送管理所用 -->
android:enabled="true">
<intent-filter>
<action android:name="cn.jpush.android.intent.RECEIVE_MESSAGE"/>
<category android:name="自己app的包名"/>
</intent-filter>
</receiver>
<!-- User defined. 用户自定义的广播接收器-->
<receiver
android:name=".JPushReceiver" <!-- 自己定义的广播接收器用来做相应操作 -->
android:enabled="true">
<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="自己app的包名"/>
</intent-filter>
</receiver>
<meta-data
android:name="JPUSH_CHANNEL"
android:value="developer-default"/>
<!-- 设置 AppKey -->
<meta-data
android:name="JPUSH_APPKEY"
android:value="c101e99fb2******5e90cf9be"/> <!-- 自己在极光上申请的key -->
创建JPushMessage 和JPushReceiver 类并在Application中初始化
这里我用的标签形式直接用唯一标识在极光注册,这样可以通过后台已有的唯一标识进行推送。也可以让后台集成获取极光id,发送给后台,让后台处理和极光的关系并记录返回结果。
Application类
/**
* 作者:CoolTone
* 描述:Application
*/
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
JPushInterface.setDebugMode(false);
JPushInterface.init(this);
L.e("--极光ID--" + JPushInterface.getRegistrationID(this));
JPushInterface.setAlias(this, getDeviceNo(), new TagAliasCallback() {
@Override
public void gotResult(int i, String s, Set<String> set) {
L.e("--极光注册--" + JPushInterface.getRegistrationID(App.this) + "---" + i + "---" + s);
}
});
}
public String getDeviceNo() {
return Settings.Secure.getString(getContentResolver(), Settings.Secure.ANDROID_ID);
}
}
JPushMessage类
/**
* 作者:CoolTone
* 描述:极光推送JPushMessageReceiver
*/
public class JPushMessage extends JPushMessageReceiver {
private static final String TAG = "MyJPushMessageReceiver";
/**
* tag增删查改的操作会在此方法中回调结果
*/
@Override
public void onTagOperatorResult(Context context, cn.jpush.android.api.JPushMessage jPushMessage) {
super.onTagOperatorResult(context, jPushMessage);
Log.e(TAG, "onTagOperatorResult查询得到的别名: " + jPushMessage.getAlias());
Log.e(TAG, "onTagOperatorResult查询得到的标签: " + jPushMessage.getTags());
Log.e(TAG, "onTagOperatorResult错误码 0为成功: " + jPushMessage.getErrorCode());
Log.e(TAG, "onTagOperatorResult传入的标示: " + jPushMessage.getSequence());
}
/**
* 查询某个tag与当前用户的绑定状态的操作会在此方法中回调结果
*/
@Override
public void onCheckTagOperatorResult(Context context, cn.jpush.android.api.JPushMessage jPushMessage) {
super.onCheckTagOperatorResult(context, jPushMessage);
Log.e(TAG, "onCheckTagOperatorResult错误码 0为成功: " + jPushMessage.getErrorCode());
}
/**
* alias相关的操作会在此方法中回调结果
*/
@Override
public void onAliasOperatorResult(Context context, cn.jpush.android.api.JPushMessage jPushMessage) {
super.onAliasOperatorResult(context, jPushMessage);
Log.e(TAG, "onAliasOperatorResult错误码 0为成功: " + jPushMessage.getErrorCode());
}
}
JPushReceiver类
/**
* 作者:CoolTone
* 描述:自定义广播 处理广播
*/
public class JPushReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Bundle bundle = intent.getExtras();// 获取其他的推送信息
if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
String regId = bundle.getString(JPushInterface.EXTRA_REGISTRATION_ID);
L.e("JPush用户注册成功id: " + regId);
} else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
// 自定义消息不会展示在通知栏,完全要开发者写代码去处理
L.e("接受到推送下来的自定义消息id: " + bundle.getString(JPushInterface.EXTRA_MESSAGE));
} else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
// 在里可以做些统计,或者做些其他工作
int notifactionId = bundle.getInt(JPushInterface.EXTRA_NOTIFICATION_ID);
L.e("接受到推送下来的通知id: " + notifactionId);
} else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
// 在这里可以自己写代码去定义用户点击后的行为
L.e("用户点击打开了通知");
} else {
L.e("Unhandled intent :" + intent.getAction());
}
}
}
这样就简单集成了极光推送!