Einschränkungen beim Starten eines Diensts im Vordergrund aus dem Hintergrund

Bei Apps, die auf Android 12 (API-Level 31) oder höher ausgerichtet sind, können Dienste im Vordergrund nicht gestartet werden, während die App im Hintergrund ausgeführt wird, mit wenigen Ausnahmen. Wenn eine App versucht, einen Dienst im Vordergrund zu starten, während sie im Hintergrund ausgeführt wird, und der Dienst im Vordergrund keinen der Ausnahmefälle erfüllt, löst das System eine ForegroundServiceStartNotAllowedException aus.

Hinweis :Wenn eine App Context.startForegroundService() aufruft, um einen Dienst im Vordergrund zu starten, der zu einer anderen App gehört, gelten diese Einschränkungen nur, wenn beide Apps auf Android 12 oder höher ausgerichtet sind.

Wenn eine App außerdem einen Dienst im Vordergrund starten möchte, für den Berechtigungen zur Nutzung während der Verwendung erforderlich sind (z. B. Berechtigungen für Körpersensor, Kamera, Mikrofon oder Standort), kann der Dienst nicht erstellt werden, während die App im Hintergrund ausgeführt wird. Das gilt auch, wenn die App eine der Ausnahmen von den Einschränkungen beim Starten im Hintergrund erfüllt. Der Grund dafür wird im Abschnitt Einschränkungen beim Starten von Diensten im Vordergrund, für die Berechtigungen für die Nutzung erforderlich sind erläutert.

Ausnahmen von Einschränkungen beim Start im Hintergrund

In den folgenden Fällen kann Ihre App Dienste im Vordergrund starten, auch wenn sie im Hintergrund ausgeführt wird:

• Ihre App wechselt von einem für Nutzer sichtbaren Status, z. B. einer Aktivität.
• Ihre App kann eine Aktivität aus dem Hintergrund starten, es sei denn, die App hat eine Aktivität im Backstack einer vorhandenen Aufgabe.

• Ihre App empfängt eine Nachricht mit hoher Priorität über Firebase Cloud Messaging.

  Hinweis:Das System kann Nachrichten mit hoher Priorität auf eine normale Priorität herabstufen, wenn die App die Nachrichten mit hoher Priorität nicht verwendet, um dem Nutzer zeitkritische Inhalte anzuzeigen. Wenn die Priorität der Nachricht herabgestuft wird, kann Ihre App keinen Dienst im Vordergrund starten. Ein Startversuch führt zu einer ForegroundServiceStartNotAllowedException.

  Daher sollten Sie das Ergebnis von RemoteMessage.getPriority() prüfen und bestätigen, dass es PRIORITY_HIGH() ist, bevor Sie versuchen, einen Dienst im Vordergrund zu starten. Informationen zu Nachrichten mit hoher Priorität und ihrer Verwendung finden Sie unter FCM's documentation.

• Der Nutzer führt eine Aktion auf einem UI-Element aus, das sich auf Ihre App bezieht. Er kann beispielsweise mit einer Bubble, einer Benachrichtigung, einem Widget oder einer Aktivität interagieren.

• Ihre App ruft einen genauen Wecker auf, um eine vom Nutzer angeforderte Aktion auszuführen.

• Ihre App ist die aktuelle Eingabemethode des Geräts.

• Ihre App empfängt ein Ereignis, das sich auf Geofencing oder den Übergang bei der Aktivitätserkennung bezieht.

• Nachdem das Gerät neu gestartet wurde und die Intent-Aktion ACTION_BOOT_COMPLETED, ACTION_LOCKED_BOOT_COMPLETED oder ACTION_MY_PACKAGE_REPLACED in einem Broadcast-Empfänger empfangen hat.

  Hinweis: Wenn Ihre App auf Android 14 oder höher ausgerichtet ist, gelten Einschränkungen für das Starten bestimmter Arten von Diensten im Vordergrund über einen BOOT_COMPLETED-Empfänger. Weitere Informationen finden Sie unter Einschränkungen für BOOT_COMPLETED-Broadcastempfänger, die Dienste im Vordergrund starten.

• Ihre App empfängt die Intent-Aktion ACTION_TIMEZONE_CHANGED, ACTION_TIME_CHANGED oder ACTION_LOCALE_CHANGED in einem Broadcast-Empfänger.

• Ihre App empfängt das Ereignis ACTION_TRANSACTION_DETECTED von NfcService.

• Apps mit bestimmten Systemrollen oder Berechtigungen, z. B. Geräteeigentümer und Profilinhaber.

• Ihre App verwendet den Companion Device Manager und deklariert die Berechtigung REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND oder die Berechtigung REQUEST_COMPANION_RUN_IN_BACKGROUND. Verwenden Sie nach Möglichkeit REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND.

• Der Nutzer deaktiviert die Akkuoptimierung für Ihre App.

• Ihre App hat die Berechtigung SYSTEM_ALERT_WINDOW. Hinweis: Wenn Ihre App auf Android 15 oder höher ausgerichtet ist, muss sie die Berechtigung SYSTEM_ALERT_WINDOW haben und es muss derzeit ein sichtbares Overlay-Fenster vorhanden sein.

Einschränkungen beim Starten von Diensten im Vordergrund, für die Berechtigungen für die Nutzung erforderlich sind

Unter Android 14 (API-Level 34) oder höher gibt es spezielle Situationen, die Sie beachten sollten, wenn Sie einen Dienst im Vordergrund starten, für den Berechtigungen für die Nutzung erforderlich sind.

Wenn Ihre App auf Android 14 oder höher ausgerichtet ist, prüft das Betriebssystem beim Erstellen eines Dienstes im Vordergrund, ob Ihre App alle erforderlichen Berechtigungen für diesen Diensttyp hat. Wenn Sie beispielsweise einen Dienst im Vordergrund vom Typ Mikrofon erstellen, prüft das Betriebssystem, ob Ihre App derzeit die Berechtigung RECORD_AUDIO hat. Wenn Sie diese Berechtigung nicht haben, gibt das System die Fehlermeldung SecurityException aus.

Bei Berechtigungen, die nur während der Nutzung gelten, kann dies zu Problemen führen. Wenn Ihre App eine Berechtigung vom Typ „Während der Nutzung“ hat, hat sie diese Berechtigung nur während sie im Vordergrund ausgeführt wird. Wenn Ihre App also im Hintergrund ausgeführt wird und versucht, einen Dienst im Vordergrund vom Typ „Kamera“, „Standort“ oder „Mikrofon“ zu erstellen, erkennt das System, dass Ihre App derzeit nicht die erforderlichen Berechtigungen hat, und löst eine SecurityException aus.

Wenn Ihre App sich im Hintergrund befindet und einen Gesundheitsdienst erstellt, für den die Berechtigung BODY_SENSORS erforderlich ist, hat die App diese Berechtigung derzeit nicht und das System löst eine Ausnahme aus. Dies gilt nicht für Gesundheitsdienste, für die andere Berechtigungen erforderlich sind, z. B. ACTIVITY_RECOGNITION. Das Aufrufen von PermissionChecker.checkSelfPermission() verhindert dieses Problem nicht. Wenn Ihre App eine Berechtigung für die Nutzung während der Verwendung hat und checkSelfPermission() aufruft, um zu prüfen, ob sie diese Berechtigung hat, gibt die Methode PERMISSION_GRANTED zurück, auch wenn die App im Hintergrund ausgeführt wird. Wenn die Methode PERMISSION_GRANTED zurückgibt, bedeutet das: „Ihre App hat diese Berechtigung während der Nutzung der App.“

Hinweis :Wenn Sie unter Android-Versionen niedriger als Android 14 versucht haben, einen Dienst im Vordergrund zu erstellen, der Berechtigungen für die Nutzung benötigt, während Ihre App im Hintergrund ausgeführt wird, konnte der Dienst zwar erstellt werden, hatte aber keinen Zugriff auf die erforderlichen Ressourcen. Wenn er versucht hat, sie zu verwenden, wurde eine Ausnahme geworfen. Unter Android 14 oder höher erhält Ihre App die Ausnahme, sobald versucht wird, den Dienst im Vordergrund zu erstellen.

Wenn Ihr Dienst im Vordergrund eine Berechtigung vom Typ „Während der Nutzung“ benötigt, müssen Sie Context.startForegroundService() oder Context.bindService() aufrufen, während in Ihrer App eine sichtbare Aktivität angezeigt wird, es sei denn, der Dienst fällt unter eine der definierten Ausnahmen.

Ausnahmen von Einschränkungen für Berechtigungen, die während der Nutzung aktiv sind

In einigen Fällen kann ein Dienst im Vordergrund auch dann auf Standort-, Kamera- und Mikrofoninformationen zugreifen, wenn die App im Hintergrund ausgeführt wird, während die App im Vordergrund ausgeführt wird („bei Verwendung“).

In diesen Fällen kann der Dienst, wenn er location als Typ des Diensts im Vordergrund deklariert und von einer App gestartet wird, die die Berechtigung ACCESS_BACKGROUND_LOCATION hat, jederzeit auf Standortinformationen zugreifen, auch wenn die App im Hintergrund ausgeführt wird.

Die folgende Liste enthält diese Situationen:

• Eine Systemkomponente startet den Dienst.
• Der Dienst beginnt mit der Interaktion mit App-Widgets.
• Der Dienst beginnt mit der Interaktion mit einer Benachrichtigung.
• Der Dienst beginnt als PendingIntent, die von einer anderen sichtbaren App gesendet wird.
• Der Dienst wird von einer App gestartet, die ein Device Policy Controller ist und im Modus „Geräteinhaber“ ausgeführt wird.
• Der Dienst wird von einer App gestartet, die die VoiceInteractionService bereitstellt.
• Der Dienst wird von einer App gestartet, die die Berechtigung START_ACTIVITIES_FROM_BACKGROUND hat.

Ermitteln, welche Dienste in Ihrer App betroffen sind

Starten Sie beim Testen Ihrer App die Dienste im Vordergrund. Wenn ein gestarteter Dienst den Zugriff auf Standort, Mikrofon und Kamera eingeschränkt hat, wird in Logcat die folgende Meldung angezeigt:

Foreground service started from background can not have \
location/camera/microphone access: service SERVICE_NAME