Android 14背景启动Activity：MODE_BACKGROUND_ACTIVITY_START_ALLOWED使用问题

核心问题 #

你的代码中未正确创建并配置ActivityOptions实例，导致Android 14的后台启动权限未被授予，所以PendingIntent.send()无法启动Activity。此外还有几处细节问题需要修正。

修正后的完整代码 #

1. 修正TimeChangeService的onStartCommand方法 #

需要先创建ActivityOptions并设置后台启动模式，再传入PendingIntent.getActivity()：

@RequiresApi(34)
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
    val noti = createNotification()
    startForeground(1, noti.build())
    
    // 创建ActivityOptions并设置后台启动权限
    val options = ActivityOptions.makeBasic()
    options.setPendingIntentBackgroundActivityStartMode(
        ActivityOptions.MODE_BACKGROUND_ACTIVITY_START_ALLOWED
    )
    
    // 构建PendingIntent时传入配置好的options
    val activityIntent = Intent(this, MainActivity2::class.java)
    val pendingIntent = PendingIntent.getActivity(
        this,
        0,
        activityIntent,
        PendingIntent.FLAG_MUTABLE,
        options.toBundle()
    )
    
    try {
        pendingIntent.send()
    } catch (e: PendingIntent.CanceledException) {
        // 捕获异常，便于排查问题
        e.printStackTrace()
    }

    return START_STICKY
}

2. 统一通知通道ID（规范优化） #

代码中定义了CHANNEL_ID = "ForegroundServiceChannel"，但createNotification()里用的是"my_channel_id"，建议统一：

private fun createNotification(): NotificationCompat.Builder {
    // 复用类中定义的CHANNEL_ID
    val notificationManager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = NotificationChannel(CHANNEL_ID, "Foreground Service Channel", NotificationManager.IMPORTANCE_DEFAULT)
        notificationManager.createNotificationChannel(channel)
    }

    val intent = Intent(this, MainActivity::class.java)
    val pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_MUTABLE)

    val notification = NotificationCompat.Builder(this, CHANNEL_ID)
        .setContentTitle("Foreground Service")
        .setContentText("Foreground Service is running")
        .setSmallIcon(android.R.drawable.ic_dialog_info)
        .setContentIntent(pendingIntent)

    return notification
}

3. 移除无用代码（优化） #

TimeChangeService中初始化了TimeChangeReceiver但未实际注册，当前场景不需要该逻辑，建议删除：

// 移除以下无用代码
// private var timeChangeReceiver: TimeChangeReceiver? = null

// override fun onCreate() {
//     super.onCreate()
//     timeChangeReceiver = TimeChangeReceiver()
// }

// override fun onDestroy() {
//     super.onDestroy()
//     timeChangeReceiver?.let {
//         unregisterReceiver(it)
//     }
// }

关键注意事项 #

• Android 14权限要求：只有应用满足后台启动Activity的条件（如当前处于前台服务状态）时，设置MODE_BACKGROUND_ACTIVITY_START_ALLOWED才会生效，你的场景已经启动前台服务，符合要求。
• PendingIntent标志位：Android 12+必须使用FLAG_MUTABLE，否则会抛出异常。
• 异常捕获：添加try-catch可以帮助排查PendingIntent被取消等潜在问题。

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