Android常见问题

无法获取ClientID（CID）

排查步骤如下：

• 确认手机LOG日志开关是否开启？

• 确认打包是否屏蔽logcat日志输出？

• 确认pushservice进程有没有起来？—— 没起来基本上是集成问题，关注Log.e日志输出；

• 用libgetuiext3.so替换libgetuiext2.so；

• 确认手机网络是否通畅？是否是手机内网连服务器外网环境？可以强制停止一下应用再开启或切换一下网络，检查是否有端口限制 5225 5226 5227；

• 对照集成文档检查集成步骤；

• 确保以上步骤都没问题，请联系技术支持。

无法获取厂商deviceToken

排查步骤如下：

• 对照集成文档步骤 务必仔细检查！！

• 手机LOG日志开关是否开启？

• 打包是否屏蔽logcat日志输出？

• 个推、厂商相关组件是否都在同一进程？

• 打开logcat查看信息，Verbose级日志，tag过滤内容“Assist_”，Filter选择“No Filters”；

• 将结果发给个推技术支持。

Intent无法跳转

排查步骤如下：

• 本地先验证该Intent是否能够正常跳转；

• Intent建议使用Android自带API：Intent.toURI() 生成；

• 特殊字符请使用UrlEncode编码。

发送消息后接收不到

排查步骤如下：

• 请先确定clientid能正常回调IntentService；
• IntentService需要在AndroidManifest.xml中的节点配置permission属性，详见集成文档。

发送通知后无法展示

排查步骤如下：

• 请先确定clientid获取成功；
• 通知标题和内容不能包含测试字眼，如“个推”、“test”等；
• 打开应用通知开关。

客户端接收到透传消息后为何立即打开了应用

• 代码推送：查看一下服务端代码TransmissionType设置的参数，参数为1时是强制启动应用，2是等待客户端处理；将该参数设置修改为2，将不立即打开应用。
• 平台推送：查看一下安卓设置里面，强制启动应用设置的是否为开启，设置为关闭后，将不立即打开应用。

ClientID在哪些情况下会改变

（1）用户超过三个月未登录，之后再登录会重新生成一个CID；

（2）卸载应用，且再次调用个推初始化时无外部存储读写权限；

（3）应用的包名修改。

Tag设置失败

请在clientid获取成功后，再调用setTag()。

Android 5.0个推自定义权限冲突?

• 目前有许多客户在Android 5.0系统上接入个推SDK时，会发现如果其他集成个推SDK的应用已经安装在手机，此应用就不能再安装上去，会出现权限冲突。
  报错信息如下：

  STALL_FAILED_DUPLICATE_PERMISSION perm=getui.permission.GetuiService pkg=你的应用包名]
  

  对此个推对权限配置做了如下修改

  <permission
      android:name="getui.permission.GetuiService.你的应用包名"
      android:protectionLevel="normal" >
  

第三方系统管理软件限制收不到推送

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

EMUI OS（华为）

• 自启动管理：需要把应用加到【自启动管理】列表，否则杀进程或重新开机后进程不会开启，只能手动开启应用

  

• 后台应用保护：需要手动把应用加到此列表，否则设备进入睡眠后会自动杀掉应用进程，只有手动开启应用才能恢复运行

  

• 通知管理：应用状态有三种：提示、允许、禁止。禁止应用则通知栏不会有任何提醒

Flyme OS（魅族）

• 自启动管理：需要把应用加到【自启动管理】列表，否则杀进程或重新开机后进程无法开启

  

• 通知栏推送：关闭应用通知则收到消息不会有任何展示

Funtouch OS（VIVO）

• 自启动管理：需要将应用加入“i管家”中的【自启动管理】列表，否则重启手机后进程不会自启。但强制手动杀进程，即使加了这个列表中，后续进程也无法自启动。

Color OS（OPPO）

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

MIUI OS (小米)

• 自启动管理：需要把应用加到【自启动管理】列表，否则杀进程或重新开机后进程无法开启

  

• 省电策略：需要禁用应用省电策略，否则后台几分钟后会被系统限制联网

  

• MIUI 7 神隐模式： 允许用户设置后台联网应用，开启后应用即可在后台保持联网，否则应用进入后台时，应用无法正常接收消息。【设置】->【电量和性能】->【神隐模式】