近期由于业务需求,要换掉以前的推送,首先选择了阿里云推送,官方介绍阿里移动推送(Alibaba Cloud Mobile Push)是基于大数据的移动智能推送服务,帮助App快速集成移动推送的功能,在实现高效、精确、实时的移动推送的同时,极大地降低了开发成本。让开发者最有效地与用户保持连接,从而提高用户活跃度、提高应用的留存率。那么接下来我们就一起看看是如何接入的。
一. 在阿里云后台创建自己的App
具体的步骤请详看阿里云移动推送的技术文档:阿里云移动推送快速入门
打开阿里云移动研发平台EMAS控制台,进行后面的操作
一、创建产品和应用
移动服务当前创建应用,需要两步
- (1)添加产品(产品是一个集合的概念,产品下包含iOS应用、Android应用);
- (2)在产品处,点击管理后,右上角点击“创建应用”完成应用创建。
1、点击页面中的“添加产品”按钮,即可创建一个新的产品
2、输入产品的基本信息创建App时需要输入产品的名称,上传产品图标,选择产品分类。
3、产品创建成功
App创建成功后,产品列表会多出一个产品,强烈建议您去配置app。
4、创建产品对应的应用
在产品列表页面,点击已经创建的产品按钮,进入产品管理页面。
5、在产品管理页面,点击添加应用图标,创建应用(目前需要分端创建)。
- (1)创建Android应用,并填写APP名称和PackageName
创建完成后,应用会出现在应用列表中:
二. Android SDK 3.0配置
安卓sdk的配置,个人强烈建议采用Maven库快速集成(远程同步),本博客也将采用远程快速集成。
1. 在Project根目录下build.gradle文件中配置maven库URL
allprojects {
repositories {
jcenter()
maven {
url 'http://maven.aliyun.com/nexus/content/repositories/releases/'
}
}
}
2. 在对应的app下的build.gradle文件中添加对应依赖
android {
......
defaultConfig {
applicationId "com.xxx.xxx" //包名
......
ndk {
//选择要添加的对应cpu类型的.so库。
abiFilters 'armeabi', 'x86'
}
......
}
......
}
dependencies {
......
compile 'com.aliyun.ams:alicloud-android-push:3.1.4@aar'
// 或(二选一)
compile 'com.aliyun.ams:alicloud-android-push:3.1.4'
compile 'com.aliyun.ams:alicloud-android-utils:1.1.3'
compile 'com.aliyun.ams:alicloud-android-beacon:1.0.1'
compile 'com.aliyun.ams:alicloud-android-ut:5.4.0'
......
}
特别注意 : 如果在添加以上 abiFilter 配置之后android Studio出现以下提示:
NDK integration is deprecated in the current plugin. Consider trying the new experimental plugin.
则在 Project 根目录的gradle.properties文件中添加:
android.useDeprecatedNdk=true
3. appKey, appSecret配置
在AndroidManifest文件中设置appKey,appSecret:
<application android:name="*****">
<meta-data android:name="com.alibaba.app.appkey" android:value="*****"/> <!-- 请填写你自己的- appKey -->
<meta-data android:name="com.alibaba.app.appsecret" android:value="****"/> <!-- 请填写你自己的appSecret -->
</application>
**特别提示:**com.alibaba.app.appkey
和com.alibaba.app.appsecret
为您App的对应信息,在推送控制台APP列表页的应用证书中获取。appkey
和appsecret
请务必写在application
标签下,否则sdk会报找不到appkey错误。如果您是百川云推送用户,不能直接使用百川平台的appKey和appSecret,需要登录阿里云移动推送控制台,登录账号为您的百川平台账号,并使用阿里云平台的appKey
,appSecret
。
Permission权限配置:
<!-- 阿里云推送相关权限 -->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.RESTART_PACKAGES" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.REORDER_TASKS" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
4. 消息接收Receiver配置
创建消息接收Receiver,继承自com.alibaba.sdk.android.push.MessageReceiver,并在对应回调中添加业务处理逻辑,可参考以下代码:
public class MyMessageReceiver extends MessageReceiver {
// 消息接收部分的LOG_TAG
public static final String REC_TAG = "receiver";
@Override
public void onNotification(Context context, String title, String summary, Map<String, String> extraMap) {
// TODO 处理推送通知
Log.e("MyMessageReceiver", "Receive notification, title: " + title + ", summary: " + summary + ", extraMap: " + extraMap);
}
@Override
public void onMessage(Context context, CPushMessage cPushMessage) {
Log.e("MyMessageReceiver", "onMessage, messageId: " + cPushMessage.getMessageId() + ", title: " + cPushMessage.getTitle() + ", content:" + cPushMessage.getContent());
}
@Override
public void onNotificationOpened(Context context, String title, String summary, String extraMap) {
Log.e("MyMessageReceiver", "onNotificationOpened, title: " + title + ", summary: " + summary + ", extraMap:" + extraMap);
}
@Override
protected void onNotificationClickedWithNoAction(Context context, String title, String summary, String extraMap) {
Log.e("MyMessageReceiver", "onNotificationClickedWithNoAction, title: " + title + ", summary: " + summary + ", extraMap:" + extraMap);
}
@Override
protected void onNotificationReceivedInApp(Context context, String title, String summary, Map<String, String> extraMap, int openType, String openActivity, String openUrl) {
Log.e("MyMessageReceiver", "onNotificationReceivedInApp, title: " + title + ", summary: " + summary + ", extraMap:" + extraMap + ", openType:" + openType + ", openActivity:" + openActivity + ", openUrl:" + openUrl);
}
@Override
protected void onNotificationRemoved(Context context, String messageId) {
Log.e("MyMessageReceiver", "onNotificationRemoved");
}
}
将该receiver添加到AndroidManifest.xml中(切不要忘记了)
<!-- 消息接收监听器 (用户可自主扩展) -->
<receiver
android:name=".MyMessageReceiver"
android:exported="false"> <!-- 为保证receiver安全,建议设置不可导出,如需对其他应用开放可通过android:permission进行限制 -->
<intent-filter>
<action android:name="com.alibaba.push2.action.NOTIFICATION_OPENED" />
</intent-filter>
<intent-filter>
<action android:name="com.alibaba.push2.action.NOTIFICATION_REMOVED" />
</intent-filter>
<intent-filter>
<action android:name="com.alibaba.sdk.android.push.RECEIVE" />
</intent-filter>
</receiver>
如果是从V2.3.7及以下版本升级到V3.0.0及以上版本的用户,需将<action android:name="org.agoo.android.intent.action.RECEIVE" />
改为<action android:name="com.alibaba.sdk.android.push.RECEIVE" />
,否则会接收不到推送。
5. Proguard配置
-keepclasseswithmembernames class ** {
native <methods>;
}
-keepattributes Signature
-keep class sun.misc.Unsafe { *; }
-keep class com.taobao.** {*;}
-keep class com.alibaba.** {*;}
-keep class com.alipay.** {*;}
-keep class com.ut.** {*;}
-keep class com.ta.** {*;}
-keep class anet.**{*;}
-keep class anetwork.**{*;}
-keep class org.android.spdy.**{*;}
-keep class org.android.agoo.**{*;}
-keep class android.os.**{*;}
-dontwarn com.taobao.**
-dontwarn com.alibaba.**
-dontwarn com.alipay.**
-dontwarn anet.**
-dontwarn org.android.spdy.**
-dontwarn org.android.agoo.**
-dontwarn anetwork.**
-dontwarn com.ut.**
-dontwarn com.ta.**
6. 在应用中注册和启动移动推送
- 首先通过
PushServiceFactory
获取到CloudPushService
,然后调用register()
初始化并注册云推送通道,并确保Application
上下文中进行初始化工作。 - 请参照以下代码段进行初始化:
import android.app.Application;
import android.content.Context;
import android.util.Log;
import com.alibaba.sdk.android.push.CloudPushService;
import com.alibaba.sdk.android.push.CommonCallback;
import com.alibaba.sdk.android.push.noonesdk.PushServiceFactory;
public class MainApplication extends Application {
private static final String TAG = "Init";
@Override
public void onCreate() {
super.onCreate();
initCloudChannel(this);
}
/**
* 初始化云推送通道
* @param applicationContext
*/
private void initCloudChannel(Context applicationContext) {
PushServiceFactory.init(applicationContext);
CloudPushService pushService = PushServiceFactory.getCloudPushService();
pushService.register(applicationContext, new CommonCallback() {
@Override
public void onSuccess(String response) {
Log.d(TAG, "init cloudchannel success");
}
@Override
public void onFailed(String errorCode, String errorMessage) {
Log.d(TAG, "init cloudchannel failed -- errorcode:" + errorCode + " -- errorMessage:" + errorMessage);
}
});
}
}
【注意】:
- 移动推送的初始化必须在Application中,不能放到Activity中执行。移动推送在初始化过程中将启动后台进程channel,必须保证应用进程和channel进程都执行到推送初始化代码。
- 如果设备成功注册,将回调callback.onSuccess()方法。
- 但如果注册服务器连接失败,则调用callback.onFailed方法,并且自动进行重新注册,直到onSuccess为止。(重试规则会由网络切换等时间自动触发。)
- 请在网络通畅的情况下进行相关的初始化调试,如果网络不通,或者App信息配置错误,在onFailed方法中,会有相应的错误码返回,可参考错误处理。
启动正常确认方法:
- 回调方法callback.onSuccess()被调用。以上文接入代码为例,logcat将会打印以下日志:
11-24 12:55:51.096 15235-15535/com.alibaba.xxxx D/YourApp﹕ init cloudchannel success
- 确认cloudchannel初始化正常,在logcat日志中:输入awcn关键字:
11-24 12:53:51.036 15235-15556/com.alibaba.xxxx E/awcn﹕ |[seq:AWCN1_1] AUTH httpStatusCode: 200
11-24 12:53:51.036 15235-15556/com.alibaba.xxxx E/awcn﹕ |[seq:AWCN1_1] status:AUTH_SUCC
确认DeviceId获取正常:在初始化成功后使用
cloudPushService.getDeviceId()
获取deviceId,应该能够成功获取。如果集成移动推送的过程中遇到了
utdid
冲突,可参考:阿里云-移动云产品SDK UTDID冲突解决方案
以上就是阿里云推送的创建、接入和sdk初始化的过程,做到这里我们就可以阿里云移动推送后台发送测试推送了,但是在安卓8.0以上发现收不到推送,自8.0(API Level 26)起,Android 推出了NotificationChannel机制,旨在对通知进行分类管理。如果用户App的targetSdkVersion
大于等于26,且并未设置NotificaitonChannel
,创建的通知是不会弹出的,所以我们要对8.0及其以上的设配设置NotificaitonChannel。
具体调用位置为:Application的onCreate,云推初始化前后都可以,具体代码如下:
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
NotificationManager mNotificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
// 通知渠道的id
String id = "1";
// 用户可以看到的通知渠道的名字.
CharSequence name = "notification channel";
// 用户可以看到的通知渠道的描述
String description = "notification description";
int importance = NotificationManager.IMPORTANCE_HIGH;
NotificationChannel mChannel = new NotificationChannel(id, name, importance);
// 配置通知渠道的属性
mChannel.setDescription(description);
// 设置通知出现时的闪灯(如果 android 设备支持的话)
mChannel.enableLights(true);
mChannel.setLightColor(Color.RED);
// 设置通知出现时的震动(如果 android 设备支持的话)
mChannel.enableVibration(true);
mChannel.setVibrationPattern(new long[]{100, 200, 300, 400, 500, 400, 300, 200, 400});
//最后在notificationmanager中创建该通知渠道
mNotificationManager.createNotificationChannel(mChannel);
}
在服务端的话一定也要设置:
// 指定notificaitonchannel id
pushRequest.setAndroidNotificationChannel("1");
特别注意:利用阿里云控制台推送
使用阿里云控制台推送通知时,需要设置 “高级设置”,在最下面的 “Android8.0 特殊配置:” ,填写 “通知通道:”,也就是上述客户端注册的 NotificationChannel 的 id,例如上述代码中NotificationChannel 为1,如下图所示:
以上就是阿里云的全部推送,那么还有一个很致命的问题在这,目前谷歌的推送通道在大陆被墙了,一般的推送只能用service接收,并且app只能在启动或者后台的情况下收的到。当App进程被杀死后,推送是收不到的,那么该如何解决这种问题呢?
目前市面上华为、小米、oppo、vivo和魅族品牌占据大陆手机市场前五,每个品牌的手机都有自己的推送渠道,以下我简称辅助渠道。也就是说当app的进程被杀死的情况下,我们可以通过厂商渠道来推送,这样即使App不启动也可以收到推送。
接下来我们一起来看一下辅助渠道的接入,不要走开,这个是关键点哦!!!!
一. 小米/华为/OPPO系统推送支持
- 辅助通道:移动推送针对小米、华为设备管控较严的情况特意接入华为,小米推送辅助通道以提高在华为、小米设备上的到达率。移动推送优先选择自有通道进行推送消息下发,只有在自有通道断连时选择辅助通道下发消息。当前辅助通道通过华为、小米推送下发透传消息,消息到达应用后经移动推送SDK处理后触发
onNotification
,onMessage
回调。小米、华为推送在下发透传消息时并不保证会拉起被杀死进程(相关机制可参考小米、华为推送官网),所以辅助通道在进程被杀死情况下无法保证消息一定到达。 - 辅助弹窗:辅助弹窗通过系统通道下发通知,可以在进程被杀死情况下推送成功。由于辅助弹窗通过在对应设备上推送通知实现,因而通过辅助弹窗下发的通知不会触发
onNotification
回调。当前移动推送已接入小米、华为、OPPO辅助弹窗。其中华为弹窗到达率统计只覆盖用户点击华为弹窗推送通知的场景,未点击部分暂未覆盖;小米弹窗到达率统计覆盖所有场景。
在对应的应用市场配置应用
在 小米开放平台 注册你的App, 得到相应的小米AppID,小米AppKey,小米AppSecert。在控制台
应用配置
设置你的小米AppSecert。(注意:最新的小米开放平台是分开 push 功能的,需要在 push 功能区 开通/启用 推送功能
)。同理在 华为开发者联盟 注册 App,应用审核通过后,能够得到华为的AppID和AppSecert。在控制台
应用配置
中设置你的华为AppID和AppSecert。(注意:最新的华为开放平台是分开push功能的,需要在push功能区 开通/启用 推送功能)在OPPO开放平台 注册OPPO企业开发者账号,添加应用并开通oppo推送服务,目前应用需满足:1.在oppo市场上架,2.评级为A,才能使用推送服务,具体政策可咨询oppo客服。同样需要在控制台
应用配置
设置你的OppoAppkey和OppoMasterSecret(AppServerSecret )。
二. 依赖Maven集成
1. 项目顶层build.gradle中添加Maven仓库地址:
allprojects {
repositories {
maven {
url 'http://maven.aliyun.com/nexus/content/repositories/releases/'
}
}
}
2. gradle添加依赖:
dependencies {
compile 'com.aliyun.ams:alicloud-android-third-push:3.0.6@aar'
}
需要特别注意的地方:oppo 通道 需使用 v3.0.6 版本,应用满足:1、在 oppo 市场上架,2、评级为 A.
3. Proguard配置
如果集成推送SDK的工程开启代码混淆,在Proguard配置的基础上,需要添加以下辅助通道的Proguard配置。
# 小米通道
-keep class com.xiaomi.** {*;}
-dontwarn com.xiaomi.**
# 华为通道
-keep class com.huawei.** {*;}
-dontwarn com.huawei.**
# OPPO通道
-keep public class * extends android.app.Service
4. 在应用中初始化辅助通道
将以下代码加入你application.onCreate()方法中初始通道。注意:辅助通道注册务必在Application中执行且放在推送SDK初始化代码之后,否则可能导致辅助通道注册失败
// 注册方法会自动判断是否支持小米系统推送,如不支持会跳过注册。
MiPushRegister.register(applicationContext, "小米AppID", "小米AppKey");
// 注册方法会自动判断是否支持华为系统推送,如不支持会跳过注册。
HuaWeiRegister.register(applicationContext);
//GCM/FCM辅助通道注册
GcmRegister.register(this, sendId, applicationId); //sendId/applicationId为步骤获得的参数
// OPPO通道注册
OppoRegister.register(applicationContext, appKey, appSecret); // appKey/appSecret在OPPO通道开发者平台获取
注意:1. 本方法会自动判断是否支持小米系统推送,如不支持会跳过注册。
2\. 如果控制台配置了`小米/华为`的信息,app需要加对应的jar包依赖,不然会有crash的风险。
3\. OPPO通道是否注册成功, 可以通过过滤`MPS:oppo`关键字查看, 注册成功会打印`onRegister regid=****`相关日志, 否则检 查参数是否正确填入;
4\. 客户端接入完毕,服务端推送时如果设备无法收到推送,可先查看 [移动推送Android SDK:Android辅助通道和弹窗排查步骤](https://help.aliyun.com/knowledge_detail/57105.html)
接入辅助通道后,需要结合辅助弹窗来接收推送
1. 当前辅助弹窗已接入小米、华为、OPPO(小米辅助弹窗:v2.3.0及以上支持
;华为辅助弹窗:v3.0.8及以上支持
;OPPO辅助弹窗:v3.1.4及以上支持
);
2. 当前华为辅助弹窗仅支持Emotion UI(华为定制ROM)4.1级以上版本的设备;
辅助弹窗在客户端设置:
辅助弹窗送达的通知展示效果,和普通通知相同;
服务端指定辅助弹窗通道推送时,一定要指定通知点击后要打开的Activity,该Activity需继承自抽象类
AndroidPopupActivity
(MiPushSystemNotificationActivity
已废弃,小米弹窗、华为弹窗、OPPO弹窗统一继承AndroidPopupActivity
),否则无法获取到通知的相关信息,并且会影响通知到达率的统计;AndroidPopupActivity
中提供抽象方法onSysNoticeOpened()
,实现该方法后可获取到辅助弹窗通知的标题
、内容
和额外参数
,在通知点击时触发,原本的通知回调onNotification()
和onNotificationOpened()
不适用于辅助弹窗;指定打开的托管弹窗Activity在AndroidManifest.xml中注册时需要声明属性:
android:exported=true
接入如下所示:
import com.alibaba.sdk.android.push.AndroidPopupActivity;
public class PopupPushActivity extends AndroidPopupActivity {
static final String TAG = "PopupPushActivity";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
}
/**
* 实现通知打开回调方法,获取通知相关信息
* @param title 标题
* @param summary 内容
* @param extMap 额外参数
*/
@Override
protected void onSysNoticeOpened(String title, String summary, Map<String, String> extMap) {
Log.d("OnMiPushSysNoticeOpened, title: " + title + ", content: " + summary + ", extMap: " + extMap);
}
}
以上就是辅助通道和辅助弹窗的接入的全过程,需要特别的注意的是华为的开发者联盟里push需要设置sha2和回调地址,这一条需要特别的注意。以上有不明白的小伙伴,可以评论留言咨询。