Android Fragment中通知权限配置与实现问题求助（Java）

一、替换过时的权限请求方法 #

onRequestPermissionsResult已被Activity Result API取代，在Fragment中可以直接注册权限请求启动器，无需依赖Activity的回调：

import android.Manifest
import android.content.Intent
import android.net.Uri
import android.os.Build
import android.provider.Settings
import android.widget.Button
import androidx.appcompat.app.AlertDialog
import androidx.core.app.NotificationCompat
import androidx.core.app.NotificationManagerCompat
import androidx.core.content.ContextCompat
import androidx.fragment.app.Fragment
import androidx.activity.result.contract.ActivityResultContracts

class YourFragment : Fragment() {
    // 注册通知权限请求启动器
    private val requestNotificationPermissionLauncher = registerForActivityResult(
        ActivityResultContracts.RequestPermission()
    ) { isGranted ->
        if (isGranted) {
            showNotification()
        } else {
            handlePermissionDenied()
        }
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 创建通知通道（Android 8.0+必填）
        createNotificationChannel()
        
        // 绑定按钮点击事件
        val notifyBtn = view.findViewById<Button>(R.id.btn_notify)
        notifyBtn.setOnClickListener {
            checkAndRequestNotificationPermission()
        }
    }

    // 检查并请求权限
    private fun checkAndRequestNotificationPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            when {
                ContextCompat.checkSelfPermission(
                    requireContext(),
                    Manifest.permission.POST_NOTIFICATIONS
                ) == PackageManager.PERMISSION_GRANTED -> {
                    showNotification()
                }
                shouldShowRequestPermissionRationale(Manifest.permission.POST_NOTIFICATIONS) -> {
                    // 先显示权限解释弹窗
                    showPermissionRationaleDialog()
                }
                else -> {
                    // 直接发起权限请求
                    requestNotificationPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
                }
            }
        } else {
            // Android 12及以下无需POST_NOTIFICATIONS权限，直接显示通知
            showNotification()
        }
    }
}

二、权限未授予的处理逻辑 #

分两种场景处理，提升用户体验：

// 权限被拒绝后的处理
private fun handlePermissionDenied() {
    if (!shouldShowRequestPermissionRationale(Manifest.permission.POST_NOTIFICATIONS)) {
        // 用户勾选了「不再询问」，引导至应用设置页开启权限
        AlertDialog.Builder(requireContext())
            .setTitle("权限已被拒绝")
            .setMessage("你需要在设置中开启通知权限才能接收通知，请前往设置页开启")
            .setPositiveButton("去设置") { _, _ ->
                val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
                    data = Uri.fromParts("package", requireContext().packageName, null)
                }
                startActivity(intent)
            }
            .setNegativeButton("取消", null)
            .show()
    } else {
        // 用户仅拒绝未勾选「不再询问」，再次显示解释弹窗
        showPermissionRationaleDialog()
    }
}

// 显示权限必要性解释弹窗
private fun showPermissionRationaleDialog() {
    AlertDialog.Builder(requireContext())
        .setTitle("需要通知权限")
        .setMessage("开启通知权限后，你可以及时收到应用的重要提醒和消息")
        .setPositiveButton("确定授权") { _, _ ->
            requestNotificationPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
        }
        .setNegativeButton("取消", null)
        .show()
}

三、完整通知通道与通知实现 #

// 创建通知通道（Android 8.0+必须）
private fun createNotificationChannel() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channelId = "default_notification_channel"
        val channelName = "默认通知"
        val channelDesc = "用于显示应用普通通知"
        val importance = NotificationManager.IMPORTANCE_DEFAULT
        
        val channel = NotificationChannel(channelId, channelName, importance).apply {
            description = channelDesc
            enableVibration(true)
            vibrationPattern = longArrayOf(100, 200, 300)
        }
        
        val notificationManager = requireContext().getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

// 显示通知
private fun showNotification() {
    val channelId = "default_notification_channel"
    val notification = NotificationCompat.Builder(requireContext(), channelId)
        .setSmallIcon(R.drawable.ic_notification) // 替换为你的通知图标（建议白色透明背景）
        .setContentTitle("测试通知")
        .setContentText("这是一条来自Fragment的测试通知")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setAutoCancel(true) // 点击通知后自动消失
        .build()

    val notificationManager = NotificationManagerCompat.from(requireContext())
    // 通知ID需唯一，可根据业务场景自定义
    notificationManager.notify(1001, notification)
}

四、关键注意事项 #

• 通知图标必须使用白色透明背景的矢量图，否则在部分设备上会显示为灰色块；
• Android 12及以下版本无需POST_NOTIFICATIONS权限，可直接显示通知；
• 确保Manifest中已声明权限：<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />（仅Android 13+需要，低版本兼容）。

内容的提问来源于stack exchange，提问作者aRINstotle