Exécuter des services AIDL de manière dynamique

Dans Android 11 et versions ultérieures, 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 en fonction des 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 les cycles de vie peuvent être contrôlés par init et servicemanager. Les services dans les packages d'application ne sont pas compatibles et doivent utiliser des services liés à la place.

L'arrêt dynamique fonctionne en arrêtant 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 ne sont plus utilisés.

Configurer le fichier init .rc d'un service

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

interface aidl serviceName
disabled
oneshot

Ces options effectuent les opérations suivantes :

  • interface aidl serviceName : permet à servicemanager de trouver le service. Si le service utilise plusieurs interfaces, déclarez chaque interface sur sa propre ligne. 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 fichier Readme du langage d'initialisation Android dans AOSP.

Exemples :

Enregistrer un service

Chaque service est créé et enregistré auprès de servicemanager. L'enregistrement a souvent lieu 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 comme 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 éteindre 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 différé, il doit être démarré, puis récupéré. L'appel de getService sur le gestionnaire de services démarre le service, mais en général, vous souhaitez obtenir le service dès qu'il est disponible. Les variantes waitForService doivent donc être utilisées. Pour savoir comment les utiliser, consultez la documentation spécifique au backend.

Libérer le service

L'arrêt dynamique est basé sur le comptage des références. Les clients ne doivent donc 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 l'être avant registerService.

Exemple : apexservice