阿里云移动推送的接入和踩坑

转载 于 2021-04-29 16:00:10 发布 · 3.2k 阅读 · 6 ·
CC 4.0 BY-SA版权
原文链接：https://cloud.macloud.tech/post/cs/a-li-yun-yi-dong-tui-song-de-jie-ru-he-cai-keng
文章标签：

#云服务 #云服务器 #阿里云 #腾讯云 #华为云

本文详细介绍了如何接入阿里云移动推送服务，包括在阿里云后台创建App、配置Android SDK、设置权限、消息接收Receiver、处理Android 8.0以上通知通道、以及辅助通道和辅助弹窗的接入。强调了在不同阶段需要注意的关键步骤和配置，如添加依赖、初始化推送服务、处理推送权限和注册辅助通道。

近期由于业务需求，要换掉以前的推送，首先选择了阿里云推送，官方介绍阿里移动推送（Alibaba Cloud Mobile Push）是基于大数据的移动智能推送服务，帮助App快速集成移动推送的功能，在实现高效、精确、实时的移动推送的同时，极大地降低了开发成本。让开发者最有效地与用户保持连接，从而提高用户活跃度、提高应用的留存率。那么接下来我们就一起看看是如何接入的。

一. 在阿里云后台创建自己的App

具体的步骤请详看阿里云移动推送的技术文档：阿里云移动推送快速入门

打开阿里云移动研发平台EMAS控制台，进行后面的操作

一、创建产品和应用

移动服务当前创建应用，需要两步

  • （1）添加产品（产品是一个集合的概念，产品下包含iOS应用、Android应用）；
  • （2）在产品处，点击管理后，右上角点击“创建应用”完成应用创建。

1、点击页面中的“添加产品”按钮，即可创建一个新的产品

1

2、输入产品的基本信息创建App时需要输入产品的名称，上传产品图标，选择产品分类。

2

3、产品创建成功

App创建成功后，产品列表会多出一个产品，强烈建议您去配置app。

3

4、创建产品对应的应用

在产品列表页面，点击已经创建的产品按钮，进入产品管理页面。

4

5、在产品管理页面，点击添加应用图标，创建应用（目前需要分端创建）。

5

  • （1）创建Android应用，并填写APP名称和PackageName

6

创建完成后，应用会出现在应用列表中：

7

 二. 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权限配置：

    <!-- [阿里云](https://l.gushuji.site/aliyun)推送相关权限 -->    <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:AWCN11] AUTH httpStatusCode: 20011-24 12:53:51.036 15235-15556/com.alibaba.xxxx E/awcn﹕ |[seq:AWCN11] 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 idpushRequest.setAndroidNotificationChannel("1");

特别注意：利用阿里云控制台推送

使用阿里云控制台推送通知时，需要设置 “高级设置”，在最下面的 “Android8.0 特殊配置:” ，填写 “通知通道：”，也就是上述客户端注册的 NotificationChannel 的 id，例如上述代码中NotificationChannel 为1，如下图所示：image

 以上就是阿里云的全部推送，那么还有一个很致命的问题在这，目前谷歌的推送通道在大陆被墙了，一般的推送只能用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辅助通道和弹窗排查步骤

接入辅助通道后，需要结合辅助弹窗来接收推送

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和回调地址，这一条需要特别的注意。以上有不明白的小伙伴，可以评论留言咨询。

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值