原生移动开发 / 系统课时
处理通知运行时权限
处理通知运行时权限
这一篇解决 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 的片段示例,完整展示“检查 → 请求 → 拒绝后引导设置”的主流程。
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
</manifest>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)
}
}预期结果
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> 替换为实际包名。
adb shell dumpsys package <PACKAGE_NAME>预期结果
输出中可以看到 POST_NOTIFICATIONS 的运行时权限状态,例如 granted=true 或 granted=false。通知权限处理的核心是把“是否允许发送通知”和“通知渠道如何提醒”分开设计:前者由运行时权限决定,后者由渠道与用户设置共同决定。这样即使用户拒绝通知,应用也能有明确、可解释的降级路径,而不是把业务状态误判成“通知系统失效”。