Foreground service на Android — нюансы

С Android 14 тип foreground service обязателен, а запуск из фона ограничен ещё с Android 12. Что ломается при обновлении targetSdk и когда лучше взять WorkManager.

Foreground service на Android — нюансы

Foreground service — это сервис, о котором пользователь знает: он показывает постоянное уведомление, и система относится к нему как к видимой работе, а не убивает в первую очередь, как обычные фоновые процессы. Его используют для навигации и трекинга маршрута, музыкального плеера, звонков, длинной загрузки или синхронизации файлов.

Foreground service на Android — нюансы
Цепочка запуска foreground service в Android 14+.

Последние версии Android последовательно ужесточали правила для фоновой работы. Самые заметные изменения пришлись на Android 12 и Android 14 (API 34), и старый код, который годами работал, после повышения targetSdkVersion начинает падать.

Что требуется с Android 14

  • Тип сервиса обязателен. Каждый foreground service объявляет в манифесте foregroundServiceType: location, mediaPlayback, dataSync, phoneCall, camera, microphone и другие. Без типа запуск завершится исключением.
  • Отдельное разрешение на каждый тип. Помимо общего FOREGROUND_SERVICE нужно, например, FOREGROUND_SERVICE_LOCATION для геотрекинга или FOREGROUND_SERVICE_MEDIA_PLAYBACK для плеера.
  • Предусловия типа. Для location у приложения уже должно быть разрешение на геолокацию, для camera — на камеру. Запуск без них тоже упадёт.
  • Декларация в Google Play. При публикации приложения с такими сервисами в консоли нужно описать, зачем используется каждый тип. Неубедительное описание — повод для отклонения.

Пример манифеста для трекинга:

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

<service
    android:name=".TrackingService"
    android:foregroundServiceType="location"
    android:exported="false" />

И запуск внутри сервиса с указанием типа:

ServiceCompat.startForeground(
    this, NOTIFICATION_ID, notification,
    ServiceInfo.FOREGROUND_SERVICE_TYPE_LOCATION
)

Запуск из фона

С Android 12 приложение, которое находится в фоне, в общем случае не может запустить foreground service — система бросит ForegroundServiceStartNotAllowedException. Есть исключения: например, обработка высокоприоритетного push-сообщения, срабатывание точного будильника, действие пользователя с уведомлением или виджетом. Полный список и его изменения смотрите в документации Android для вашей целевой версии.

Также после startForegroundService() у сервиса есть всего несколько секунд, чтобы вызвать startForeground() с уведомлением. Не успел — приложение падает. Поэтому тяжёлую инициализацию нельзя ставить перед этим вызовом.

Уведомление

Foreground service всегда связан с уведомлением, но пользователь контролирует его больше, чем раньше. С Android 13 показ уведомлений требует разрешения POST_NOTIFICATIONS: если человек его не дал, сервис работает, но уведомления в шторке нет. А в Android 14 уведомление foreground service можно смахнуть — сервис при этом продолжает работать. Не завязывайте логику приложения на то, видит ли пользователь уведомление.

Уведомление должно честно объяснять, что происходит: «Записываем маршрут, 3,2 км» понятнее, чем «Приложение работает в фоне». Добавьте кнопку остановки. Канал уведомлений для сервиса заведите с низкой важностью, чтобы оно не звенело при каждом обновлении, и не обновляйте текст слишком часто: чересчур частые обновления система может ограничивать.

Что обычно ломается

  • Сервис запускается из BroadcastReceiver, когда приложение в фоне, — на современных версиях получаем исключение.
  • Не объявлен тип или не добавлено разрешение — краш при старте, часто только на новых устройствах, поэтому его не ловят при тестировании на старом телефоне.
  • Тип выбран «какой подошёл». Например, dataSync для всего подряд. В новых версиях Android для отдельных типов ограничено время работы, а Google Play может отклонить приложение с неподходящим типом.
  • Агрессивные энергосберегающие оболочки некоторых производителей убивают даже foreground service. Это лечится инструкцией для пользователя, как добавить приложение в исключения, и проверкой на реальных устройствах популярных марок.

Нужен ли вам foreground service вообще

Часто — нет. Если задача отложенная и не требует, чтобы пользователь видел процесс (отправить логи, синхронизировать данные, загрузить фото), правильный инструмент — WorkManager. Он сам учитывает ограничения системы, состояние сети и батареи, переживает перезагрузку устройства. Для срочных задач в нём есть expedited work, а для длинных — запуск работы в режиме foreground через setForeground(), где WorkManager сам управляет сервисом.

Foreground service оправдан, когда работа длительная, заметна пользователю и должна идти прямо сейчас: навигация, плеер, звонок, запись тренировки.

Чек-лист при повышении targetSdk

  1. Найти все сервисы и проставить каждому тип и нужное разрешение.
  2. Проверить все места запуска: не происходит ли старт из фона.
  3. Убедиться, что startForeground() вызывается сразу.
  4. Обработать отказ в разрешении на уведомления.
  5. Заполнить декларацию в консоли Google Play.
  6. Прогнать на устройствах с новой и старой версиями Android.

Переводом старых приложений на актуальные требования Android занимаемся в рамках услуги модернизация старых приложений, новые разрабатываем в рамках нативной разработки под Android.

Если приложение начало падать после обновления targetSdk или фоновые задачи работают нестабильно, напишите в Telegram или MAX.

Разработка нативного Android-приложения
Услуга по теме — обсудим ваш проект.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX