Alarm Manager в Android: руководство по планированию задач

<manifest ... >
<!-- Разрешение на запуск при старте устройства (опционально) -->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

<!-- Разрешение на работу в фоне (для Android 9+) -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

<!-- Разрешение на отключение оптимизации батареи (опционально) -->
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

<!-- Для Android 12+ (опционально) -->
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />

<application ... >
<!-- Остальное содержимое -->
</application>
</manifest>

public class AlarmReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// Здесь будет ваш код, который выполнится при срабатывании будильника
String action = intent.getAction();
if (action != null) {
switch (action) {
case "MY_UNIQUE_ALARM_ACTION":
// Обработка конкретного типа будильника
showNotification(context, "Запланированное уведомление", "Ваш будильник сработал!");
break;
// Другие варианты обработки
}
}
}

private void showNotification(Context context, String title, String message) {
// Код создания и отображения уведомления
// ...
}
}

<application ... >
<!-- Ваши Activity, Services и т.д. -->

<receiver 
android:name=".AlarmReceiver"
android:exported="false">
<intent-filter>
<action android:name="MY_UNIQUE_ALARM_ACTION" />
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
</receiver>
</application>

public class AlarmManagerHelper {
private final Context context;
private final AlarmManager alarmManager;

public AlarmManagerHelper(Context context) {
this.context = context;
this.alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
}

// Методы для настройки различных типов будильников будут добавлены в следующих разделах
}

public void setOneTimeAlarm(long triggerTimeMillis, String action, int requestCode) {
Intent intent = new Intent(context, AlarmReceiver.class);
intent.setAction(action);

// Добавим немного данных для демонстрации
intent.putExtra("alarm_message", "Это одноразовый будильник!");

// Создаем PendingIntent
// FLAG_UPDATE_CURRENT позволяет обновить существующий PendingIntent с тем же requestCode
// FLAG_IMMUTABLE необходим для Android 12+
PendingIntent pendingIntent = PendingIntent.getBroadcast(
context,
requestCode,
intent,
PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

// Устанавливаем будильник, который разбудит устройство
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
// Для Android 6.0+ используем setExactAndAllowWhileIdle для работы в режиме Doze
alarmManager.setExactAndAllowWhileIdle(
AlarmManager.RTC_WAKEUP,
triggerTimeMillis,
pendingIntent
);
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
// Для Android 4.4-5.1
alarmManager.setExact(
AlarmManager.RTC_WAKEUP,
triggerTimeMillis,
pendingIntent
);
} else {
// Для более старых версий
alarmManager.set(
AlarmManager.RTC_WAKEUP,
triggerTimeMillis,
pendingIntent
);
}
}

public class MainActivity extends AppCompatActivity {
private AlarmManagerHelper alarmHelper;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

alarmHelper = new AlarmManagerHelper(this);

Button setAlarmButton = findViewById(R.id.setAlarmButton);
setAlarmButton.setOnClickListener(v -> setupAlarm());
}

private void setupAlarm() {
// Пример: установить будильник на 10 секунд вперед
long triggerTimeMillis = System.currentTimeMillis() + 10000;

// Используем константу действия, определенную в манифесте
String action = "MY_UNIQUE_ALARM_ACTION";

// Уникальный код запроса для этого конкретного будильника
int requestCode = 123;

alarmHelper.setOneTimeAlarm(triggerTimeMillis, action, requestCode);

// Сообщаем пользователю
Toast.makeText(this, "Будильник установлен на " + new Date(triggerTimeMillis).toString(), 
Toast.LENGTH_LONG).show();
}
}

private void showTimePickerAndSetAlarm() {
Calendar calendar = Calendar.getInstance();
int hour = calendar.get(Calendar.HOUR_OF_DAY);
int minute = calendar.get(Calendar.MINUTE);

TimePickerDialog timePickerDialog = new TimePickerDialog(
this,
(view, hourOfDay, minuteOfDay) -> {
// Настраиваем время срабатывания
Calendar alarmCalendar = Calendar.getInstance();
alarmCalendar.set(Calendar.HOUR_OF_DAY, hourOfDay);
alarmCalendar.set(Calendar.MINUTE, minuteOfDay);
alarmCalendar.set(Calendar.SECOND, 0);

// Если выбранное время уже прошло сегодня, устанавливаем на завтра
if (alarmCalendar.getTimeInMillis() < System.currentTimeMillis()) {
alarmCalendar.add(Calendar.DAY_OF_MONTH, 1);
}

// Устанавливаем будильник
alarmHelper.setOneTimeAlarm(
alarmCalendar.getTimeInMillis(),
"MY_UNIQUE_ALARM_ACTION",
hourOfDay * 60 + minuteOfDay // Используем время как requestCode
);

// Информируем пользователя
String timeString = String.format(Locale.getDefault(), "%02d:%02d", hourOfDay, minuteOfDay);
Toast.makeText(this, "Будильник установлен на " + timeString, Toast.LENGTH_LONG).show();
},
hour,
minute,
true // 24-часовой формат
);

timePickerDialog.show();
}

public void cancelAlarm(String action, int requestCode) {
Intent intent = new Intent(context, AlarmReceiver.class);
intent.setAction(action);

PendingIntent pendingIntent = PendingIntent.getBroadcast(
context,
requestCode,
intent,
PendingIntent.FLAG_IMMUTABLE
);

// Отменяем будильник
alarmManager.cancel(pendingIntent);

// Также отменяем сам PendingIntent
pendingIntent.cancel();
}

public void setRepeatingAlarm(long firstTriggerTimeMillis, long intervalMillis, 
String action, int requestCode) {
Intent intent = new Intent(context, AlarmReceiver.class);
intent.setAction(action);
intent.putExtra("alarm_message", "Это повторяющийся будильник!");

PendingIntent pendingIntent = PendingIntent.getBroadcast(
context,
requestCode,
intent,
PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

// В Android 4.4+ метод setRepeating стал неточным для экономии батареи
// Начиная с API 19, система может группировать повторяющиеся будильники
alarmManager.setRepeating(
AlarmManager.RTC_WAKEUP,
firstTriggerTimeMillis,
intervalMillis,
pendingIntent
);
}

public class ExactPeriodicAlarmManager {
private final AlarmManagerHelper alarmHelper;
private final String action;
private final int baseRequestCode;
private final long intervalMillis;

public ExactPeriodicAlarmManager(Context context, String action, int baseRequestCode, long intervalMillis) {
this.alarmHelper = new AlarmManagerHelper(context);
this.action = action;
this.baseRequestCode = baseRequestCode;
this.intervalMillis = intervalMillis;
}

// Запускаем первый будильник
public void start() {
scheduleNextExactAlarm(System.currentTimeMillis());
}

// Планируем следующий будильник
private void scheduleNextExactAlarm(long fromTime) {
long nextTriggerTime = fromTime + intervalMillis;

// Используем специальный action для наших точных периодических будильников
String periodicAction = action + "_EXACT_PERIODIC";

alarmHelper.setOneTimeAlarm(nextTriggerTime, periodicAction, baseRequestCode);
}

// Этот метод должен вызываться в вашем BroadcastReceiver
public void onAlarmTriggered(long triggerTime) {
// Выполняем нужную задачу

// Планируем следующее срабатывание
scheduleNextExactAlarm(triggerTime);
}

// Останавливаем цепочку будильников
public void stop() {
alarmHelper.cancelAlarm(action + "_EXACT_PERIODIC", baseRequestCode);
}
}

public class AlarmReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if (action != null) {
if (action.endsWith("_EXACT_PERIODIC")) {
// Получаем базовый action, удаляя суффикс
String baseAction = action.replace("_EXACT_PERIODIC", "");

// Получаем requestCode из intent или используем дефолтный
int requestCode = intent.getIntExtra("request_code", 0);

// Восстанавливаем наш менеджер периодических задач
long intervalMillis = intent.getLongExtra("interval_millis", 3600000); // 1 час по умолчанию
ExactPeriodicAlarmManager periodicAlarmManager = 
new ExactPeriodicAlarmManager(context, baseAction, requestCode, intervalMillis);

// Сообщаем о срабатывании и планируем следующий будильник
periodicAlarmManager.onAlarmTriggered(System.currentTimeMillis());

// Выполняем нужное действие
showNotification(context, "Периодическое уведомление", 
"Точное периодическое уведомление с интервалом " + 
(intervalMillis / 60000) + " минут");
} else {
// Обработка обычных будильников, как в предыдущем примере
}
}
}

// Метод showNotification как в предыдущем примере
}

public void scheduleDaily(int hourOfDay, int minute, String action, int requestCode) {
Calendar calendar = Calendar.getInstance();
calendar.set(Calendar.HOUR_OF_DAY, hourOfDay);
calendar.set(Calendar.MINUTE, minute);
calendar.set(Calendar.SECOND, 0);

// Если заданное время уже прошло сегодня, устанавливаем на завтра
if (calendar.getTimeInMillis() < System.currentTimeMillis()) {
calendar.add(Calendar.DAY_OF_MONTH, 1);
}

Intent intent = new Intent(context, AlarmReceiver.class);
intent.setAction(action);
intent.putExtra("daily_hour", hourOfDay);
intent.putExtra("daily_minute", minute);
intent.putExtra("is_daily", true);

PendingIntent pendingIntent = PendingIntent.getBroadcast(
context,
requestCode,
intent,
PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
alarmManager.setExactAndAllowWhileIdle(
AlarmManager.RTC_WAKEUP,
calendar.getTimeInMillis(),
pendingIntent
);
} else {
alarmManager.setExact(
AlarmManager.RTC_WAKEUP,
calendar.getTimeInMillis(),
pendingIntent
);
}
}

// В методе onReceive вашего AlarmReceiver
if (intent.getBooleanExtra("is_daily", false)) {
int hourOfDay = intent.getIntExtra("daily_hour", 8);
int minute = intent.getIntExtra("daily_minute", 0);

// Перепланируем на завтра
AlarmManagerHelper helper = new AlarmManagerHelper(context);
helper.scheduleDaily(hourOfDay, minute, action, requestCode);

// Выполняем запланированное действие
showNotification(context, "Ежедневное напоминание", 
"Ваше ежедневное уведомление в " + hourOfDay + ":" + minute);
}

// Не будите устройство без необходимости
// Плохо:
alarmManager.setExact(AlarmManager.RTC_WAKEUP, triggerTime, pendingIntent);

// Хорошо (если пробуждение не требуется):
alarmManager.setExact(AlarmManager.RTC, triggerTime, pendingIntent);

// Группирует будильники для экономии энергии
alarmManager.setInexactRepeating(
AlarmManager.ELAPSED_REALTIME,
SystemClock.elapsedRealtime() + initialDelay,
AlarmManager.INTERVAL_HALF_HOUR, // Встроенные константы интервалов
pendingIntent
);

// Плохо: слишком частое повторение
alarmManager.setRepeating(AlarmManager.RTC, startTime, 60 * 1000, pendingIntent); // каждую минуту

// Лучше: используйте WorkManager для частых операций
OneTimeWorkRequest workRequest = new OneTimeWorkRequest.Builder(YourWorker.class)
.setInitialDelay(1, TimeUnit.MINUTES)
.build();
WorkManager.getInstance(context).enqueue(workRequest);

// Для Android 6.0+
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, triggerTime, pendingIntent);
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
alarmManager.setExact(AlarmManager.RTC_WAKEUP, triggerTime, pendingIntent);
} else {
alarmManager.set(AlarmManager.RTC_WAKEUP, triggerTime, pendingIntent);
}

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
if (!alarmManager.canScheduleExactAlarms()) {
// Запрашиваем разрешение или перенаправляем в настройки
Intent intent = new Intent(Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM);
context.startActivity(intent);
return false; // Не устанавливаем будильник
}
}

public class BootReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (Intent.ACTION_BOOT_COMPLETED.equals(intent.getAction())) {
// Восстановите все ваши будильники
SharedPreferences prefs = context.getSharedPreferences("alarms_prefs", Context.MODE_PRIVATE);

// Пример восстановления ежедневного будильника
boolean hasDaily = prefs.getBoolean("has_daily_alarm", false);
if (hasDaily) {
int hour = prefs.getInt("daily_hour", 8);
int minute = prefs.getInt("daily_minute", 0);

AlarmManagerHelper helper = new AlarmManagerHelper(context);
helper.scheduleDaily(hour, minute, "MY_DAILY_ALARM_ACTION", 42);
}

// Восстановление других будильников...
}
}
}

// При установке будильника
SharedPreferences prefs = context.getSharedPreferences("alarms_prefs", Context.MODE_PRIVATE);
prefs.edit()
.putBoolean("has_daily_alarm", true)
.putInt("daily_hour", hourOfDay)
.putInt("daily_minute", minute)
.apply();

// Для разных действий используйте разные requestCode
// Вместо произвольных чисел используйте хеширование по действию
int requestCode = action.hashCode();

// Или создайте механизм генерации уникальных кодов
private int getUniqueRequestCode(String action, long triggerTimeMillis) {
return (action + "_" + triggerTimeMillis).hashCode();
}