android-foreground-service

What problem does it solve?

Prevents Android foreground data collection services from failing during Activity lifecycle changes by ensuring correct Android 14 foregroundServiceType handling, immediate startForeground safety, null-intent resilience, and clean shutdown.

Core Features & Use Cases

• Android 14+ foregroundServiceType compliance: Avoids runtime ForegroundServiceTypeNotAllowedException by matching manifest and startForeground type requirements for the service’s purpose (e.g., location, connectedDevice, camera, microphone, or combinations).
• Lifecycle-safe long-running collection: Uses START_STICKY with a null-intent guard so process-death restarts stop cleanly instead of running in an invalid state.
• Intent-based control + StateFlow status: Starts and stops work via Intent actions while exposing collection state through StateFlow so UI/ViewModel layers never hold hardware references.
• Source-priority fallback: Supports internal sensor fallback when an external source (like BLE) is unavailable, keeping the recording pipeline functional.
• Robust notification + shutdown: Creates the notification channel in Application, throttles notification updates, and flushes pending writes before stopping.

Quick Start

Implement a DataCollectionService foreground service that declares the correct foregroundServiceType in the manifest, calls startForegroundCompat as the first line of onStartCommand, and exposes CollectionStatus via StateFlow while controlling start/stop via Intent actions.