Android SDK FAQ

为什么应用程序无法收到 Push 消息（Android）？

  • 确认 appKey（在 Portal 上生成的）已经正确的写入 Androidmanifest.xml
  • 确认测试手机（或者模拟器）已成功连入网络
  • 确认有客户端 “Login succeed” 日志

日志：Java.lang.UnsatisfiedLinkError

  1. E/art: No implementation found for int cn.jiguang.service.Protocol.GetSdkVersion() (tried Java_cn_jiguang_service_Protocol_GetSdkVersion and Java_cn_jiguang_service_Protocol_GetSdkVersion__)
  2. E/JIGUANG-JCore: [JCoreGlobal] Get sdk version fail![获取sdk版本失败!]
  3. W/System.err: java.lang.UnsatisfiedLinkError: No implementation found for int cn.jiguang.service.Protocol.GetSdkVersion() (tried Java_cn_jiguang_service_Protocol_GetSdkVersion and Java_cn_jiguang_service_Protocol_GetSdkVersion__)
  4. W/System.err:     at cn.jiguang.service.Protocol.GetSdkVersion(Native Method)
  5. W/System.err:     at cn.jiguang.d.a.a(Unknown Source)
  6. W/System.err:     at cn.jiguang.d.a.d(Unknown Source)
  7. W/System.err:     at cn.jiguang.d.a.b(Unknown Source)
  8. W/System.err:     at cn.jiguang.api.JCoreInterface.init(Unknown Source)
  9. W/System.err:     at cn.jiguang.d.d.j.b(Unknown Source)
  10. W/System.err:     at cn.jiguang.api.JCoreInterface.triggerSceneCheck(Unknown Source)
  11. W/System.err:     at cn.jiguang.a.a.d.a.onActivityStarted(Unknown Source)
  12. E/JIGUANG-JCore: [JCoreGlobal] JCore .so file do not match JCore .jar file in the project, Failed to init JCore
  13. W/JIGUANG-JCore: [JCoreInterface] JCore init failed


此错误是由于没有正确的加载 libjcore.so 文件，请检查 libjcore.so 是否在正确的位置(libs–>armeabi–>libjcore.so)

JPush SDK 迁移到 Android Studio 需要添加 .so 文件打包到 APK 的 lib 文件夹中，可以编辑 build.gradle 脚本，自定义 *.so 目录，参考 Demo：

jpush_android_so

日志：The permission should be defined

  1. E/JIGUANG-JCore: [AndroidUtil] The permissoin is required - com.jpush.test.permission.JPUSH_MESSAGE
  2. E/JIGUANG-JCore: [AndroidUtil] The permission should be defined - com.jpush.test.permission.JPUSH_MESSAGE
  3. W/JIGUANG-JCore: [JCoreInterface] JCore init failed

此错误是没有正确的定义 permision，请添加权限：

  1.     <permission
  2.         android:name="您应用的包名.permission.JPUSH_MESSAGE"
  3.         android:protectionLevel="signature" />
  5.     <uses-permission android:name="您应用的包名.permission.JPUSH_MESSAGE" />


如何在代码时混淆忽略 jpush-sdk-release.jar

  • 请下载 4.x 及以上版本的 proguard.jar， 并替换你 Android SDK “tools\proguard\lib\proguard.jar”

  • 开发工具使用 Eclipse 或者 Android Studio，请在工程的 project.properties 中配置好 proguard-android.txt，并且在 proguard-android.txt 配置：

    1.   -dontoptimize
    2.   -dontpreverify
    4.   -dontwarn cn.jpush.**
    5.   -keep class cn.jpush.** { *; }

  • 请使用 SDK1.3.X 及以后的版本

  • v2.0.5 及以上的版本由于引入了 protobuf ，在上面基础之上增加排出混淆的配置。

  1.     #==================gson==========================
  2.     -dontwarn com.google.**
  3.     -keep class com.google.gson.** {*;}
  5.     #==================protobuf======================
  6.     -dontwarn com.google.**
  7.     -keep class com.google.protobuf.** {*;}


推送成功了，为什么有部分客户端收不到推送？

请检查收不到通知的手机：

  • 请在 logcat 查看日志，确定客户端的 jpush 是否集成成功，网络是否有问题
  • 请看日志或使用接口 isPushStopped 来检查是否调用了 stoppush
  • 检查手机的 JPush 高级设置中是否设置了“允许推送时间”
  • 手机的应用中是否勾选了“显示通知”


什么是通道共享功能？需要怎么使用？

极光的通道共享功能是利用极光 SDK 的高覆盖率，将各个应用中的长连接通道共享化，可以解决以下问题：

  • APP（均需要集成极光 SDK ）进程间交互有效的情况下，针对某应用被杀死之后，极光也能通过共享通道将消息有效的下发到设备端并将该应用拉起。
  • 某应用处于后台时，如果被系统关闭网络后，无法及时收到消息；此时可以从共享通道正常将下发下发到SDK，保证消息及时性。

使用方式：

  • 集成好极光的 SDK （SDK 版本 3.1.6 及以后版本）以后，即可使用通道共享功能。
    共享通道在启动时会扫描一遍手机上的其他应用，并拉起相关应用，即被杀死的 App 会被其他启动应用拉起，你的 App 启动也将拉起其他被杀死的应用。如果需要关闭该功能，将 Androidmanifest 中 downloadprovider 的 android:exported 设为 false 即可


如果APP不想被其它应用拉起也不拉起其它应用怎么办？

由于 Android 应用进程常被杀死导致长连接断开收不到消息，极光提供了拉起杀死应用的功能，从而保证 Android 消息的到达率。

  • 集成 JPush SDK 1.8.0 及以上 版本，默认有配置不同应用间的 JPush 服务相互拉起的功能。
  • 集成 JPush SDK 3.1.6 及以上版本，默认有配置通道共享功能，该功能也会相互拉起应用。
  • 如需关闭拉起服务，可在 Androidmanifest 中做如下操作：
    • 将 DaemonService 组件的 enabled 设置成 false：此时您的 App 不会被其他 App 拉起，但会拉起其他的 App； 如果您还希望达到不拉起其它 App 的效果，请请联系商务开通 VIP 服务，极光 VIP 用户可以提供此功能支持。
    • 将 DownloadProvider 的 android:exported 设为 false ：即可关闭通道共享功能


第三方系统收不到推送的消息

由于第三方 ROM 的管理软件需要用户手动操作

  • 小米【 MIUI 】

    • 自启动管理：需要把应用加到【自启动管理】列表，否则杀进程或重新开机后进程无法开启
    • 通知栏设置：应用默认都是显示通知栏通知，如果关闭，则收到通知也不会提示
    • 网络助手：可以手动禁止已安装的第三方程序访问 2G/3G 和 WIFI 的网络和设置以后新安装程序是否允许访问 2G/3G 和 WIFI 的网络
    • MIUI 7 神隐模式： 允许应用进行自定义配置模式，应用在后台保持联网可用，否则应用进入后台时，应用无法正常接收消息。【设置】下电量和性能中【神隐模式】

  • 华为【 Emotion 】

    • 自启动管理：需要把应用加到【自启动管理】列表，否则杀进程或重新开机后进程不会开启，只能手动开启应用
    • 后台应用保护：需要手动把应用加到此列表，否则设备进入睡眠后会自动杀掉应用进程，只有手动开启应用才能恢复运行
    • 通知管理：应用状态有三种：提示、允许、禁止。禁止应用则通知栏不会有任何提醒

  • 魅族【 Flyme 】

    • 自启动管理：需要把应用加到【自启动管理】列表，否则杀进程或重新开机后进程无法开启
    • 通知栏推送：关闭应用通知则收到消息不会有任何展示
    • 省电管理： 安全中心里设置省电模式，在【待机耗电管理】中允许应用待机时，保持允许，否则手机休眠或者应用闲置一段时间，无法正常接收消息。

  • VIVO【 Funtouch OS 】

    • 内存一键清理：需要将应用加入【白名单】列表，否则系统自带的“一键加速”，会杀掉进程
    • 自启动管理：需要将应用加入 “i 管家”中的【自启动管理】列表，否则重启手机后进程不会自启。但强制手动杀进程，即使加了这个列表中，后续进程也无法自启动。

  • OPPO【 ColorOS 】

    • 冻结应用管理：需要将应用加入纯净后台，否则锁屏状态下无法及时收到消息
    • 自启动管理：将应用加入【自启动管理】列表的同时，还需要到设置-应用程序-正在运行里锁定应用进程，否则杀进程或者开机后进程不会开启，只能手动开启应用
  • 三星
    • 内存一键优化：需要将应用加入【白名单】列表，否则系统内存优化后，会杀掉应用进程


Android 5.0 系统报错：INSTALL_FAILED_DUPLICATE_PERMISSION

与 5.0 的多账户系统有关，其中一个账号安装一个应用，其他账号也会自动安装了这个应用；如果其中一个账号卸载了这个应用，那其他账号是不受影响的（其他账号仍有这个应用），所以如果在某个账号下卸载了应用，安装一个同包名但是签名不一致的包，就会安装失败了。

解决办法：在各个账户上的安装这个程序的应用卸载，然后重新安装即可解决这个问题。


AsyncTask 就没办法执行到 onPostExecute() 方法

这是 Android 旧系统带有的问题，解决办法如下：

在 application 里 onCreate 方法加上：

  1. try {
  2.             Class.forName("android.os.AsyncTask");
  3.         } catch (ClassNotFoundException e) {
  4.             e.printStackTrace();
  5.         }

详情请看链接：https://code.google.com/p/android/issues/detail?id=20915


Tag、Alias、Registration ID 需要每次初始化时都重新设置吗，会变化吗？

  • tag、alias 可以参考别名与标签 API 进行设置，3.0.7 版本以前的接口每次设置是覆盖设置，而不是增量设置；从 3.0.7 版本开始，对别名标签提供增删改查接口。Tag 和 alias 一经设置成功，除非取消或覆盖，是不会变化的。设置好的 tag、alias 与客户端的对应关系保存在 JPush 服务器，目前没有从 JPush 服务器查询这个对应关系的接口，所以需要客户将对应关系保存在 APP 应用服务器。

  • Registration ID 是客户端 SDK 第一次成功连接到 JPush 服务器时，JPush 服务器给分配的。可以通过获取 RegistrationID API 来获取 Registration ID 进行推送。Registration ID 对应一个应用的一个客户端，Android 的 registration ID 一般不会改变。


没有沙箱 API 怎么测试？

直接用 JPush 的 API 测试就行。


其他国家能否使用极光推送（局域网能否使用极光推送）？

只要能连网到 JPush 服务器都可以。判断能否联网到 JPush 服务器的方法：ping 通 api.jpush.cn 443


为什么发送推送提示没有任何设备或调用 API 返回 1011

Android SDK FAQ - 图2

这可能有如下几种情况：

  • SDK 没有集成成功，客户端有 “Login succeed” 日志、获取到了 registration ID 才表示 SDK 集成成功。
  • 广播推送有 10 分钟延迟，在第一个设备初始化成功后立即进行广播推送会报错。
  • 设置别名或标签失败，请注意查看设置别名标签的回调结果，从 3.0.7 版本开始，新接口是异步回调，需要在 Androidmanifest 里面配置自定义广播接收器，参考错误码定义来修改直到设置成功返回 0。
  • 所传的 registration ID 对应的客户端所配的 Appkey 与推送使用的 Appkey 不一致。


可以打开 www.jiguang.cn，但打不开 docs，提示无法找到 docs.jiguang.cn

  • 换个浏览器试试
  • 如果还是不行，执行下面的命令反馈结果排查一下问题
    • ping docs.jiguang.cn
    • nslookup docs.jiguang.cn
    • telnet docs.jiguang.cn
    • 检查一下自己机器访问外网其他网站是否正常


appkey 是怎么对应的？

一个 Appkey 只允许配置一个包名，Appkey 和包名在极光唯一确定一个应用。


内网使用极光推送应该怎么设置？

内网使用极光推送需要服务器开放下列端口限制，用于 JPush 的登录注册及保持推送长链接：

  • 19000
  • 3000-3020
  • 7000-7020
  • 8000-8020