com.meizu.flyme.internet:push-internal-publish:3.3.170214

use compile "com.meizu.flyme.internet:push-internal-publish:3.3.170214" to depend on this library.

License

License

Categories

Categories

Net
GroupId

GroupId

com.meizu.flyme.internet
ArtifactId

ArtifactId

push-internal-publish
Last Version

Last Version

3.3.170214
Release Date

Release Date

Type

Type

pom
Description

Description

com.meizu.flyme.internet:push-internal-publish:3.3.170214
use compile "com.meizu.flyme.internet:push-internal-publish:3.3.170214" to depend on this library.
Project URL

Project URL

https://github.com/MEIZUPUSH/PushDemo.git
Source Code Management

Source Code Management

https://github.com/MEIZUPUSH/PushDemo.git

Download push-internal-publish

How to add to project

<!-- https://jarcasting.com/artifacts/com.meizu.flyme.internet/push-internal-publish/ -->
<dependency>
    <groupId>com.meizu.flyme.internet</groupId>
    <artifactId>push-internal-publish</artifactId>
    <version>3.3.170214</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/com.meizu.flyme.internet/push-internal-publish/
implementation 'com.meizu.flyme.internet:push-internal-publish:3.3.170214'
// https://jarcasting.com/artifacts/com.meizu.flyme.internet/push-internal-publish/
implementation ("com.meizu.flyme.internet:push-internal-publish:3.3.170214")
'com.meizu.flyme.internet:push-internal-publish:pom:3.3.170214'
<dependency org="com.meizu.flyme.internet" name="push-internal-publish" rev="3.3.170214">
  <artifact name="push-internal-publish" type="pom" />
</dependency>
@Grapes(
@Grab(group='com.meizu.flyme.internet', module='push-internal-publish', version='3.3.170214')
)
libraryDependencies += "com.meizu.flyme.internet" % "push-internal-publish" % "3.3.170214"
[com.meizu.flyme.internet/push-internal-publish "3.3.170214"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

魅族推送 PushSDK3 说明文档

目录

1 获取

jcenter获取      官网下载AAR

2 更新日志

[2020-11-13]V4.0.2

  • 全面适配Android11
  • 修复一些安全漏洞和若干BUG
  • 优化一些性能问题

[2020-06-16]V3.9.7

  • 优化推送逻辑
  • 修复若干BUG

[2020-03-09]V3.9.0

  • 优化点击通知消息逻辑
  • 修复若干BUG
  • 全面适配Android 10

[2019-11-27]V3.8.7

  • 移除 READ_PHONE_STATE 权限的声明

[2019-11-18]V3.8.6

  • 修复若干BUG
  • 移除敏感无用的代码

[2019-08-21]V3.8.4

  • 移除敏感无用的权限声明
  • 移除旧版订阅和取消订阅回调方法的声明

[2019-07-01]V3.8.3

  • 修复一些安全漏洞和若干BUG
  • 优化内部推送逻辑

[2018-08-30]V3.8.1

  • 修复一些安全漏洞

[2018-08-01]V3.7.4

  • 优化非魅族手机订阅逻辑

[2018-07-12]V3.7.3

  • 优化一些小细节

[2018-06-28]V3.7.1

  • 修复zip文件目录遍历的漏洞

[2018-06-03]V3.7.0

  • 修复部分第三方机型可能出现的兼容性报错问题

[2018-05-03]V3.6.7

  • 修复三方机型的兼容性问题

[2018-02-08]V3.6.3

  • 修改可能出现的空指针问题

[2017-12-4]V3.6.0

  • 启用代码proguard,减少包大小
  • 去除获取地址位置权限声明

[2017-12-01]V3.5.2

  • 通知栏删除接口增加一次删除多个NotifyID的功能一次可传入多个notifyId

[2017-11-13]重要变更V3.5.0

  • 增加通知栏清除功能,通知栏消息聚合功能
  • MzPushMessageReceiver 接口重大变更
  • 优化数据上报逻辑,提升数据上报准确度
  • 一些已知问题的修改

[2017-08-18]V3.4.2

  • 解决使用换机助手时,应用无法更新pushId
  • 应用没有设置状态栏图标,默认设置flyme第三方风格的状态栏图标

[2017-06-01]V3.3.170601

  • 增加应用拉活功能

[2017-05-18]V3.3.170518

  • 增加内存缓存数据上报策略,解决SQLite数据库无法读取的错误

[2017-04-26]V3.3.170505

  • 优化PushManager逻辑
  • 增加打开第三方应用的功能
  • 统一PushSDK内外版本,artifactId为:push-internal,完整配置如下:compile 'com.meizu.flyme.internet:push-internal:3.3.170505@aar'
  • 增加点击通知栏和透传消息传递平台参数的功能

[2017-03-29]V3.3.170329

  • 外部应用设置状态栏图标也能正确显示
  • 优化log输出逻辑,日志按天输出
  • 修复intent.parseUri的安全漏洞,但是打开应用某个界面必须填写Activity的全路径
  • 增加统一修改通知栏和透传消息开关的接口
  • 增加取消所有标签接口
  • 优化一些性能问题

[2017-01-18]V3.3.170112

  • 删除https无用代码
  • 解决deviceId无法获取导致无法订阅的问题
  • 删除无用权限声明

[2017-01-10]V3.3.170110

  • 解决Jar包集成无法找到R类的问题
  • 解决数据上报安全性问题

[2017-01-04]V3.3.170103

  • 精简sdk代码,权限,不再依赖第三方库
  • 加入通知栏动态视频功能,如需要使用,需要向平台申请开通权限

[2016-12-26]V3.3.161226

  • Https 加入安全校验
  • 通知栏功能仅支持 API 16以上的android版本
  • 通知栏兼容至API 11

[2016-12-23] V3.3.161222

  • pushsdk 去除第三方依赖,不再依赖其他任何第三方库

3 接入步骤

PushSDK 3.0 以后的版本使用了aar包方式,因此对于一些通用的权限配置,工程混淆,App接入时不需要再进行配置了,只需要按以下步骤简单接入即可。

3.1 配置依赖

我们已经将PushSDK发布到JCenter,您只需要在工程gradle文件中进行如下依赖配置:

    dependencies {
        implementation 'com.meizu.flyme.internet:push-internal:4.0.2'
    }

注意: 如果由于网络原因不能使用JCenter依赖,还可以直接下载AAR包进行手动集成:点击下载

3.2 声明权限

在您工程AndroidManifest.xml中进行以下权限的声明:

  <!-- 可选,用于兼容Flyme5且推送服务是旧版本的情况-->
  <uses-permission android:name="android.permission.READ_PHONE_STATE" />
  
  <!-- 兼容Flyme5的权限配置-->
  <uses-permission android:name="com.meizu.flyme.push.permission.RECEIVE" />
  <permission android:name="【替换您的包名】.push.permission.MESSAGE" android:protectionLevel="signature"/>
  <uses-permission android:name="【替换您的包名】.push.permission.MESSAGE" />
  <!-- 兼容Flyme3的权限配置-->
  <uses-permission android:name="com.meizu.c2dm.permission.RECEIVE" />
  <permission android:name="【替换您的包名】.permission.C2D_MESSAGE" android:protectionLevel="signature" />
  <uses-permission android:name="【替换您的包名】.permission.C2D_MESSAGE"/>

注意: 请将以上【替换您的包名】替换成您自己App的包名。

3.3 注册消息接收的广播

在您工程AndroidManifest.xml中进行消息接收广播的声明:

  <!-- push应用定义消息receiver声明 -->
  <receiver android:name="【替换您的类完整路径】.MyPushMsgReceiver">
      <intent-filter>
          <!-- 接收push消息 -->
          <action android:name="com.meizu.flyme.push.intent.MESSAGE" />
          <!-- 接收register消息 -->
          <action android:name="com.meizu.flyme.push.intent.REGISTER.FEEDBACK" />
          <!-- 接收unregister消息-->
          <action android:name="com.meizu.flyme.push.intent.UNREGISTER.FEEDBACK"/>
          <!-- 兼容低版本Flyme3推送服务配置 -->
          <action android:name="com.meizu.c2dm.intent.REGISTRATION" />
          <action android:name="com.meizu.c2dm.intent.RECEIVE" />
          <category android:name="【替换您的包名】" />
      </intent-filter>
  </receiver>

注意: 请将以上【替换您的类完整路径】和【替换您的包名】替换成您自己工程相对应的值。

3.4 实现消息接收的广播

创建消息接收的广播类,名称如:MyPushMsgReceiver,实现如下:

public class MyPushMsgReceiver extends MzPushMessageReceiver {

    /**
     * 调用订阅方法后,会在此方法回调结果
     * 订阅方法:PushManager.register(context, appId, appKey)
     * @param context
     * @param registerStatus
     */
    @Override
    public void onRegisterStatus(Context context, RegisterStatus registerStatus) {
    }

    /**
     * 调用取消订阅方法后,会在此方法回调结果
     * 取消订阅方法:PushManager.unRegister(context, appId, appKey)
     * @param context
     * @param unRegisterStatus
     */
    @Override
    public void onUnRegisterStatus(Context context, UnRegisterStatus unRegisterStatus) {
    }

    /**
     * 调用开关转换或检查开关状态方法后,会在此方法回调开关状态
     * 通知栏开关转换方法:PushManager.switchPush(context, appId, appKey, pushId, pushType, switcher)
     * 检查开关状态方法:PushManager.checkPush(context, appId, appKey, pushId)
     * @param context
     * @param pushSwitchStatus
     */
    @Override
    public void onPushStatus(Context context, PushSwitchStatus pushSwitchStatus) {
    }

    /**
     * 调用标签订阅、取消标签订阅、取消所有标签订阅和获取标签列表方法后,会在此方法回调标签相关信息
     * 标签订阅方法:PushManager.subScribeTags(context, appId, appKey, pushId, tags)
     * 取消标签订阅方法:PushManager.unSubScribeTags(context, appId, appKey, pushId,tags)
     * 取消所有标签订阅方法:PushManager.unSubScribeAllTags(context, appId, appKey, pushId)
     * 获取标签列表方法:PushManager.checkSubScribeTags(context, appId, appKey, pushId)
     * @param context
     * @param subTagsStatus
     */
    @Override
    public void onSubTagsStatus(Context context, SubTagsStatus subTagsStatus) {
    }

    /**
     * 调用别名订阅、取消别名订阅和获取别名方法后,会在此方法回调别名相关信息
     * 别名订阅方法:PushManager.subScribeAlias(context, appId, appKey, pushId, alias)
     * 取消别名订阅方法:PushManager.unSubScribeAlias(context, appId, appKey, pushId, alias)
     * 获取别名方法:PushManager.checkSubScribeAlias(context, appId, appKey, pushId)
     * @param context
     * @param subAliasStatus
     */
    @Override
    public void onSubAliasStatus(Context context, SubAliasStatus subAliasStatus) {
    }

    /**
     * 当用户点击通知栏消息后会在此方法回调
     * @param context
     * @param mzPushMessage
     */
    @Override
    public void onNotificationClicked(Context context, MzPushMessage mzPushMessage) {
    }

    /**
     * 当推送的通知栏消息展示后且应用进程存在时会在此方法回调
     * @param context
     * @param mzPushMessage
     */
    @Override
    public void onNotificationArrived(Context context, MzPushMessage mzPushMessage) {
    }
}

至此 PushSDK 已经接入完毕,现在您还需要在您工程中去调用一下订阅方法(建议在 Application onCreate 中执行 ):

PushManager.register(this, APP_ID, APP_KEY);

并确保您自定义的消息接收 Receiver 类中能在 onRegisterStatus(RegisterStatus registerStatus) 方法中正确回调,这样接入就成功了。现在就可以到Push平台 找到您的应用进行消息推送了。

4 功能说明

4.1 PushManager方法说明

方法名称 方法说明 使用建议 对应MzPushReceiver回调方法
register(Context context,String appId,String appKey) 订阅 建议在Application onCreate中调用 onRegisterStatus(Context context,RegisterStatus registerStatus)
unRegister(Context context,String appId,String appKey) 取消订阅 取消所有推送时使用,请慎用,若取消订阅,将有可能停止所有推送 onUnRegisterStatus(Context context,UnRegisterStatus unRegisterStatus)
subScribeTags(Context context,String appId,String appKey,String pushId,String tags) 标签订阅 onSubTagsStatus(Context context,SubTagsStatus subTagsStatus)
unSubScribeTags(Context context, String appId, String appKey, String pushId,String tags) 取消标签订阅 onSubTagsStatus(Context context,SubTagsStatus subTagsStatus)
unSubScribeAllTags(Context context, String appId, String appKey, String pushId) 取消所有标签订阅 onSubTagsStatus(Context context,SubTagsStatus subTagsStatus)
checkSubScribeTags(Context context,String appId,String appKey,String pushId) 获取标签列表 onSubTagsStatus(Context context,SubTagsStatus subTagsStatus)
subScribeAlias(Context context,String appId,String appKey,String pushId,String alias) 别名订阅 onSubAliasStatus(Context context,SubAliasStatus subAliasStatus)
unSubScribeAlias(Context context,String appId,String appKey,String pushId,String alias) 取消别名订阅 onSubAliasStatus(Context context,SubAliasStatus subAliasStatus)
checkSubScribeAlias(Context context,String appId,String appKey,String pushId) 获取别名 onSubAliasStatus(Context context,SubAliasStatus subAliasStatus)
switchPush(Context context,String appId,String appKey,String pushId,boolean switcher) 通知栏和透传开关同时转换 透传功能已停用 onPushStatus(Context context,PushSwitchStatus pushSwitchStatus)
switchPush(Context context,String appId,String appKey,String pushId,int pushType,boolean switcher) 通知栏或透传开关单独转换 透传功能已停用 onPushStatus(Context context,PushSwitchStatus pushSwitchStatus)
checkPush(Context context,String appId,String appKey,String pushId) 检查通知栏和透传开关状态 透传功能已停用,此方法在有无网络下都能成功返回 onPushStatus(Context context,PushSwitchStatus pushSwitchStatus)
clearNotification(Context context) 清除应用弹出的所有通知栏消息
clearNotification(Context context, int notifyId) 清除应用弹出的指定notifyId的通知栏消息
getPushId(Context context) 获得已订阅后的PushId

参数说明

appId:          Push平台申请的应用id。
appKey:       Push平台申请的应用key。
pushId:        可以在订阅接口的回调方法 onRegisterStatus 中,通过: registerStatus.getPushId(); 来获取。
tags:            标签名称,多个逗号隔离,每个标签不能超过 20 个字符,限100个。
alias:            别名名称,长度不能超过 20 个字符,每一个应用用户仅能设置一个别名。
pushType:   消息类型,0:通知栏消息 1:透传消息。
switcher:     开关状态
notifyId:       通知Id,由服务端生成,可以在通知展示的回调方法 onNotificationArrived 中,通过: mzPushMessage.getNotifyId(); 来获取。

4.2 MzPushReceiver回调方法说明

方法名称 方法说明 使用建议
onRegisterStatus(Context context,RegisterStatus registerStatus) 订阅回调
onUnRegisterStatus(Context context,UnRegisterStatus unRegisterStatus) 取消订阅回调
onPushStatus(Context context,PushSwitchStatus pushSwitchStatus) 通知栏和透传消息开关状态回调
onSubTagsStatus(Context context,SubTagsStatus subTagsStatus) 标签状态回调
onSubAliasStatus(Context context,SubAliasStatus subAliasStatus) 别名状态回调
onNotificationClicked(Context var1, MzPushMessage mzPushMessage) 通知点击回调
onNotificationArrived(Context context, MzPushMessage mzPushMessage) 通知展示回调 只有在应用进程存在时才会在此方法回调
onMessage(Context context,String message,String platformExtra) 透传消息回调 透传功能已停用

5 通知栏消息推送原理

5.1 通知的生成

在您的应用正确接入PushSDK并在平台上进行消息推送后,所有这些推送消息都是通过Flyme系统应用“推送服务”进行处理和展示。“推送服务”会在云端与客户端之间建立一条稳定、可靠的长连接,从而实现客户端应用实时接收推送平台下发的消息,而且它还充当着通知栏消息创造角色,在您客户端应用进程不在的情况下也能为其创造出通知栏消息。使得能有效地帮助您应用拉动用户活跃度,改善产品体验。

5.2 通知的点击

通知栏消息支持四种点击动作,分别是:打开应用主页、打开应用内页面、打开URI页面 以及 应用客户端自定义,如图。
image
其中前三种打开方式都是SDK内部通过构建 Intent 的方式,再利用 startActivity 方法来调起相应用页面,四种方式都会得到MzPushReceiveronNotificationClicked回调。

5.2.1 打开应用主页 和 打开应用内页面

因为startActivity的逻辑是在 PushSDK 内部,所以它还支持打开 exported 为 false 的内部 Activity,只要在平台上正确配置完整的 Activity 名称即可,比如:com.meizu.pushdemo.TestActivity。

参数传递

打开应用主页 和 打开应用内页面 都支持附加参数。在 PushSDK 内部构造 Intent 时,会解析了平台传递的消息打开类型和参数列表,通过intent.putString("key","value")的方式在构建Intent时进行添加。

参数获取

当跳转到目标 Activity 时,可以通过如下方式获取在平台填写的参数值:

String value = getIntent().getStringExtra("key")

注意: 点击通知栏的时候,除了获取用户自定义的参数,还可以获取平台 taskId 等参数,此参数为 SDK 传递的默认参数,不需在平台配置,如果需要 taskId 相关参数可以通过如下方式获取:

String platformExtra = getIntent().getStringExtra("platform_extra");  

该参数的格式如:

  {"task_id":"123456"}

5.2.2 打开URI

打开URI可支持配置https/http的网页地址,也可支持您应用内部自定义的URI。使用时要特别注意您应用是否全版本支持该 URI,以免造成在旧版本中点击通知栏无效的情况。

5.2.3 客户端自定义

该方式不会触发 startActivity 的逻辑,而只是会在MzPushReceiveronNotificationClicked回调方法的MzPushMessage参数中附带平台上配置的自定义内容,代码如下:

    @Override
    public void onNotificationClicked(Context context, MzPushMessage mzPushMessage) {
        String selfDefineContentString = mzPushMessage.getSelfDefineContentString();
    }

6 历史变更和兼容

魅族推送服务经历几次大的变更,从之前的C2DM,到现在可以完全脱离Flyme平台作为一种完全开放给第三方应用的SDK,在这个阶段出现多种接入方式,给以后的应用接入带来极大的困扰,魅族PushSDK极力在减少Flyme版本迭代给应用接入带来的麻烦,但应用还是需要做细小的更改才能做到与低版本Flyme的兼容。

6.1 订阅和取消订阅接口变更

过去版本中,订阅和取消订阅接口是使用了 PushManager 的以下方法:

register(Context context);
unRegister(Context context);

对应的回调方法是 MzPushReceiver 的以下方法:

onRegister(Context context,String pushId)
onUnRegister(Context context,boolean success)

而目前版本中,订阅和取消订阅接口已经换成了 PushManager 的以下方法:

register(Context context,String appId,String appKey)
unRegister(Context context,String appId,String appKey)

对应的回调方法是 MzPushReceiver 的以下方法:

onRegisterStatus(Context context,RegisterStatus registerStatus)
onUnRegisterStatus(Context context,UnRegisterStatus unRegisterStatus)

注意: 旧接口代码依然保留在SDK中,但已经不再建议使用,如果您还使用着旧接口,建议尽快进行更新。

6.2 设置通知的状态栏小图标

MzPushReceiver 中存在 onUpdateNotificationBuilder(PushNotificationBuilder pushNotificationBuilder)方法。在目前较新的Flyme系统已经不再需要专门进行状态栏图标的设置,此方法仅作用于兼容旧版本Flyme系统中设置消息弹出后状态栏中的自定义小图标。设置小图标代码如下:

@Override
public void onUpdateNotificationBuilder(PushNotificationBuilder pushNotificationBuilder){
    // 旧版本中方法名可能是setmStatusbarIcon
    pushNotificationBuilder.setStatusBarIcon(R.drawable.mz_push_notification_small_icon);
}

6.3 透传功能回调

MzPushReceiver 中存在三个透传功能的回调方法:

onMessage(Context context,Intent intent)
onMessage(Context context,String message)
onMessage(Context context,String message,String platformExtra)

第一个带 Intent 参数的方法,是在Flyme3系统中处理透传消息使用。
第二个带一个 String 方法 和 第三个带两个 String 方法会同时回调透传消息,带三个参数的方法中额外增加一个平台参数,格式如:{"task_id":"1232"}
注意: 目前如果要处理透传消息的回调,只使用onMessage(Context context,String message,String platformExtra)方法即可。

6.4 透传功能停用

透传功能已经停止使用,文档中所有关于接入和介绍透传功能的地方,开发者接入时可以直接忽略。

6.5 声明权限

“接入步骤”的“声明权限”中可见,权限声明分 Flyme3 和 Flyme5 两个部分,按提示接入即可。

6.6 MzPushMessageReceiver action 声明

“接入步骤”的“注册消息接收的广播”中可见,广播注册中兼容 Flyme3 的两个action声明,按提示接入即可。

6.7 通知栏消息点击回调方法

过去版本中,MzPushReceiveronNotificationClicked 方法是:

onNotificationClicked(Context context, String title, String content, String selfDefineContentString)

而目前版本中,方法是:

onNotificationClicked(Context context, MzPushMessage mzPushMessage)

6.8 通知栏消息展示回调方法

过去版本中,MzPushReceiveronNotificationArrived 方法是:

onNotificationArrived(Context context, String title, String content, String selfDefineContentString)

而目前版本中,方法是:

onNotificationArrived(Context context, MzPushMessage mzPushMessage)

7 常见问题

问题1:为什么订阅回调提示AppID不合法?

  1. 请先确定您接入的SDK是Flyme推送还是集成推送(平台地址:http://push.meizu.com/),以及保证跟平台上【配置管理】-【应用配置】页面中,“应用分类”是普通应用 和 AppID、AppKey要和代码中一致(注意前后空格)。
  2. 是否存在过在同一个工程中直接修改过AppID和AppKey进行订阅操作情况?因为应用包名、AppID和AppKey三者是存在唯一绑实关系,如果出现过错误的订阅会导致系统中记录了错误的缓存。解决办法可以在手机【系统设置】-【应用管理】-【所有应用】点击右上角【显示系统服务应用】找到【推送服务】,如下图,对其进行进行“清除数据”, 然后重启手机,待手机启动后再次执行一次正确的订阅操作。
    image

问题2:为什么执行了订阅后一直没有收到广播回调?

  1. 请检查您手机网络是否设置了代理、是否稳定畅通,尝试切换网络后重试。
  2. MzPushMessageReceiver广播中的回调方法里onRegister方法已经废除,正常情况下会在onRegisterStatus方法中回调,请检查是否使用错误。
  3. 请检查接入PushSDK的过程是否存在错误(可参考文档中“接入步骤”),包括:AndroidManifest.xml中权限的声明、广播的定义,广播必须继承MzPushMessageReceiver,如下图。
    image
  4. 不要在您的App中去实现多个MzPushMessageReceiver,因为只会回调其中一个。
  5. 尝试重启手机,待手机启动后再次执行一次订阅操作。

问题3:为什么一直无法收到消息,该如何定位?

  1. 先检查消息是否被放进了通知栏右上角收纳盒子里,如下图红圈位置。一般地当App多次消息到达到都没有对其进行点击,消息就会自动收进收纳盒里。若要恢复,可在收纳盒里长按消息选择“不再收纳”即可。
    image
  2. 请检查应用的“通知消息”权限是否关闭了,步骤如:【手机管理】-【权限管理】-【通知管理】,在应用列表中找到您自己的App,勾上“通知消息”选项。
  3. 请检查手机日期和时间是否正确,错误的时间会影响消息的展示逻辑。
  4. Flyme推送平台后台 【配置管理】-【问题排查】中按从上往下步骤进行相应的状态查询,如下图。
    image
      a) 【设备对应关系查询】输入手机的IMEI点击“查询”按钮获得相应的PushId,若提示“PushId未注册”,请执行PushSDK中PushManager. register(Context context,String appId,String appKey)进行推送订阅;
      b) 【设备是否在线查询】输入刚才获得的PushId,点击“查询”按钮查询状态,若手机处理离线状态,解决方法请见“问题4”
      c) 【设备是否订阅查询】输入刚才获得的PushId,点击“查询”按钮查询订阅信息:
          “是否已经订阅”,若未订阅请执行PushSDK中PushManager. register(Context context,String appId,String appKey)方法进行推送订阅;
          “通知栏开关”,若为关,请执行PushSDK中PushManager.switchPush(Context context,String appId,String appKey,String pushId,int pushType,boolean switcher)方法进行打开;
          “系统通知栏开关”,若为关,解决方法请见“问题5”
      d) 【推送测试】中输入刚才获得的PushId,并点击“推送”按钮,下方显示“已推送 msgId:xxx”代表已经成功发送测试通知。
  5. 弹出消息时是否存在Invalid notification (no valid small icon) 异常日志输出?这是设置通知栏图标异常,如果开启了像AndResGuard之类的资源路径混淆,尝试在whiteList中添加:R.drawable.stat_sys_third_app_notify。
  6. 在较老的Flyme系统也出现Invalid notification (no valid small icon) 异常的话,还可以在drawable不同分辨率文件夹下放置一张名为mz_push_notification_small_icon的图片,并在onUpdateNotificationBuilder回调方法中按文档说明进行设置通知栏小图标。

问题4:为什么手机一直连着网络,但还是显示处于离线状态?

手机离线状态并不是指没连网络,而是手机上推送服务(系统进程)跟推送服务器无法建立长连接,常见于网络不稳动或者开发过程中,可按以下每个步骤进行修复。

  1. 请检查您手机网络是否设置了代理、是否稳定畅通,尝试断开网络再进行重连或者移动网络和Wi-Fi网络互相切换一下,再重试。
  2. 再次执行一次订阅操作,再重试。
  3. 重启手机,再重试。
  4. 查看您手机Flyme版本,对于Flyme5或以下较老的系统若进行以上操作后还是处于离线状态,那么等待几分钟后再重试,同时建议对手机系统进行升级。

问题5:问题排查中,“系统通知栏开关”是关闭状态,该如何打开?

打开您手机中【手机管家】-【权限管理】-【通知管理】,找到您的App,把“通知消息”勾上,然后在手机【系统设置】-【应用管理】-【所有应用】点击右上角【显示系统服务应用】找到【推送服务】,如下图,对其进行“清除数据”,然后重启手机,待手机启动后再次执行一次订阅操作,这样便会触发系统通知栏开关状态的上传,完成操作后再到问题排查中查看状态是否发生变化。
image

问题6:为什么点击消息后,不能打开应用页面?

  1. 先查看输出日志中是否存在:Click message StartActivity error或者android.content.ActivityNotFoundException异常。Flyme推送支持打开内部非对外的Activity,只要在平台上配置好完整的名称即可,同时请确保名称拼写正确以及名称前后不能含有空格等特殊字符。
  2. 再查看输出日志中是否存在:invalid push message错误信息。该情况一般是在点击消息时当前网络环境异常或者App当前是debug版本,请更换到release版本试试,而且要保证点击时手机网络是正常。

问题7:Debug版本正常但在Release版本中报异常是什么原因?

  1. 常见于数据反序列化过程中异常,请检查Release中是否对APK进行了加固或者字符串的混淆之类的操作,如果是请对com.meizu.cloud进行过滤。
  2. 如果您正在使用Android Studio 3.4或以上版本出现该问题,那是因为Android Studio默认开启了R8混淆导致的。解决方法:请在gradle.properties中添加 android.enableR8 = false 进行解决。

问题8:接入PushSDK后编译不过什么原因?/ PushSDK有离线包吗?

如果由于网络或其它原因不能使用jcenter依赖,还可以直接下载AAR包进行手动集成:点击下载

问题9:PushID会在什么场景下发生变化?

手机卸载了App或者App不活跃一个月。

问题10:收到的推送消息可以对其进行删除吗?

不支持使用常规通知栏方法NotificationManager.cancel()删除,但可以使用 PushManager.clearNotification(Context context, int notifyId) 进行删除。

问题11:通知到达后,会收到回调吗?

不一定,当通知到达后且App进程存在的情况下才会收到 MzPushMessageReceiveronNotificationArrived 回调。

问题12:接入PushSDK后,APK会增大多少?

APK会比原来增加一百多K。

问题13:使用透传功能提示超出了限制是什么原因?

已不再支持透传功能。

问题14:推送支持角标设置吗?

不支持。

问题15:推送消息支持自定义提示音吗?

不支持。

问题16:为什么会出现熄屏状态下无法收到通知栏消息?

该异常会在较老的Flyme系统中发生,建议对手机系统进行升级。

8 反馈与建议

请在github上提交 issue 反馈问题,我们会及时处理;提问前请查看之前的issue,不要重复提问。

com.meizu.flyme.internet

Meizu Push Group

魅族推送开放小组, 开源PushSDK Android Studio以及Eclipse版本,服务端提供Java,Node等版本的SDK,同时也提供服务端API接口文档,方便开发者接入!

Versions

Version
3.3.170214
3.3.170123
3.3.170122
3.3.170121