原生移动开发 / 系统课时

用 PendingIntent 处理点击

用 PendingIntent 处理点击

本课解决“通知能显示,但点击后页面不对”的问题。你会把 Intent、PendingIntent 与任务栈连接起来,并处理冷启动、重复点击和已有 Activity 复用,让通知点击最终稳定落到目标页面。

学习目标

  • 理解通知点击为什么需要 PendingIntent,以及它和普通 Intent 的区别。
  • 能为通知配置参数、任务栈和安全的 PendingIntent 标志。
  • 能处理 Activity 已存在时的页面复用和新 Intent 数据更新。

PendingIntent 负责什么

通知通常由系统 UI 展示,用户点击通知时并不是你的代码直接调用某个 Activity,而是系统依据预先提供的 PendingIntent 发起操作。PendingIntent 可以携带一个 Intent,告诉系统应该打开哪个页面、附带哪些业务参数,以及如何与现有任务栈交互。

当通知点击可能直接进入订单详情、消息详情等页面时,核心数据应该放进显式 Intent extras,例如 order_id。不要依赖页面中一次性的临时状态,否则应用被系统回收后,冷启动可能丢失目标信息。

通知点击从 PendingIntent 到目标页面的处理链路

配置任务栈和点击参数

假设通知点击需要打开 OrderDetailActivity,并展示指定订单。下面示例使用 TaskStackBuilder 创建任务栈,并使用 FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE 控制 PendingIntent 的更新和可变性。FLAG_IMMUTABLE 表示创建后不能由其他方修改其内容;如果业务确实需要系统或其他组件填充可变内容,则应按对应 API 契约使用可变 PendingIntent,而不是默认放开可变性。

kotlin
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")
}

预期结果

text
调用 createOrderPendingIntent(context, "<ID>") 后返回一个可用于 NotificationCompat.Builder.setContentIntent() 的 PendingIntent;点击通知时,系统打开 OrderDetailActivity,并携带 order_id=<ID>。实际 ID 应替换为运行时订单 ID。

在通知构建时,把这个 PendingIntent 设置给通知即可:

kotlin
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)

预期结果

text
通知显示后,用户点击通知会进入 OrderDetailActivity,并可从 Intent 中读取 order_id=<ID>;点击通知本身不会要求页面再次手动构造订单参数。

处理冷启动和页面复用

冷启动时,OrderDetailActivity 会执行 onCreate(),因此目标参数应该从 intent 中读取。若应用已经存在目标 Activity,则可以通过 FLAG_ACTIVITY_CLEAR_TOP or FLAG_ACTIVITY_SINGLE_TOP 配合 onNewIntent(),让已有实例接收新的点击参数,而不是无条件创建重复页面。

片段示例:以下代码依赖 OrderDetailActivity 已声明在 AndroidManifest.xml 中,并用于展示页面复用时如何重新处理 Intent。

kotlin
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)
}

预期结果

text
首次从通知进入时,onCreate() 读取 order_id=<ID>;当已有 Activity 被复用并收到新的通知点击时,onNewIntent() 接收新的 order_id=<ID>,页面随后刷新为对应订单。

如果点击不同通知后总是打开同一条旧数据,通常要同时检查 PendingIntent 的身份与更新策略。requestCode、Intent 中的数据以及 FLAG_UPDATE_CURRENT 会共同影响 PendingIntent 的匹配与更新。对于多条业务通知,不要随意让所有通知共享一个无法区分的 request code 和固定参数组合,否则新的业务参数可能覆盖旧通知点击意图。

什么时候该用任务栈

如果通知直接进入应用主页面,可以使用简单的 PendingIntent.getActivity()。当入口页面需要明确的父级关系,或用户点击通知后应获得合理的返回路径时,TaskStackBuilder 更适合表达这种任务栈关系。

实际设计时可以把三件事分开考虑:Intent 描述“去哪以及带什么参数”,PendingIntent 描述“系统以后以什么授权方式执行这个 Intent”,任务栈则描述“页面打开后用户如何继续返回和导航”。把这三层职责分开,通知点击链路会更容易调试和复用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 PendingIntent 处理点击

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通