极光推送使用实例 Android客户端

Posted 2020-08-15 Fly , Mason ! ! !

上一篇简单介绍了极光推送在Java服务端的实现，如果感兴趣的可以看一下极光推送使用实例（一）JAVA服务端。这篇文章介绍下极光推送在Android客户端的实现。 
JPush android SDK 是作为 Android Serivice 长期运行在后台的，从而创建并保持长连接，保持永远在线的能力。JPush Android SDK 由于使用自定义协议，协议体做得极致地小，流量消耗非常地小。电量方面，JPush Android SDK 经过持续地优化，尽可能减少不必要的代码执行；并且，长期的版本升级迭代，不断地调优，在保证一定的网络连接稳定性的要求小，减少电量消耗。而 Android 设备的网络的复杂性、不稳定性，是 Android 设备开发最复杂的地方之一。 
关键点： 
1.强烈建议大家上极光官网下载Android demo，里面有所需要的jar文件以及配置文件。配置正确的包名，获取项目的appKey值 
2.极光推送通过广播来实现，所以Android客户端关键就是注册广播事件 
3.建议在项目初始化Application的时候初始化JdPush(初始化过才可以进行推送服务) 
4.这里我们实现全部用户推送和个别用户推送

下载官网demo然后部署，我们会看到如下效果

下面看具体的代码，点击initPush就是初始化JdPush。在具体项目中建议这一步在Application初始化的时候实现。初始化代码其实很简单

// 初始化 JPush。如果已经初始化，但没有登录成功，则执行重新登录。
    private void init(){
         JPushInterface.init(getApplicationContext());
    }

 

广播MessageReceiver ，首先根据MESSAGE_RECEIVED_ACTION判断广播是否为当前广播，然后从广播中获取推送的内容

    public class MessageReceiver extends BroadcastReceiver {

        @Override
        public void onReceive(Context context, Intent intent) {
            if (MESSAGE_RECEIVED_ACTION.equals(intent.getAction())) {
              String messge = intent.getStringExtra(KEY_MESSAGE);
              String extras = intent.getStringExtra(KEY_EXTRAS);
              StringBuilder showMsg = new StringBuilder();
              showMsg.append(KEY_MESSAGE + " : " + messge + "\n");
              if (!ExampleUtil.isEmpty(extras)) {
                  showMsg.append(KEY_EXTRAS + " : " + extras + "\n");
              }
              setCostomMsg(showMsg.toString());
            }
        }
    }

 

注册广播的方法registerMessageReceiver，主要是registerReceiver(mMessageReceiver, filter)方法

public void registerMessageReceiver() {
        mMessageReceiver = new MessageReceiver();
        IntentFilter filter = new IntentFilter();
        filter.setPriority(IntentFilter.SYSTEM_HIGH_PRIORITY);
        filter.addAction(MESSAGE_RECEIVED_ACTION);
        registerReceiver(mMessageReceiver, filter);
    }

1

• 2
• 3
• 4
• 5
• 6
• 7

• 1
• 2
• 3
• 4
• 5
• 6
• 7

最后在onCreate方法中

public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        initView();   
        registerMessageReceiver();  // used for receive msg
    }

 

ok，只要我们点击init按钮，日志里会显示初始化成功log。然后从后台推送一条服务过来，会看到日志显示如下信息

02-07 08:35:36.235: V/JPush(693): [JPushInterface] action:getPushNotificationBuilder : 0
02-07 08:35:36.275: D/PhoneStatusBar(276): addNotification score=0
02-07 08:35:36.325: D/JPush(693): [NotificationHelper] Send push received broadcast to developer defined receiver
02-07 08:35:36.335: D/JPush(693): [MyReceiver] onReceive - cn.jpush.android.intent.NOTIFICATION_RECEIVED, extras: 
02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.MSG_ID, value:399588935
02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.ALERT, value:祝大家新春快乐
02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.NOTIFICATION_CONTENT_TITLE, value:JPush SDK Demo
02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.EXTRA, value:{}
02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.PUSH_ID, value:399588935
02-07 08:35:36.335: D/JPush(693): key:cn.jpush.android.NOTIFICATION_ID, value:399588935
02-07 08:35:36.335: D/JPush(693): [MyReceiver] 接收到推送下来的通知
02-07 08:35:36.335: D/JPush(693): [MyReceiver] 接收到推送下来的通知的ID: 399588935
02-07 08:35:36.355: D/MediaPlayer(276): Couldn‘t open file on client side, trying server side

 

可以看到图片左上角图标就是提醒我们收到推送消息。

上面我们后台是面向全部操作平台（包括ANdorid，iOS）的所有用户推送内容，那么如何针对某一个用户推送内容呢？上一篇文章有提到过，我们需要设置别名（alias）。

ok，点击高级功能，会看到如下界面，并且我在alias里填入手机号码 

具体设置别名（alias）的代码，可以看到是调用Handler来实现的

private void setAlias(){
        EditText aliasEdit = (EditText) findViewById(R.id.et_alias);
        String alias = aliasEdit.getText().toString().trim();
        if (TextUtils.isEmpty(alias)) {
            Toast.makeText(PushSetActivity.this,R.string.error_alias_empty, Toast.LENGTH_SHORT).show();
            return;
        }
        if (!ExampleUtil.isValidTagAndAlias(alias)) {
            Toast.makeText(PushSetActivity.this,R.string.error_tag_gs_empty, Toast.LENGTH_SHORT).show();
            return;
        }

        //调用JPush API设置Alias
        mHandler.sendMessage(mHandler.obtainMessage(MSG_SET_ALIAS, alias));
    }

 

handler里是调用如下代码设置alias值

  case MSG_SET_ALIAS:
                Log.d(TAG, "Set alias in handler.");
                JPushInterface.setAliasAndTags(getApplicationContext(), (String) msg.obj, null, mAliasCallback);
                break;

 

然后我们就可以根据设置的alias值，结合第一篇博客后台服务器的设置方法，根据确定的别名进行推送。下面是上一篇博客中后台服务器对alias的设置

public static PushPayload buildPushObject_all_alias_alert() {
        return PushPayload.newBuilder()
                .setPlatform(Platform.android())//设置接受的平台
                .setAudience(Audience.alias("18810923631"))//Audience设置为all，说明采用广播方式推送，所有用户都可以接收到
                .setNotification(Notification.alert(ALERT))
                .build();
    }

 

除了别名（alias）外，极光推送还提供了tag（标签），主要是针对特定的一组用户进行推送。还有设置推送时间以及设置通知栏样式，大家也可以研究。重要的还是明白其原理

最后再来看一下原理图