原生移动开发 / 系统课时
用 PendingIntent 处理点击
用 PendingIntent 处理点击
本课解决“通知能显示,但点击后页面不对”的问题。你会把 Intent、PendingIntent 与任务栈连接起来,并处理冷启动、重复点击和已有 Activity 复用,让通知点击最终稳定落到目标页面。
学习目标
- 理解通知点击为什么需要
PendingIntent,以及它和普通Intent的区别。 - 能为通知配置参数、任务栈和安全的
PendingIntent标志。 - 能处理 Activity 已存在时的页面复用和新 Intent 数据更新。
PendingIntent 负责什么
通知通常由系统 UI 展示,用户点击通知时并不是你的代码直接调用某个 Activity,而是系统依据预先提供的 PendingIntent 发起操作。PendingIntent 可以携带一个 Intent,告诉系统应该打开哪个页面、附带哪些业务参数,以及如何与现有任务栈交互。
当通知点击可能直接进入订单详情、消息详情等页面时,核心数据应该放进显式 Intent extras,例如 order_id。不要依赖页面中一次性的临时状态,否则应用被系统回收后,冷启动可能丢失目标信息。

配置任务栈和点击参数
假设通知点击需要打开 OrderDetailActivity,并展示指定订单。下面示例使用 TaskStackBuilder 创建任务栈,并使用 FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE 控制 PendingIntent 的更新和可变性。FLAG_IMMUTABLE 表示创建后不能由其他方修改其内容;如果业务确实需要系统或其他组件填充可变内容,则应按对应 API 契约使用可变 PendingIntent,而不是默认放开可变性。
package com.example.notifications
import android.app.PendingIntent
import android.content.Intent
import androidx.core.app.TaskStackBuilder
fun createOrderPendingIntent(context: android.content.Context, orderId: String): PendingIntent {
val detailIntent = Intent(context, OrderDetailActivity::class.java).apply {
putExtra("order_id", orderId)
}
// 通过任务栈让目标详情页拥有明确的返回路径。
val stack = TaskStackBuilder.create(context).apply {
addNextIntentWithParentStack(detailIntent)
}
return stack.getPendingIntent(
orderId.hashCode(),
PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
) ?: error("Unable to create PendingIntent")
}预期结果
调用 createOrderPendingIntent(context, "<ID>") 后返回一个可用于 NotificationCompat.Builder.setContentIntent() 的 PendingIntent;点击通知时,系统打开 OrderDetailActivity,并携带 order_id=<ID>。实际 ID 应替换为运行时订单 ID。在通知构建时,把这个 PendingIntent 设置给通知即可:
val pendingIntent = createOrderPendingIntent(this, "<ID>")
val notification = NotificationCompat.Builder(this, CHANNEL_ID)
.setSmallIcon(R.drawable.ic_stat_notification)
.setContentTitle("订单已更新")
.setContentText("点击查看订单详情")
.setContentIntent(pendingIntent)
.setAutoCancel(true)
.build()
NotificationManagerCompat.from(this).notify(1001, notification)预期结果
通知显示后,用户点击通知会进入 OrderDetailActivity,并可从 Intent 中读取 order_id=<ID>;点击通知本身不会要求页面再次手动构造订单参数。处理冷启动和页面复用
冷启动时,OrderDetailActivity 会执行 onCreate(),因此目标参数应该从 intent 中读取。若应用已经存在目标 Activity,则可以通过 FLAG_ACTIVITY_CLEAR_TOP or FLAG_ACTIVITY_SINGLE_TOP 配合 onNewIntent(),让已有实例接收新的点击参数,而不是无条件创建重复页面。
片段示例:以下代码依赖 OrderDetailActivity 已声明在 AndroidManifest.xml 中,并用于展示页面复用时如何重新处理 Intent。
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
handleIntent(intent)
}
override fun onNewIntent(intent: Intent) {
super.onNewIntent(intent)
setIntent(intent)
handleIntent(intent)
}
private fun handleIntent(intent: Intent) {
val orderId = intent.getStringExtra("order_id") ?: return
// 根据新的订单 ID 刷新当前详情页,而不是沿用旧页面参数。
loadOrder(orderId)
}预期结果
首次从通知进入时,onCreate() 读取 order_id=<ID>;当已有 Activity 被复用并收到新的通知点击时,onNewIntent() 接收新的 order_id=<ID>,页面随后刷新为对应订单。如果点击不同通知后总是打开同一条旧数据,通常要同时检查 PendingIntent 的身份与更新策略。requestCode、Intent 中的数据以及 FLAG_UPDATE_CURRENT 会共同影响 PendingIntent 的匹配与更新。对于多条业务通知,不要随意让所有通知共享一个无法区分的 request code 和固定参数组合,否则新的业务参数可能覆盖旧通知点击意图。
什么时候该用任务栈
如果通知直接进入应用主页面,可以使用简单的 PendingIntent.getActivity()。当入口页面需要明确的父级关系,或用户点击通知后应获得合理的返回路径时,TaskStackBuilder 更适合表达这种任务栈关系。
实际设计时可以把三件事分开考虑:Intent 描述“去哪以及带什么参数”,PendingIntent 描述“系统以后以什么授权方式执行这个 Intent”,任务栈则描述“页面打开后用户如何继续返回和导航”。把这三层职责分开,通知点击链路会更容易调试和复用。