Android闹钟设置方法及应用pendingIntent崩溃问题排查

设置Android闹钟的核心流程如下：

• 定义广播接收器：自定义BroadcastReceiver子类，用于处理闹钟触发后的逻辑（如响铃、弹窗提醒等）。
• 注册接收器：在AndroidManifest.xml中注册该接收器，确保系统能识别并调度它。
• 构建触发载体：创建Intent指向接收器，再通过PendingIntent包装，供系统在闹钟触发时调用。
• 配置闹钟参数：通过AlarmManager设置闹钟的触发时间、重复规则等。
• 适配版本差异：不同Android版本对闹钟API、权限要求不同，比如Android 12+需指定PendingIntent可变性Flag，Android 13+需申请通知权限。

你的代码在PendingIntent.getBroadcast()行崩溃，核心问题是PendingIntent Flag未适配高版本Android系统，具体修复方案如下：

问题根源 #

从Android 12（API 31）开始，创建PendingIntent必须明确指定可变性Flag：PendingIntent.FLAG_IMMUTABLE或PendingIntent.FLAG_MUTABLE。你当前使用的0（无Flag）在高版本系统中会直接抛出IllegalArgumentException，导致应用崩溃。

修复步骤 #

1. 修改PendingIntent创建逻辑 #

根据需求选择合适的Flag：

• 若无需后续修改PendingIntent内容，优先使用FLAG_IMMUTABLE（更安全）
• 若需要更新PendingIntent的携带数据，使用FLAG_MUTABLE

修改后的完整代码：

private fun startAlarm() {
    val alarmManager = getSystemService(Context.ALARM_SERVICE) as AlarmManager
    val intent = Intent(this, AlarmReceiver::class.java)
    
    // 适配Android 12+的Flag要求
    val pendingIntentFlag = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        PendingIntent.FLAG_IMMUTABLE
    } else {
        0
    }
    val pendingIntent = PendingIntent.getBroadcast(this, 0, intent, pendingIntentFlag)
    
    val calendar = Calendar.getInstance()
    calendar.set(Calendar.HOUR_OF_DAY, 10)
    calendar.set(Calendar.MINUTE, 0)
    calendar.set(Calendar.SECOND, 0)

    // 适配API 19+的精确闹钟要求
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        // 允许在设备空闲时触发
        alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC, calendar.timeInMillis, pendingIntent)
    } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
        // API 19+要求精确闹钟需用setExact
        alarmManager.setExact(AlarmManager.RTC, calendar.timeInMillis, pendingIntent)
    } else {
        // 低版本可直接使用重复闹钟API
        alarmManager.setRepeating(AlarmManager.RTC, calendar.timeInMillis, AlarmManager.INTERVAL_DAY, pendingIntent)
    }
}

2. 额外适配提醒 #

• 重复闹钟行为变化：从Android 4.4（API 19）开始，setRepeating()不再保证精确触发。若需要精确重复闹钟，需在AlarmReceiver的onReceive方法中重新设置下一次闹钟。
• 权限验证：如果闹钟触发后需要显示通知，Android 13（API 33）及以上需在Manifest中添加<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>，并动态申请该权限。
• 接收器类一致性：确保AlarmReceiver类的实际包名与Manifest中注册的.AlarmReceiver完全匹配，避免类找不到的异常。

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