如何通过Notification Channels显示通知？前台服务通知不显示排查

你的前台服务能正常运行但通知不显示，主要有几个关键问题：

核心问题点 #

• 未重写onStartCommand方法：startService触发时系统会调用onStartCommand，你当前仅在onCreate中发送通知，若服务被重启或多次启动，onCreate不会重复执行，可能导致通知无法显示；且前台服务的startForeground更适合放在onStartCommand中执行。
• 通知小图标不符合系统要求：使用R.mipmap.ic_launcher（应用启动图标）作为通知小图标，这类图标多为彩色，而Android要求通知小图标必须是仅含alpha通道的单色图标，系统会过滤彩色图标导致通知不显示。
• sendNotification返回值无意义：该方法返回START_STICKY但未被使用，启动模式控制应放在onStartCommand中。

修正后的代码 #

NotificationService类 #

class NotificationService : Service() {

    private val CHANNEL_ID = "CHANNEL_ONE"
    private val NOTIFICATION_ID = 1

    override fun onBind(intent: Intent?): IBinder? {
        return null
    }

    override fun onCreate() {
        super.onCreate()
        createNotificationChannel()
    }

    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // 每次启动服务都触发前台通知
        sendNotification()
        // 返回START_STICKY保证服务被系统杀死后可重启
        return START_STICKY
    }

    private fun createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channelName = "Photo Text Copier"
            val channelDescription = "Takes Snapshots and Copies the Text from Images!"
            val importance = NotificationManager.IMPORTANCE_HIGH
            val channel = NotificationChannel(CHANNEL_ID, channelName, importance).apply {
                description = channelDescription
                enableVibration(true)
                vibrationPattern = longArrayOf(100, 200, 300, 400, 500)
            }
            val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
            notificationManager.createNotificationChannel(channel)
        }
    }

    private fun sendNotification() {
        // 替换为drawable目录下的单色通知图标，需自行创建
        val builder = NotificationCompat.Builder(this, CHANNEL_ID)
            .setSmallIcon(R.drawable.ic_notification)
            .setContentTitle("Photo Text Copier")
            .setContentText("Takes Snapshots and Copies the Text from Images!")
            .setPriority(NotificationCompat.PRIORITY_HIGH)
            .setWhen(System.currentTimeMillis())
            // 添加通知点击跳转逻辑（可选）
            .setContentIntent(PendingIntent.getActivity(
                this,
                0,
                Intent(this, MainActivity::class.java),
                PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
            ))
            .setAutoCancel(false)

        startForeground(NOTIFICATION_ID, builder.build())
    }
}

Manifest中Service声明修正 #

针对targetSdk 33及以上，需明确前台服务类型：

<service 
    android:name=".NotificationService"
    android:foregroundServiceType="dataSync|general"/>

额外操作 #

• 创建单色通知图标：在res/drawable目录下，用Android Studio的「Vector Asset」工具创建一个单色图标（建议选择Notification类别图标），命名为ic_notification，替换代码中的图标引用。

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