原生移动开发 / 系统课时

处理通知运行时权限

处理通知运行时权限

这一篇解决 Android 13 及以上设备“代码正常但通知不出现”的问题:先判断 POST_NOTIFICATIONS,再选择合适时机请求权限;被拒绝后不要反复弹窗,而应进入功能降级或设置引导。

学习目标

  • 能正确区分 Android 13 及以上与旧版本的通知权限行为
  • 能在真正需要通知的场景请求 POST_NOTIFICATIONS
  • 能处理拒绝后的降级与系统通知设置入口

Android 13 开始需要单独处理通知权限

Android 13(API 33)引入了发送非豁免通知所需的运行时权限 POST_NOTIFICATIONS。应用需要在清单中声明该权限,并在适当时机向用户发起授权请求。([Android Developers][2])

权限状态和通知渠道是两层不同控制:即使渠道已经正确创建,只要应用的通知权限没有获得允许,普通通知仍可能无法正常发送。用户也可以在系统设置中关闭应用通知。([Android Developers][2])

在真正需要通知时请求权限

先在 AndroidManifest.xml 声明权限,再在用户即将使用通知能力的场景中请求。下面是基于 ComponentActivity 的片段示例,完整展示“检查 → 请求 → 拒绝后引导设置”的主流程。

xml
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
</manifest>
kotlin
import android.Manifest
import android.content.Intent
import android.content.pm.PackageManager
import android.net.Uri
import android.os.Build
import android.os.Bundle
import android.provider.Settings
import androidx.activity.ComponentActivity
import androidx.activity.result.contract.ActivityResultContracts
import androidx.core.content.ContextCompat

class NotificationPermissionActivity : ComponentActivity() {

    private val notificationPermissionLauncher =
        registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
            if (granted) {
                enableNotificationFeatures()
            } else {
                showNotificationDisabledState()
            }
        }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        if (hasNotificationPermission()) {
            enableNotificationFeatures()
        } else {
            requestNotificationPermission()
        }
    }

    private fun hasNotificationPermission(): Boolean {
        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) return true

        return ContextCompat.checkSelfPermission(
            this,
            Manifest.permission.POST_NOTIFICATIONS
        ) == PackageManager.PERMISSION_GRANTED
    }

    private fun requestNotificationPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            notificationPermissionLauncher.launch(
                Manifest.permission.POST_NOTIFICATIONS
            )
        }
    }

    private fun enableNotificationFeatures() {
        // 允许后才启用依赖通知触达的业务提示。
    }

    private fun showNotificationDisabledState() {
        val intent = Intent(
            Settings.ACTION_APP_NOTIFICATION_SETTINGS,
            Uri.parse("package:$packageName")
        )
        startActivity(intent)
    }
}

预期结果

text
Android 13+ 且已允许通知:直接进入 enableNotificationFeatures()。
Android 13+ 且未允许通知:触发系统通知权限请求;用户拒绝后进入禁用状态处理。
Android 12L 及以下:hasNotificationPermission() 返回 true,不请求 POST_NOTIFICATIONS。

拒绝后不要把系统弹窗当成业务流程

系统权限弹窗不是应用自己的 UI。用户选择拒绝后,应根据业务重要程度决定降级方式,例如关闭“新消息提醒”入口、改用应用内提示,或明确告诉用户需要在系统通知设置中重新打开通知。

Android 官方建议不要在用户刚进入应用时无上下文地请求通知权限,而应先让用户理解通知用途,再在有明确业务价值的时机请求。([Android Developers][3])

对于“拒绝后还能不能再次请求”,不要把循环弹窗作为主要策略。应用应结合当前授权状态和产品交互决定是否再次解释用途,并提供进入系统通知设置的路径;真正改变系统通知开关的控制权属于用户。([Android Developers][2])

验证权限和降级是否正确

测试时至少覆盖“首次请求允许”“首次拒绝”“返回页面后再次检查”“手动关闭系统通知”四种状态。开发调试阶段还可以使用 dumpsys package 检查运行时权限状态。([Android Developers][4])

片段示例:以下命令需要在已连接设备或模拟器的终端执行,<PACKAGE_NAME> 替换为实际包名。

bash
adb shell dumpsys package <PACKAGE_NAME>

预期结果

text
输出中可以看到 POST_NOTIFICATIONS 的运行时权限状态,例如 granted=true 或 granted=false。

通知权限处理的核心是把“是否允许发送通知”和“通知渠道如何提醒”分开设计:前者由运行时权限决定,后者由渠道与用户设置共同决定。这样即使用户拒绝通知,应用也能有明确、可解释的降级路径,而不是把业务状态误判成“通知系统失效”。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理通知运行时权限

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

登录哪都通