Foreground service на Android — нюансы
С Android 14 тип foreground service обязателен, а запуск из фона ограничен ещё с Android 12. Что ломается при обновлении targetSdk и когда лучше взять WorkManager.
Foreground service — это сервис, о котором пользователь знает: он показывает постоянное уведомление, и система относится к нему как к видимой работе, а не убивает в первую очередь, как обычные фоновые процессы. Его используют для навигации и трекинга маршрута, музыкального плеера, звонков, длинной загрузки или синхронизации файлов.
Последние версии 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
- Найти все сервисы и проставить каждому тип и нужное разрешение.
- Проверить все места запуска: не происходит ли старт из фона.
- Убедиться, что
startForeground()вызывается сразу. - Обработать отказ в разрешении на уведомления.
- Заполнить декларацию в консоли Google Play.
- Прогнать на устройствах с новой и старой версиями Android.
Переводом старых приложений на актуальные требования Android занимаемся в рамках услуги модернизация старых приложений, новые разрабатываем в рамках нативной разработки под Android.
Если приложение начало падать после обновления targetSdk или фоновые задачи работают нестабильно, напишите в Telegram или MAX.