Android 12 (API 31) 通知操作失效问题及解决方案

本文深入探讨了在android 12 (api 31) 及更高版本中，通知操作按钮失效的问题及其解决方案。核心在于理解 `pendingintent` 标志的更新要求，即必须明确指定 `flag_immutable` 或 `flag_mutable`。文章提供了具体的代码示例，展示如何根据android版本动态调整 `pendingintent` 的创建方式，并讨论了相关的权限配置和最佳实践，以确保应用在最新android版本上的通知功能正常且安全。

在开发Android应用时，通知（Notification）是与用户交互的重要方式之一，尤其是在实时通信或需要用户立即响应的场景中。然而，随着Android系统版本的迭代，特别是从Android 12 (API 31) 开始，系统对 PendingIntent 的行为引入了严格的变更，这可能导致原有的通知操作按钮在这些新版本上失效。本文将详细解析这一问题，并提供一套完整的解决方案。

Android 12 (API 31) 中 PendingIntent 的行为变更

从Android 12 (API 31) 开始，Android系统强制要求在创建 PendingIntent 时必须明确指定其可变性。这意味着，开发者必须使用 FLAG_IMMUTABLE 或 FLAG_MUTABLE 中的一个标志。

• FLAG_IMMUTABLE (推荐): 表示创建的 PendingIntent 是不可变的。一旦创建，其内部的 Intent 无法被修改。这提供了更好的安全性，因为系统可以保证在 PendingIntent 发送后，其目标 Intent 不会被恶意修改。对于大多数通知操作，如启动一个特定的Activity或发送一个固定的广播，FLAG_IMMUTABLE 是首选。
• FLAG_MUTABLE: 表示创建的 PendingIntent 是可变的。这意味着其内部的 Intent 可以在稍后被修改（例如，通过 fillIn() 方法）。如果你的应用确实需要在 PendingIntent 发送后修改其 Intent 的额外数据，则必须使用此标志。然而，使用 FLAG_MUTABLE 需要谨慎，因为它可能引入安全风险，如果 PendingIntent 落入恶意应用之手，它们可能会修改其内容并执行未经授权的操作。

如果未指定这两个标志中的任何一个，系统将抛出 IllegalArgumentException，或者在某些情况下， PendingIntent 会直接失效，导致通知操作按钮无响应。

解决方案：动态调整 PendingIntent 标志

为了兼容不同版本的Android系统，我们需要在创建 PendingIntent 时，根据当前的SDK版本动态地添加 FLAG_IMMUTABLE 标志。

以下是针对通知操作中 PendingIntent 的修改示例：

import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.os.Build;
import androidx.annotation.NonNull;
import androidx.core.app.NotificationCompat;

// ... 在你的FirebaseService.java 或其他处理通知的类中 ...

// 假设 receiveCallAction 和 cancelCallAction 是已经准备好的 Intent 对象

PendingIntent receiveCallPendingIntent;
PendingIntent cancelCallPendingIntent;

// 针对 Android 12 (API 31) 及更高版本，必须添加 FLAG_IMMUTABLE 或 FLAG_MUTABLE
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    // 对于大多数通知操作，FLAG_IMMUTABLE 是更安全且推荐的选择
    receiveCallPendingIntent = PendingIntent.getBroadcast(this, 1200, receiveCallAction, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT);
    cancelCallPendingIntent = PendingIntent.getBroadcast(this, 1201, cancelCallAction, PendingIntent.FLAG_IMMUTABLE | PendingIntent.FLAG_UPDATE_CURRENT);
} else {
    // 对于 Android 12 以下的版本，FLAG_UPDATE_CURRENT 仍然适用
    receiveCallPendingIntent = PendingIntent.getBroadcast(this, 1200, receiveCallAction, PendingIntent.FLAG_UPDATE_CURRENT);
    cancelCallPendingIntent = PendingIntent.getBroadcast(this, 1201, cancelCallAction, PendingIntent.FLAG_UPDATE_CURRENT);
}

// 将修改后的 PendingIntent 添加到通知构建器中
notificationBuilder
        .addAction(R.drawable.ic_baseline_call_24_green, "接听", receiveCallPendingIntent)
        .addAction(R.drawable.ic_baseline_call_red_24, "拒绝", cancelCallPendingIntent);

// ... 其他通知构建逻辑 ...

代码解析：

智谱AI开放平台

智谱AI大模型开放平台-新一代国产自主通用AI开放平台

85

查看详情

1. 版本检查: if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) 用于判断当前设备是否运行在 Android 12 (API 31) 或更高版本。
2. 添加 FLAG_IMMUTABLE: 如果是 Android 12 及更高版本，我们通过位或操作符 | 将 PendingIntent.FLAG_IMMUTABLE 与 PendingIntent.FLAG_UPDATE_CURRENT 结合。FLAG_UPDATE_CURRENT 仍然有用，它指示如果 PendingIntent 已经存在，则更新其额外数据。
3. 兼容旧版本: 对于低于 Android 12 的版本，我们保持原有的 PendingIntent.FLAG_UPDATE_CURRENT 即可，无需添加新的可变性标志。

清单文件 (AndroidManifest.xml) 配置考虑

除了 PendingIntent 标志的修改，针对像通话应用这类需要特殊权限和后台运行能力的场景，还需要在 AndroidManifest.xml 中进行相应的配置。

1. 权限声明

确保你的应用声明了必要的权限。虽然 PendingIntent 标志的修改是核心，但以下权限在特定场景下可能也很重要：

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<!-- 其他必要的权限，如 INTERNET, FOREGROUND_SERVICE 等 -->

• android.permission.SYSTEM_ALERT_WINDOW: 如果你的应用需要在其他应用之上显示悬浮窗（例如，来电界面在锁屏或后台显示），则需要此权限。
• android.permission.RECEIVE_BOOT_COMPLETED: 如果你的应用需要在设备启动完成后执行某些操作（例如，重新启动服务或检查未接来电），则需要此权限。

2. 广播接收器 (BroadcastReceiver) 配置

对于处理来电等事件的 CallReceiver，其配置也需要注意。

<receiver
    android:name=".receiver.CallReceiver"
    android:exported="false"
    android:enabled="true"
    android:permission="android.permission.RECEIVE_BOOT_COMPLETED" >
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
    <!-- 如果你的通知操作需要通过隐式 Intent 触发此 Receiver，
         且 Receiver 内部处理了特定的 Action，则需要在此处声明对应的 Action
         例如：
    <intent-filter>
        <action android:name="RECEIVE_CALL" />
        <action android:name="CANCEL_CALL" />
    </intent-filter>
    -->
</receiver>

配置解析：

• android:exported="false": 强烈建议将你的 BroadcastReceiver 设置为 exported="false"，除非你确实需要它接收来自其他应用的广播。这可以增强应用的安全性，防止恶意应用向你的接收器发送广播。
• android:enabled="true": 确保接收器是启用的。
• android:permission="android.permission.RECEIVE_BOOT_COMPLETED": 如果 BroadcastReceiver 监听 BOOT_COMPLETED 事件，并且你希望限制只有拥有此权限的应用才能向其发送此广播（这通常不是针对 BOOT_COMPLETED 事件本身，而是对接收器整体的访问权限控制），可以添加此属性。然而，对于 BOOT_COMPLETED 这种系统广播，通常不需要在接收器上额外声明权限。此属性更常用于自定义权限，以保护自定义广播。
• intent-filter: 声明 BroadcastReceiver 能够响应的 Intent 类型。
  • android.intent.action.BOOT_COMPLETED: 允许接收器在设备启动完成后被触发。
  • 对于通过通知操作触发的广播，通常是通过显式 Intent 结合 PendingIntent.getBroadcast() 发送的，因此 BroadcastReceiver 不一定需要一个匹配的 intent-filter 来响应这些显式 Intent。但是，如果 PendingIntent 使用了隐式 Intent 或 Intent 的 action 属性，那么 intent-filter 就变得至关重要。在示例中，通知操作是发送给 CallReceiver 的显式 Intent，并设置了 action 字符串（"RECEIVE_CALL", "CANCEL_CALL"），因此 CallReceiver 内部通过 intent.getStringExtra("action") 来区分操作。

注意事项与最佳实践

1. 安全性优先： 尽可能使用 FLAG_IMMUTABLE。只有在确实需要修改 PendingIntent 内部 Intent 的情况下才考虑使用 FLAG_MUTABLE，并且要充分理解其潜在的安全风险。
2. 前台服务 (Foreground Service)： 对于通话或音乐播放等需要长时间运行且用户可见的任务，强烈建议使用前台服务。前台服务会显示一个持久的通知，告知用户应用正在后台运行，并可以提高应用的优先级，减少被系统终止的可能性。
3. 测试兼容性： 在不同版本的Android设备上进行充分测试，尤其是 Android 12 (API 31) 及更高版本，以确保所有通知功能都能正常工作。
4. 明确 Intent 行为： 确保你的 Intent 目标明确，无论是启动 Activity、Service 还是发送 Broadcast。对于 BroadcastReceiver，如果 PendingIntent 使用显式 Intent (即 new Intent(context, YourReceiver.class)), 则 BroadcastReceiver 不一定需要一个匹配的 intent-filter 来响应。但如果 Intent 是隐式的，或者你希望通过 action 属性来路由，则 intent-filter 必不可少。

通过以上修改和注意事项，你的应用将能够更好地适应 Android 12 (API 31) 及更高版本的系统行为，确保通知操作功能在所有兼容设备上都能正常、安全地运行。

以上就是Android 12 (API 31) 通知操作失效问题及解决方案的详细内容，更多请关注php中文网其它相关文章！