阿里云推送接入

记录一下阿里推送接入的流程:

我采用的是Maven库快速集成

1:阅读阿里云推送的开发文档,

文档地址:https://help.aliyun.com/document_detail/51056.html?spm=a2c4g.11186623.6.555.28935d9bPyAAdI

2:在Project的build.gradle文件中配置maven库的URL:

allprojects {
    repositories {
        google()
        jcenter()
        maven {
            url 'http://maven.aliyun.com/nexus/content/repositories/releases/'
        }
    }
}

3.在对应的module下的build.gradle文件中添加对应依赖:

android {
    ......
    defaultConfig {
        applicationId "xx.xxx.xxx"//包名
       ......

        ndk{
            //选择要添加的对应cpu类型的.so库
            abiFilters 'armeabi', 'armeabi-v7a', 'arm64-v8a'
        }
      .......
    }
    ......
}

dependencies {
     ......
    //阿里推送
    implementation 'com.aliyun.ams:alicloud-android-push:3.1.9.1'
    //或
    compile 'com.aliyun.ams:alicloud-android-push:3.1.9.1@aar'
    compile 'com.aliyun.ams:alicloud-android-utils:1.1.3'
    compile 'com.aliyun.ams:alicloud-android-beacon:1.0.2'
    compile 'com.aliyun.ams:alicloud-android-ut:5.4.3'
    compile 'com.aliyun.ams:alicloud-android-utdid:1.5.2'
    ......
}

注:如果在添加以上abiFilter配置之后Android Studio出现一下提示:

NDK integration is deprecated in the current plugin. Consider trying the new experimental plugin.

则在Project根目录的Gradle.properties文件中添加:

    android.userDeprecatedNdk=true

3.AndroidManifest配置:

在AndroidManifest文件中配置appKey,appSecret

<application android:name="xxxx">
     <meta-data
        android:name="com.alibaba.app.appkey"
        android:value="xxxxxx" />//填入你自己的appKey
    <meta-data
        android:name="com.alibaba.app.appsecret"
        android:value="xxxxxx" />//填入你自己的appSecret
</application>

com.alibaba.app.appkey和com.alibaba.app.appsecret是App对应的信息,在推送控制台APP列表页的应用证书中获取。appKey和appSecret必须写贼application标签里面,否则会报找不到appkey的错误


1
2

点击应用管理就能看到app的信息。如果没有app则需要先创建。

4.消息接收Receiver配置

创建消息接收receiver,继承自com.alibaba.sdk.android.push.MessageReceiver,并在对应回调中添加业务处理逻辑,可参考如下:

import com.alibaba.sdk.android.push.MessageReceiver;
import com.alibaba.sdk.android.push.notification.CPushMessage;

import java.util.Map;

public class AliMessageReceiver extends MessageReceiver {
    //消息接收部分的   LOG_TAG
    public static final String REC_TAG = "receiver";

    @Override
    protected void onNotificationOpened(Context context, String title, String summary, String extraMap) {
        Log.e("AliMessageReceiver", "Receive notification, title: " + title + ", summary: " + summary + ", extraMap: " + extraMap);
    }

    @Override
    protected void onNotificationRemoved(Context context, String messageId) {
        Log.e("AliMessageReceiver", "onNotificationRemoved" );
    }

    @Override
    protected void onMessage(Context context, CPushMessage cPushMessage) {
        Log.e("AliMessageReceiver", "onMessage, messageId: " + cPushMessage.getMessageId());
    }

    @Override
    protected void onNotification(Context context, String title, String summary, Map<String, String> extraMap) {
        Log.e("AliMessageReceiver", "Receiver notification, 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("AliMessageReceiver", "onNotificationReceivedInApp, title: " + title + ", summary: " + summary + ", extraMap: " + extraMap);
    }

    @Override
    protected void onNotificationClickedWithNoAction(Context context, String title, String summary, String extraMap) {
        Log.e("AliMessageReceiver", "onNotificationClickedWithNoAction, title: " + title + ", summary: " + summary + ", extraMap: " + extraMap);
    }
}

将receiver添加到AndroidManifest文件中

<!-- 消息接收监听器-->
<receiver
    android:name=".receiver.AliMessageReceiver"
    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_REMOED" />
    </intent-filter>
    <intent-filter>
        <action android:name="com.alibaba.sdk.android.push.RECEIVE" />
    </intent-filter>
</receiver> 

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.**{*;}
-keep class org.json.**{*;}
-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

7.其他问题

Android 8.0 及以上 NotificationChannel 机制
请参照 移动推送Android SDK: Android 8.0 以上设备通知接收不到
android9.0以上需要设置允许 http 请求
请参照 移动推送 Android : 只在Android 9+系统报错 errorCode:10109

到这里阿里云推送就算接入完成了。
但是手机息屏后cpu进入休眠状态,常规的服务和长连接都会被系统停掉,亮屏后恢复。厂商深度定制的系统,支持厂商通道的,才可以收到,比如华为小米等辅助通道

下面是接入华为辅助通道的记录:

文档查看:移动推送辅助通道配置

1.配置应用

华为开发者联盟 注册 App,应用审核通过后,能够得到华为的AppID和AppSecert。在控制台应用配置中设置你的应用 AppID 和 AppSecert。(注意:最新的华为开放平台是分开push功能的,需要在push功能区 开通/启用 推送功能),,华为后台添加消息回执回调地址,https://agoo-ack.m.taobao.com/hw/

https 证书填入以下内容:

-----BEGIN CERTIFICATE-----
MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkG
A1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jv
b3QgQ0ExGzAZBgNVBAMTEkdsb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAw
MDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9i
YWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYDVQQDExJHbG9iYWxT
aWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDaDuaZ
jc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavp
xy0Sy6scTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp
1Wrjsok6Vjk4bwY8iGlbKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdG
snUOhugZitVtbNV4FpWi6cgKOOvyJBNPc1STE4U6G7weNLWLBYy5d4ux2x8gkasJ
U26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrXgzT/LCrBbBlDSgeF59N8
9iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNVHRMBAf8E
BTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0B
AQUFAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOz
yj1hTdNGCbM+w6DjY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE
38NflNUVyRRBnMRddWQVDf9VMOyGj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymP
AbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhHhm4qxFYxldBniYUr+WymXUad
DKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveCX4XSQRjbgbME
HMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
-----END CERTIFICATE-----
开通推送
回执状态配置

在阿里云推送的控制台里添加华为APP的信息


辅助通道2.png

2.在Project的build.gradle文件中配置maven库的URL:

和上面阿里云推送的maven库的URL是一样的,上面配置了这里可以不用配置。

allprojects {
    repositories {
        maven {
            url 'http://maven.aliyun.com/nexus/content/repositories/releases/'
        }
    }
}

gradle添加依赖:

dependencies {
    compile 'com.aliyun.ams:alicloud-android-third-push:3.1.0@aar'
}

注意:如果只添加alicloud-android-third-push,而不添加华为通道依赖时,会报错找不到一些文件和值,比如@string/error_over_original_size @string/error_over_original_count @style/upsdkDlDialog,如要使用华为通道,请看下文华为依赖,添加上即可,如不使用通道,您自行写上这些值即可。

3.Huawei依赖

添加华为推送SDK依赖:

dependencies {
    ......
    compile 'com.aliyun.ams:huawei-push:2.6.3.305'
    compile 'com.aliyun.ams:huawei-push-base:2.6.3.305'
}

同时在AndroidManifest文件中添加如下配置:

<meta-data
            android:name="com.huawei.hms.client.appid"
            android:value="appid=华为开放平台申请的ID信息" />

4. Proguard配置

如果集成推送SDK的工程开启代码混淆,在Proguard配置的基础上,需要添加以下辅助通道的Proguard配置。

# 华为通道
-keep class com.huawei.** {*;}
-dontwarn com.huawei.**

5. 在应用中初始化辅助通道

将以下代码加入你application.onCreate()方法中初始通道。\color{#FF0000}{注意:辅助通道注册务必在Application中执行且放在推送SDK初始化代码之后,否则可能导致辅助通道注册失败}

// 注册方法会自动判断是否支持华为系统推送,如不支持会跳过注册。
HuaWeiRegister.register(application);

6. 在日志中查看初始化情况

华为通道初始化成功,可以看到以下日志:(如不成功,检查是否在华为控制台配置SHA256指纹证书,目前华为需要配置)
华为.jpg

7. 辅助弹窗

  • 当前部分国产品牌设备管控严格,接入推送功能的App进程在后台被清理后,收不到推送通知;接入辅助弹窗后,可以借助对应品牌的系统通道,保证App后台被清理后,仍能收到推送通知;
  • 当前辅助弹窗已接入小米、华为、OPPO、VIVO、魅族(小米辅助弹窗:v2.3.0及以上支持;华为辅助弹窗:v3.0.8及以上支持;OPPO辅助弹窗:v3.1.4及以上支持);
  • 当前华为辅助弹窗仅支持Emotion UI(华为定制ROM)4.1级以上版本的设备;

7.1 客户端

  • 该功能的使用需要接入推送辅助通道,确保使用最新的辅助通道扩展包,具体参考上文;

  • 辅助弹窗送达的通知展示效果,和普通通知相同;

  • 服务端指定辅助弹窗通道推送时,一定要指定通知点击后要打开的Activity,该Activity需继承自抽象类AndroidPopupActivityMiPushSystemNotificationActivity已废弃,小米、华为、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);
    }
}

到这里基本就是完成了。
可以在控制台或者服务器进行测试
在控制台测试要注意一下:


注意

activity,title, body的参数需要填写,不然收不到推送。
通知通道我说在使用华为推送事不用写是因为,我收到推送的时候不在我设置的推送通道里。是一个叫“营销通知”的一个推送通道。而且默认是静默的,有人知道怎么设置或者怎么回事,麻烦告诉我一下,先谢谢了!


营销通知
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345