Exécuter les services AIDL de manière dynamique

À partir d'Android 11, les services AIDL natifs exécutés dans la partition système peuvent être démarrés et arrêtés de manière dynamique selon les besoins. Les services dynamiques démarrent lors de leur première requête et s'arrêtent automatiquement lorsqu'ils ne sont plus utilisés.

Services pouvant s'exécuter de manière dynamique

Cette fonctionnalité n'est disponible que pour les services natifs dont le cycle de vie peut être contrôlé par init et servicemanager. Les services des packages d'application ne sont pas compatibles et doivent utiliser des services liés à la place.

L'arrêt dynamique consiste à arrêter le processus dans lequel le service s'exécute. Si plusieurs services existent dans le même processus, ils doivent tous être enregistrés comme dynamiques pour être compatibles avec cette fonctionnalité. Ce processus s'arrête ensuite lorsque tous les services sont inutilisés.

Configurer le fichier .rc d'initialisation d'un service

Pour exécuter un service de manière dynamique, ajoutez les options suivantes au fichier .rc d'initialisation du service après la ligne service <name> <cmd> initiale.

interface aidl serviceName
disabled
oneshot

Ces options permettent d'effectuer les opérations suivantes:

  • interface aidl serviceName: autorise servicemanager à trouver le service. Si le service utilise plusieurs interfaces, déclarez chaque interface sur une ligne distincte. Ces noms doivent correspondre exactement à ce que servicemanager attend et peuvent différer du nom du processus.
  • disabled: empêche le service de démarrer automatiquement au démarrage.
  • oneshot: empêche le service de redémarrer automatiquement chaque fois qu'il est arrêté.

Pour en savoir plus, consultez le Readme du langage Android Init dans AOSP.

Exemples :

Enregistrer un service

Chaque service est créé et enregistré auprès de servicemanager. L'enregistrement se produit souvent dans un fichier nommé main.cpp, mais l'implémentation peut varier. L'enregistrement se présente généralement comme suit:

using android::defaultServiceManager;

defaultServiceManager()->addService(serviceName, service);

L'enregistrement est parfois abstrait par BinderService::publish ou BinderService::instantiate, qui appellent le code ci-dessus.

Pour enregistrer un service en tant que service dynamique, remplacez son code d'enregistrement par le code suivant:

#include <binder/LazyServiceRegistrar.h>

using android::binder::LazyServiceRegistrar;

auto lazyRegistrar = LazyServiceRegistrar::getInstance();
lazyRegistrar.registerService(service, serviceName);

servicemanager communique avec LazyServiceRegistrar pour arrêter les services en fonction de leur nombre de références.

Exemples :

Configurer les clients de service AIDL

Obtenir le service

Pour récupérer un service paresseux, vous devez d'abord le démarrer, puis le récupérer. L'appel de getService sur le gestionnaire de services démarre le service, mais généralement, vous souhaitez obtenir le service dès qu'il est disponible, et les variantes waitForService doivent être utilisées. Pour en savoir plus sur leur utilisation, consultez la documentation spécifique au backend.

Libérer le service

L'arrêt dynamique est basé sur le comptage des références. Par conséquent, les clients ne doivent pas conserver le service lorsqu'il n'est pas utilisé.

Exemples :

Désactiver temporairement l'arrêt

Si vous souhaitez qu'un service s'exécute indépendamment jusqu'à ce que certaines tâches soient terminées, puis qu'il passe à un comportement dynamique, vous pouvez utiliser LazyServiceRegistrar::forcePersist pour activer et désactiver l'arrêt dynamique. Si cette méthode est appelée côté serveur, elle doit être appelée avant registerService.

Exemple: apexservice