Android 常见问题

【重要】移动推送 TPNS 产品停止售卖公告

公告

产品功能动态

Android SDK 发布动态

iOS SDK 发布动态

macOS SDK 发布动态

产品动态

产品概述

产品优势

应用场景

全球化部署

产品简介

价格总览

购买指引

计费模式

免费试用

欠费说明

购买指南

创建产品和应用

Android 快速接入

iOS 快速接入

创建推送任务

查询推送记录

推送测试方法指引

产品限制说明

快速入门

排查工具

转化漏斗

推送计划

推送控制

消息回撤

推送管理

标签功能

多包名推送

通知点击跳转

定速推送

通道策略

消息折叠

富媒体通知

个性化通知

账号推送

推送高级功能

操作指南

iOS 平台角标功能实践

实践教程

简介

API 概览

签名认证（推荐）

Basic Auth 认证

请求结构

调用方式

推送接口

创建推送计划接口

号码包上传接口

Token 包上传接口

推送相关接口

标签绑定与解绑

删除标签下所有设备

标签相关接口

账号绑定与解绑

账号设备绑定查询

账号相关接口

推送统计按天聚合统计

设备统计查询

特定时间段所有推送信息查询

单个任务推送信息查询

单条任务推送统计信息查询

多条任务统计数据聚合查询

根据 Token 查询当天所有推送任务

统计相关接口

用户属性相关接口

服务端错误码

服务端 SDK

API（Java）

API 文档

SDK 集成

接口文档

厂商通道接入指南

 厂商通道高级功能

错误码

Android 接入指南

推送证书获取指引

推送环境选择说明

拓展功能

iOS 接入指南

客户端集成插件

推送证书说明

macOS接入指南

SDK 文档

快速入门配置

进阶自定义配置

资源标签

用户及权限

服务等级协议

开发者协议

服务协议

iOS 常见问题

Flutter 常见问题

其他问题

常见问题

移动推送隐私协议

TPNS 数据处理和安全协议

Developer Agreement

移动推送政策

联系我们

词汇表

移动推送

Google Play 应用商店上架时提示“您的应用包含一个隐式 PendingIntent 漏洞”？

移动推送SDK 在代码位置 TPushAlarmManager.set 处使用了一个隐式 PendingIntent，用于触发 SDK 内部心跳。

https://support.google.com/faqs/answer/10437428

 提出的针对建议，移动推送SDK 已进行如下自查：

使用的 setAction 为 SDK 自声明的静态广播 action，无对外暴露风险；

涉及 PendingIntent 的打开目标为 SDK 内部静态广播，且已添加 SDK 内部自声明的广播权限，属于可信任组件。

Google 文档提及 “Fixing this issue is recommended but not mandatory. The publication status of your app will be unaffected by the presence of this issue.”。

综合考虑，移动推送此处当前使用的 PendingIntent 为可信任安全 PendingIntent，且 Google 提示的此项内容不会影响您的应用上架。当前您可以忽视此项提示，继续上架您的应用。

使用自定义铃声可以通过创建通知渠道实现：

创建通知渠道，通过移动推送封装 API 或安卓原生 API 创建指定自定义铃声文件的通知渠道，可参考 

https://intl.cloud.tencent.com/document/product/1024/30715

在移动推送推送 REST API 指定相同的通知渠道

进行推送,厂商通道需指定厂商渠道 ID，如华为通道需指定

目前仅华为、小米、FCM 和移动推送自建通道支持自定义铃声。

部分厂商推送通道使用通道渠道需要先进行通知分类权限申请，相关说明和申请步骤可参见 

https://intl.cloud.tencent.com/document/product/1024/36250

针对华为推送通道，如果您的应用在华为推送控制台申请开通华为推送服务时，选择的数据处理位置为中国区，自定义渠道功能将不再适用于您的应用，即不支持利用通知渠道能力进行通知铃声自定义，详见 

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-custom-chan-0000001050040122

如何关闭移动推送的保活功能？

如需关闭联合保活功能，请在应用初始化的时候，例如 Application 或 LauncherActivity 的 onCreate 中调用如下接口，并传递 false 值：

仅 1.1.6.0 之后版本支持关闭联合保活功能，1.1.6.0之前版本移动推送默认开启联合保活能力，且不可关闭。

XGPushConfig.enablePullUpOtherApp(Context context, boolean pullUp);

若您使用 gradle 自动集成方式，请在自身应用的 AndroidManifest.xml 文件 <application> 标签下配置如下结点，其中 

 为任意自定义名称；如果使用手动集成方式，请修改如下节点属性：

         android:name="com.tencent.android.tpush.XGPushProvider"

         tools:replace="android:authorities"

         android:authorities="应用包名.xxx.XGVIP_PUSH_AUTH"

若控制台有以下日志打印，则表明联合保活功能已经关闭：

I/TPush: [ServiceUtil] disable pull up other app

首次安装启动时如何配置不自动启动推送服务？

针对“用户同意隐私服务协议” 场景，开发者可以在 AndroidManifest.xml 文件添加以下节点，应用首次安装启动时即不会自启推送服务，直到调用了推送服务注册接口

移动推送SDK 支持鸿蒙系统的推送吗？

鸿蒙系统完全兼容 Android SDK，推送功能可正常使用。

厂商推送服务需要上架应用市场才可以开通吗？

集成 vivo 厂商通道后 “APP 包含未使用的权限字符串”，如何处理？

开发者在集成 vivo 厂商通道推送服务后，部分安全检测工具可能会提示 “APP 包含未使用的权限字符串”，详情如下： 
问题来源：vivo 厂商通道推送 SDK 版本名 2.3.4。
涉及类文件：com.vivo.push.util.z 涉及敏感权限字符串：android.permission.GET_ACCOUNTS。

 经检查发现最新的 vivo 厂商通道推送 SDK 版本名 3.0.0.3 中同样包含此问题。

问题代码来源为 vivo 厂商通道推送 SDK，移动推送项目组无法变更其内容；此问题已向 vivo 推送服务相关人员反馈，表示相关静态字段为 SDK 遗留代码，并无实际使用，会尽快排期修复。 当前可参考的快速解决办法如下：

方式一（推荐）： 在《APP隐私声明》里增加 

https://intl.cloud.tencent.com/document/product/1024/30713

方式二（不推荐）： 剔除掉 vivo 相关 jar 包，但是也会丧失掉 vivo 厂商通道的能力。

移动推送自建通道是移动推送的自建通道，依赖移动推送Service 在线（与移动推送后台服务器保持长连接）才能下发消息，因此移动推送自建通道的实际发送一般比其他厂商通道的数据要低。

如果需要实现离线推送，建议集成厂商通道，请参见 

https://intl.cloud.tencent.com/document/product/1024/37176

为何关闭应用后，无法收到推送？

目前第三方推送都无法保证关闭应用后仍可收到推送消息，该问题为手机定制 ROM 对移动推送 Service 的限制问题，移动推送的移动推送自建通道推送，需要建立在移动推送的 Service 能够与移动推送后台服务器保持长连接，Service 被终止后，需由系统、安全软件和用户操作决定是否能够再次启动。

移动推送的 Service 和移动推送的服务器断开连接后，此时给这个设备下发的消息，将变成离线消息，离线消息最多保存72小时，每个设备最多保存三条，如果有多条离线消息，只保留最新的三条消息。在关闭应用期间推送的消息，如开启应用无法收到，请检查是否调用了反注册接口：XGPushManager.unregisterPush

如果已经集成厂商通道，但是仍收不到离线推送，请先在 

https://console.tencentcloud.com/tpns/user-tools

 上查询该 Token 是否已经注册上厂商通道，如果未注册成功，请参见 

https://intl.cloud.tencent.com/document/product/1024/37006

QQ 和微信是系统级别的应用白名单，相关的 Service 不会因为关闭应用而退出，所以用户感知推出应用过后，仍可收到消息，但相关的 Service 仍能够在后台存活。

新创建的 App 会有一分钟左右的数据同步过程，在此期间，注册可能返回20错误码，稍后重试即可。

：Access ID 和 Access Key 是否正确配置，常见错误是误用 Secret key ，或者 Access key 头尾有空格。

：若控制台返回10004、10002、20等错误码，请参见 

https://intl.cloud.tencent.com/document/product/1024/30722

：确认当前网络情况是否良好，建议使用4G网络测试，Wi-Fi 由于使用人数过多可能造成网络带宽不足。

：在2015年下半年和2016年出的机器均无法注册，具体机型包括 Nubia Z11 系列，NubiaZ11S 系列，NubiaZ9S 系列。

为何注册成功，无法收到推送？

https://intl.cloud.tencent.com/document/product/1024/38389

 使用排查工具进行自动化排查，一般有如下错误：

请查看当前应用包名，是否与注册移动推送应用时填写的应用包名不一致。如果不一致，推送时，建议开启多包名推送。

检查手机网络是否异常，切换4G网络，进行测试。

（透传消息），通知栏消息可以展示到通知栏，应用内消息不能展示到通知栏。

确认手机当前模式是正常模式，部分手机在低电量，勿扰模式，省电模式下，会对后台移动推送进程进行一系列网络和活动的限制。

查看设备是否开启通知栏权限，OPPO，vivo 等手机，需要手动开启通知栏权限。

不支持2015年后发布的努比亚机型，因为努比亚新的系统版本增加了超级省电的功能（会迅速将后台进程停止），移动推送 Service 无法启动，所以努比亚机型无法注册成功。

在非华为手机上安装了华为移动服务，且在 App 中集成了移动推送SDK，会导致华为推送及其它组件功能失效，如何解决？

自移动推送SDK 1.1.6.3 版本起，为避免

在非本品牌手机上、其他品牌的推送服务在后台自启、传输用户数据

，会在非本品牌手机上禁用其他品牌的推送服务组件。
华为在账号、游戏、推送等不同功能上有一些公共组件，移动推送禁用推送组件可能会导致其它服务功能在非华为品牌手机上同样不能启动；若您需要关闭此禁用功能，可配置以下内容：
在 AndroidManifest.xml 文件 application 标签下添加节点配置，并重装应用（需卸载后重装）。

        android:name="tpns-disable-component-huawei-v2"

        android:name="tpns-disable-component-huawei-v4"

当订阅者点击您的通知时，可以根据您的配置跳转至指定的应用内页面、H5、Deeplink 等，来满足您在不同场景下的需求。详情请参见 

https://intl.cloud.tencent.com/document/product/1024/38354

终端内厂商通道支持哪些通知事件回调？

 厂商通道的点击回调需 SDK 版本1.2.0.1及以上版本支持；旧版本仅支持华为、小米、魅族、vivo。

为什么关闭应用时，onNotifactionClickedResult、onNotificationShowedResult 获取的 title 和 content 为空？

如需在厂商离线推送场景下获取推送的 title 和 content，请通过在通知点击跳转的 intent uri 上拼接一份 title 和 content 内容参数，并在通知点击后获取。详情请参见 

应用接入了厂商通道，但在调试过程中遇到 other push Token 为空的问题，如何解决？

在应用运行日志中观察到如下类似日志： 

[OtherPushClient] handleUpdateToken other push token is :  other push type: huawei

表示您的应用注册该厂商通道失败，您可以通过获取厂商通道注册失败的返回码来进行问题定位和排查，详情请参见 

谷歌原生 Android 5.0 以上的 ROM 都会对 target sdk 大于等于21的 App 的小图标进行处理，增加一层颜色，导致图标变灰。

若需要显示颜色效果，可以将 target sdk 设成低于21；如果并不想将 target sdk 设成低于21，可以将一张背景透明的 png 格式小图片名称改成 notification_icon.png（资源名称不能被混淆），并放在 drawable 目录下，该方式显示的小图标即可为灰色（但是图标有形状）。

移动推送 Android SDK 1.2.2.0 起，默认情况下 notification_icon.png 小图标资源将仅在谷歌 Pixel 手机上直接生效；其他品牌手机若需实现此类自定义通知小图标效果，还需指定推送 API 字段 message.android.small_icon 为资源文件名称（不带文件后缀）；同时自定义通知小图标支持染色为单一纯色，需指定推送 API 字段 message.android.icon_color 为 RGB 颜色的十进制值。

推送 API 字段设置示例如下，其中 icon_color: 123456，即为 RGB 颜色 #01e240：

            "small_icon": "notification_icon",

建议参考 Demo logo 图标进行作图

https://git.code.tencent.com/tpns/tpns-Demo-Android/blob/master/app/src/main/res/drawable/notification_icon.png

small icon 必须是带 Alpha 透明通道的 PNG 图片。

tencent cloud