Pour aider les développeurs à définir des services de premier plan destinés aux utilisateurs, Android 10 a introduit l'attribut android:foregroundServiceType
dans l'élément <service>
.
Si votre application cible Android 14, elle doit spécifier les types de services de premier plan appropriés. Comme dans les versions précédentes d'Android, vous pouvez combiner plusieurs types. Cette liste présente les types de services de premier plan disponibles :
camera
connectedDevice
dataSync
health
location
mediaPlayback
mediaProjection
microphone
phoneCall
remoteMessaging
shortService
specialUse
systemExempted
Si un cas d'utilisation dans votre application n'est associé à aucun de ces types, nous vous recommandons fortement de migrer votre logique pour utiliser WorkManager ou les tâches de transfert de données lancé par l'utilisateur.
Les types health, remoteMessaging, shortService, specialUse
et systemExempted
sont nouveaux sur Android 14.
L'extrait de code suivant fournit un exemple de déclaration de type de service de premier plan dans le fichier manifeste :
<manifest ...>
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
<application ...>
<service
android:name=".MyMediaPlaybackService"
android:foregroundServiceType="mediaPlayback"
android:exported="false">
</service>
</application>
</manifest>
Si une application qui cible Android 14 ne définit pas de types pour un service donné dans le fichier manifeste, le système génère MissingForegroundServiceTypeException
lors de l'appel de startForeground()
pour ce service.
Déclarer une nouvelle autorisation pour utiliser les types de services de premier plan
Si les applications qui ciblent Android 14 utilisent un service de premier plan, elles doivent déclarer une autorisation spécifique, basée sur le type de service de premier plan, introduite par Android 14. Ces autorisations apparaissent dans les sections intitulées "Autorisation que vous devez déclarer dans votre fichier manifeste" de la section Cas d'utilisation prévus et mesures d'application pour chaque type de service de premier plan sur cette page.
Toutes les autorisations sont définies comme des autorisations normales et sont accordées par défaut. Les utilisateurs ne peuvent pas les révoquer.
Inclure le type de service de premier plan lors de l'exécution
Une bonne pratique pour les applications qui lancent des services de premier plan consiste à utiliser la version surchargée de startForeground()
, dans laquelle vous transmettez un entier bit à bit de types de service de premier plan. Vous pouvez choisir de transmettre une ou plusieurs valeurs de type.
En règle générale, vous ne devez déclarer que les types requis pour un cas d'utilisation particulier. Cela permet de répondre plus facilement aux attentes du système pour chaque type de service de premier plan. Si un service de premier plan est lancé avec plusieurs types, il doit respecter les mesures d'application de la plate-forme de tous types.
Si vous lancez un service de premier plan qui utilise l'un des types suivants, vous devez toujours inclure les types chaque fois que vous appelez startForeground()
pour ce service :
Service.startForeground(0, notification, FOREGROUND_SERVICE_TYPE_LOCATION)
Si le type de service de premier plan n'est pas spécifié dans l'appel, les valeurs dans le fichier manifeste seront définies par défaut.
Vérifications de l'exécution du système
Le système vérifie que les types de services de premier plan sont utilisés correctement et confirme que l'application a demandé les autorisations d'exécution appropriées ou qu'elle utilise les API requises.
Par exemple, le système s'attend à ce que les applications qui utilisent le type de service FOREGROUND_SERVICE_TYPE_LOCATION
de premier plan demandent ACCESS_COARSE_LOCATION
ou ACCESS_FINE_LOCATION
.
Par conséquent, les applications doivent suivre un ordre d'opérations très spécifique lorsqu'elles demandent des autorisations à l'utilisateur et démarrent des services de premier plan. Les autorisations doivent être demandées et accordées avant que l'application ne tente d'appeler startForeground()
. Les applications qui demandent les autorisations appropriées après le démarrage du service de premier plan doivent modifier cet ordre des opérations et demander l'autorisation avant de démarrer le service de premier plan.
Les spécificités des mesures d'application de la plate-forme apparaissent dans les sections intitulées "Conditions d'exécution" de la section Cas d'utilisation prévus et mesures d'application pour chaque type de service de premier plan sur cette page.
Cas d'utilisation prévus et application forcée pour chaque type de service de premier plan
Pour utiliser un type de service de premier plan donné, vous devez déclarer une autorisation particulière dans votre fichier manifeste, respecter des exigences d'exécution spécifiques et votre application doit respecter l'un des ensembles de cas d'utilisation prévus pour ce type. Les sections suivantes décrivent les autorisations que vous devez déclarer, les exigences d'exécution et les cas d'utilisation prévus pour chaque type.
Caméra
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_CAMERA
- Exigences d'exécution
- Demander l'autorisation d'exécution
CAMERA
- Description
- Continuez à avoir accès à la caméra en arrière-plan, pour les applications de chat vidéo permettant d'effectuer plusieurs tâches en même temps, par exemple.
Appareil connecté
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_CONNECTED_DEVICE
- Exigences d'exécution
Vous devez remplir l'une des conditions suivantes :
Déclarez au moins l'une des autorisations suivantes dans votre fichier manifeste :
Demandez au moins l'une des autorisations d'exécution suivantes :
Appeler
UsbManager.requestPermission()
- Description
Interactions avec des appareils externes nécessitant une connexion Bluetooth, NFC, IR, USB ou réseau.
Synchroniser les données
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_DATA_SYNC
- Exigences d'exécution
- Aucune
- Description
Opérations de transfert de données, telles que :
- Importation ou téléchargement de données
- Opérations de sauvegarde et restauration
- Opérations d'importation ou d'exportation
- Extraction de données
- Traitement des fichiers en local
- Transfert de données d'un appareil vers le cloud via un réseau
Santé
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_HEALTH
- Exigences d'exécution
Vous devez remplir l'une des conditions suivantes :
Déclarez l'autorisation
HIGH_SAMPLING_RATE_SENSORS
dans votre fichier manifeste.Demandez au moins l'une des autorisations d'exécution suivantes :
- Description
Tous les cas d'utilisation de longue durée pour prendre en charge les applications de la catégorie "Remise en forme", tels que les coachs électroniques d'entraînement.
Localisation
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_LOCATION
- Exigences d'exécution
Demandez au moins l'une des autorisations d'exécution suivantes :
- Description
Cas d'utilisation de longue durée nécessitant un accès à la position, tels que la navigation et le partage de position.
Contenus multimédias
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MEDIA_PLAYBACK
- Exigences d'exécution
- Aucune
- Description
- Continuez la lecture audio ou vidéo en arrière-plan. Prend en charge la fonctionnalité d'enregistrement vidéo numérique (DVR) sur Android TV.
Projection multimédia
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MEDIA_PROJECTION
- Exigences d'exécution
- Appelez la méthode
createScreenCaptureIntent()
. - Description
- Projetez du contenu sur un écran externe ou un appareil externe à l'aide des API
MediaProjection
. Il ne doit pas nécessairement s'agir de contenu exclusivement multimédia. Le SDK Cast est exclu.
Micro
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_MICROPHONE
- Exigences d'exécution
- Demandez l'autorisation d'exécution
RECORD_AUDIO
. - Description
- Continuez à utiliser le micro en arrière-plan, par exemple pour un enregistreur vocal ou une application de communication.
Appel téléphonique
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_PHONE_CALL
- Exigences d'exécution
- Déclarez l'autorisation
MANAGE_OWN_CALLS
dans votre fichier manifeste. - Description
- Poursuivez un appel en cours à l'aide des API
ConnectionService
.
Messagerie à distance
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_REMOTE_MESSAGING
- Exigences d'exécution
- Aucune
- Description
- Transférez des messages d'un appareil à un autre. Contribue à la continuité des tâches de messagerie d'un utilisateur lorsqu'il change d'appareil.
Service court
- Autorisation que vous devez déclarer dans votre fichier manifeste
- Aucune
- Exigences d'exécution
- Aucune
- Description
Finalisez rapidement les tâches essentielles qui ne peuvent pas être interrompues ni reportées.
Ce type présente des caractéristiques uniques :
- Il ne peut être exécuté que sur une courte période (environ trois minutes).
- Il est incompatible avec les services de premier plan persistants.
- Il ne peut démarrer d'autres services de premier plan.
- Il ne nécessite pas d'autorisation spécifique à un type, bien que l'autorisation
FOREGROUND_SERVICE
reste nécessaire. - Il est impossible pour un service de premier plan en cours d'exécution de changer de type, depuis ou vers
shortService
.
Le délai d'inactivité pour shortService commence à partir du moment où
Service.startForeground()
est appelé. L'application doit appelerService.stopSelf()
ouService.stopForeground()
avant l'expiration du délai. Sinon, le nouveauService.onTimeout()
est appelé, ce qui permet aux applications d'appeler brièvementstopSelf()
oustopForeground()
pour arrêter leur service.Peu après l'appel de
Service.onTimeout()
, l'application passe dans un état mis en cache et n'est plus considérée comme étant de premier plan, sauf si l'utilisateur interagit activement avec elle. Peu de temps après la mise en cache de l'application et l'arrêt du service, celle-ci reçoit une erreur ANR. Le message ANR mentionneFOREGROUND_SERVICE_TYPE_SHORT_SERVICE
. Pour ces raisons, il est recommandé d'implémenter le rappelService.onTimeout()
.Le rappel
Service.onTimeout()
n'existe pas sur Android 13 ou version antérieure. Si le même service s'exécute sur ces appareils, il ne reçoit pas de délai d'inactivité ni d'erreur ANR. Assurez-vous que votre service s'arrête dès la fin de la tâche de traitement, même s'il n'a pas encore reçu le rappelService.onTimeout()
.Notez que si le délai d'expiration de
shortService
n'est pas respecté, l'application sera ANR, même si d'autres services de premier plan valides ou d'autres processus de cycle de vie de l'application sont en cours d'exécution.Si une application est visible par l'utilisateur ou qu'elle satisfait l'une des exceptions permettant de démarrer les services de premier plan en arrière-plan, appeler à nouveau
Service.StartForeground()
avec le paramètreFOREGROUND_SERVICE_TYPE_SHORT_SERVICE
prolonge le délai avant expiration de trois minutes. Si l'application n'est pas visible par l'utilisateur et qu'elle ne satisfait pas l'une des exceptions, toute tentative de démarrage d'un autre service de premier plan, quel que soit son type, entraîne uneForegroundServiceStartNotAllowedException
Si un utilisateur désactive l'optimisation de la batterie pour votre application, cette dernière sera toujours affectée par le délai d'inactivité du shortService du service de premier plan.
Si vous démarrez un service de premier plan qui inclut le type
shortService
et un autre type de service de premier plan, le système ignore la déclaration du typeshortService
. Toutefois, le service doit toujours respecter les exigences des autres types déclarés.
Utilisation spéciale
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_SPECIAL_USE
- Exigences d'exécution
- Aucune
- Description
Recouvre les cas d'utilisation de services de premier plan valides qui ne sont pas couverts par les autres types de services de premier plan.
En plus de déclarer le type de service de premier plan
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
, les développeurs doivent déclarer les cas d'utilisation dans le fichier manifeste. Pour ce faire, ils doivent spécifier l'élément<property>
dans l'élément<service>
. Ces valeurs et les cas d'utilisation correspondants sont examinés lorsque vous envoyez votre application dans la Google Play Console.<service android:name="fooService" android:foregroundServiceType="specialUse"> <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="foo"/> </service>
Système exempté
- Autorisation que vous devez déclarer dans votre fichier manifeste
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
- Exigences d'exécution
- Aucune
- Description
Réservé pour les applications système et les intégrations système spécifiques, afin de continuer à utiliser les services de premier plan.
Pour utiliser ce type, une application doit correspondre à au moins un des critères suivants :
- L'appareil est en mode démo
- L'application est un Device Owner
- L'application est un Profiler Owner
- Les applications de sécurité ayant le rôle
ROLE_EMERGENCY
- Les applications Device Admin
Autrement, le fait de déclarer ce type renvoie une exception
ForegroundServiceTypeNotAllowedException
.
Application des règles Google Play pour l'utilisation des types de services de premier plan
Au cours des prochains mois, Google Play vous communiquera davantage d'informations sur une règle qui restreint quand et comment votre application déclare les types de services de premier plan, en particulier si ces types ne répondent pas aux attentes du système.