Kotlin开发：如何在Android前台服务通知添加按钮终止服务

核心实现逻辑是通过通知按钮绑定广播意图，服务内部监听广播触发后自行终止，无需依赖Activity组件，实现步骤如下：

• 定义专属的停止服务广播Action，避免和其他应用意图冲突
• 构建带PendingIntent的通知操作按钮，点击后发送停止广播
• 在服务生命周期内动态注册广播接收器，收到停止信号后终止服务并移除通知
• 适配不同Android版本的PendingIntent、广播注册规则，避免版本兼容问题

完整修改代码 #

1. 类内常量与广播接收器定义 #

首先在你的Service类中添加常量和停止服务的广播接收器实例：

class YourForegroundService : Service() {
    companion object {
        private const val notificationChannelId = "your_service_channel_id"
        // 自定义停止服务的广播Action，建议加包名前缀避免冲突
        private const val ACTION_STOP_SERVICE = "com.your.packagename.ACTION_STOP_FOREGROUND_SERVICE"
    }

    // 监听停止按钮点击的广播接收器
    private val stopServiceReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context?, intent: Intent?) {
            if (intent?.action == ACTION_STOP_SERVICE) {
                // 停止前台并移除通知，再终止服务自身
                stopForeground(STOP_FOREGROUND_REMOVE)
                stopSelf()
            }
        }
    }

    // 其余原有代码...
}

2. 注册与反注册广播 #

在Service的生命周期方法中注册和反注册接收器，避免内存泄漏：

override fun onCreate() {
    super.onCreate()
    val filter = IntentFilter(ACTION_STOP_SERVICE)
    // Android 13及以上版本指定接收器不对外导出，提升安全性
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        registerReceiver(stopServiceReceiver, filter, Context.RECEIVER_NOT_EXPORTED)
    } else {
        registerReceiver(stopServiceReceiver, filter)
    }
}

override fun onDestroy() {
    super.onDestroy()
    unregisterReceiver(stopServiceReceiver)
}

3. 修改通知构建逻辑，添加停止按钮 #

修改原有onStartCommand方法中的通知构建代码，添加操作按钮：

override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    Log.d("service", "Starting the foreground service")
    createNotificationChannel()

    // 构建停止按钮的点击意图
    val stopIntent = Intent().apply {
        action = ACTION_STOP_SERVICE
    }
    val stopPendingIntent = PendingIntent.getBroadcast(
        this,
        1001, // 请求码保证唯一即可
        stopIntent,
        // Android 6.0及以上必须指定PendingIntent flag，否则会触发崩溃
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) PendingIntent.FLAG_IMMUTABLE else 0
    )

    val notification = NotificationCompat.Builder(this, notificationChannelId)
        .setContentTitle("App Notification")
        .setContentText("App is Running in the Foreground")
        // 添加停止按钮，第一个参数替换为你项目内的停止图标资源
        .addAction(
            R.drawable.ic_baseline_stop_24,
            "停止运行",
            stopPendingIntent
        )
        .build()
    startForeground(1, notification)

    // 原有代码缺失返回值，根据业务需求选择即可，常用START_STICKY代表服务被杀死后自动重启
    return START_STICKY
}

注意事项 #

• 代码中R.drawable.ic_baseline_stop_24需要替换为你项目中实际存在的图标资源，可以直接通过Android Studio自带的矢量素材库导入标准停止图标
• 广播注册时使用RECEIVER_NOT_EXPORTED标记，防止其他应用伪造广播恶意停止你的服务
• 原代码中"Forground"为拼写错误，正确拼写为"Foreground"

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