interface de service PackageManagement

Le Service-Interface PackageManagement pilote le transfert, le traitement et l'activation de paquets logiciels sur l'AUTOSAR Adaptive Platform [SWS_UCM_00345], [SWS_UCM_00352]. Il permet le chargement de paquets par blocs, l'extraction de clusters de logiciels ainsi que leur activation contrôlée en coordination avec le State Management [SWS_UCM_00346], [SWS_UCM_00352]. En outre, le service fournit des mécanismes pour la surveillance de l'état ainsi que pour le rollback et le nettoyage des données de session [SWS_UCM_00353], [SWS_UCM_00361].

plus ›

1. Rôle et contexte système de l'interface de service

Le Service-Interface PackageManagement constitue l'interface centrale de l'Update and Configuration Management (UCM) pour la gestion, le transfert et l'installation de paquets logiciels sur l'AUTOSAR Adaptive Platform [SWS_UCM_00343]. L'instance UCM agit ici typiquement en tant que fournisseur de service (Skeleton), tandis que les coordinateurs de mise à jour ou les clients de diagnostic de niveau supérieur agissent en tant que consommateurs de service (Proxy). Pour l'identification, le service fournit l'identifiant unique d'instance de module via la méthode GetId [SWS_UCM_00343]. Pendant le processus d'activation, l'UCM interagit étroitement avec le State Management, qui doit libérer la session de mise à jour et effectuer des vérifications [SWS_UCM_00352].

2. Méthodes, événements et champs

Toutes les méthodes définies dans le Service-Interface fonctionnent avec une sémantique d'appel synchrone ou avec des messages requête-réponse, car Fire & Forget false est spécifié pour l'ensemble des méthodes [SWS_UCM_00345]. Le champ d'état CurrentStatus dispose d'un getter ainsi que d'un notifier, ce qui permet aux clients de s'abonner aux changements d'état de l'UCM de manière événementielle ou de les interroger activement [SWS_UCM_00361]. De manière complémentaire, GetProgress fournit des informations détaillées sur l'avancement pour l'état actuellement actif de la machine à états [SWS_UCM_00360]. Pour interroger le parc logiciel, GetSwPackages est disponible pour lister les paquets logiciels disponibles [SWS_UCM_00359], GetSwClusterInfo pour les clusters de logiciels installés à l'état kPresent [SWS_UCM_00357], GetSwClusterManifestInfo pour les données de manifeste de cluster [SWS_UCM_00358] ainsi que GetSwClusterChangeInfo pour les modifications en attente dans les états kAdded, kUpdating ou kRemoved [SWS_UCM_00356]. La traçabilité historique des actions exécutées est assurée par GetHistory avec des filtres d'horodatage [SWS_UCM_00355].

3. Cycle de vie, déroulement des sessions et dépendances d'état

Un déroulement typique de mise à jour se divise en transfert, traitement, activation et finalisation. Le transfert de paquets est soit initié par TransferStart, ce qui crée une TransferIdType et négocie la taille de bloc [SWS_UCM_00345], soit alternativement enregistré par RegisterSoftwarePackage avec indication d'un URI de paquet [SWS_UCM_00344]. En cas de transfert par blocs, les blocs de données sont continuellement persistés via TransferData avec indication d'un compteur de blocs [SWS_UCM_00346] et finalisés avec TransferExit [SWS_UCM_00347]. Ensuite, ProcessSwPackage extrait le paquet logiciel [SWS_UCM_00349]. Les traitements en cours peuvent être interrompus définitivement au moyen de Cancel [SWS_UCM_00351] ou suspendus et repris avec Suspend et Resume [SWS_UCM_00397], [SWS_UCM_00398]. Les transferts qui ne sont plus nécessaires peuvent être supprimés avec DeleteTransfer [SWS_UCM_00348]. Avec Activate, les clusters de logiciels extraits sont activés [SWS_UCM_00352], tandis que Finish termine la session de traitement et nettoie les données temporaires [SWS_UCM_00354]. Si des erreurs surviennent, RevertProcessedSwPackages permet une réinitialisation des paquets traités [SWS_UCM_00350] et Rollback permet la restauration de l'état du système antérieur au traitement du paquet [SWS_UCM_00353].

Diagramme de séquence : déroulement typique d'un transfert de paquet, d'un traitement et d'une activation via PackageManagement. Sources : [SWS_UCM_00345], [SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352], [SWS_UCM_00354].

4. Gestion des erreurs et Application Errors

Les méthodes de l'interface couvrent les conditions d'erreur par des Application Errors spécifiques. En cas d'appels contraires au contexte, des méthodes telles que Activate, Cancel, Finish, ProcessSwPackage, TransferData et TransferExit renvoient l'erreur kOperationNotPermitted [SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352]. Les identifiants de transfert non valides sont rejetés avec kTransferIdInvalid [SWS_UCM_00346], [SWS_UCM_00348], tandis que des séquences de blocs incorrectes ou des saturations de mémoire conduisent à kBlockIncorrect, kBlockSizeIncorrect, kBlockInconsistent ou kMemoryInsufficient [SWS_UCM_00345], [SWS_UCM_00346]. Les contrôles de sécurité et de cohérence lèvent des erreurs telles que kAuthenticationFailed, kPackageInconsistent, kPackageManifestInvalid ainsi que kPackageVersionIncompatible [SWS_UCM_00346], [SWS_UCM_00349]. La suppression du système central est empêchée avec kSwclRemovalDenied [SWS_UCM_00349]. Lors de l'activation, kDependencyMissing, kUpdateSessionRejected ou kVerificationFailed signalent des problèmes d'intégration avec les dépendances ou avec le State Management [SWS_UCM_00352].

L'interface de service PackageManagement orchestre le transfert, la validation, l'activation et la finalisation des paquets logiciels sur la plateforme Adaptive [SWS_UCM_00345], [SWS_UCM_00352]. Elle fournit aux applications clientes un contrôle transactionnel complet assorti d'une notification d'état et d'un suivi d'avancement [SWS_UCM_00361]. La stricte vérification des erreurs d'exécution garantit l'intégrité du système avant l'activation définitive des modifications [SWS_UCM_00349].

plus ›

Rôle et contexte système de l'interface de service

L'interface de service PackageManagement constitue le point d'accès central du module UCM (Update and Configuration Management) sur la plateforme AUTOSAR Adaptive [SWS_UCM_00343]. Déployée selon le modèle orienté services d'ara::com, elle est fournie par l'instance UCM (Skeleton) aux applications clientes (Proxy), telles qu'un gestionnaire de mise à jour distant (OTA Client) ou le composant State Management [SWS_UCM_00352]. L'interface orchestre l'ensemble du cycle de déploiement logiciel : réception des paquets, validation des dépendances, extraction, activation et finalisation des modifications sur la machine [SWS_UCM_00345], [SWS_UCM_00354].

Méthodes, événements et champs

L'ensemble des méthodes définies dans PackageManagement sont configurées avec l'attribut Fire & Forget = false, imposant une sémantique d'appel requête-réponse asynchrone via des objets ara::core::Future / Promise côté client [SWS_UCM_00345]. Ces opérations couvrent le transfert de données par blocs (TransferStart, TransferData, TransferExit) ou l'enregistrement direct via URI avec RegisterSoftwarePackage [SWS_UCM_00344], [SWS_UCM_00346], [SWS_UCM_00347]. Des méthodes d'inspection permettent de consulter les grappes logicielles présentes (GetSwClusterInfo), les modifications en attente (GetSwClusterChangeInfo), les métadonnées de manifeste (GetSwClusterManifestInfo), les paquets disponibles (GetSwPackages) et l'historique complet des opérations (GetHistory) [SWS_UCM_00355], [SWS_UCM_00356], [SWS_UCM_00357], [SWS_UCM_00358], [SWS_UCM_00359].

L'interface met également à disposition le champ CurrentStatus de type CurrentStatusType, pourvu d'un accesseur (HasGetter = true) et d'un notificateur d'événements (HasNotifier = true), permettant au client de s'abonner aux changements d'état d'UCM sans recourir à un sondage actif [SWS_UCM_00361]. En complément, la méthode GetProgress retourne l'avancement spécifique de l'état actif dans la machine d'états interne [SWS_UCM_00360]. Le contrôle temporel des opérations longues est assuré par les méthodes Suspend et Resume [SWS_UCM_00397], [SWS_UCM_00398].

Cycle de vie, flux de sessions et dépendances d'état

Le traitement des paquets logiciels suit une séquence transactionnelle stricte identifiée par un identifiant de transfert (TransferIdType) [SWS_UCM_00345]. La session débute par l'allocation d'un transfert via TransferStart ou RegisterSoftwarePackage, suivie du chargement effectif des blocs de données par TransferData puis de la clôture du transfert avec TransferExit [SWS_UCM_00346], [SWS_UCM_00347]. Le client déclenche ensuite le traitement par ProcessSwPackage, qui valide l'intégrité, la compatibilité et extrait les grappes logicielles [SWS_UCM_00349]. L'activation finale via Activate applique les grappes traitées en étroite coordination avec State Management, avant que Finish ne purge les données temporaires de travail [SWS_UCM_00352], [SWS_UCM_00354].

En cas d'incident ou de demande d'annulation avant activation, le client peut interrompre l'opération en cours via Cancel, supprimer un transfert transféré via DeleteTransfer, annuler le traitement de paquets avec RevertProcessedSwPackages, ou restaurer l'état antérieur de la machine à l'aide de Rollback [SWS_UCM_00348], [SWS_UCM_00350], [SWS_UCM_00351], [SWS_UCM_00353].

Diagramme de séquence : Déroulement nominal de transfert, traitement, activation et finalisation d'un paquet logiciel UCM. Sources : [SWS_UCM_00345], [SWS_UCM_00346], [SWS_UCM_00347], [SWS_UCM_00349], [SWS_UCM_00352], [SWS_UCM_00354].

Gestion des erreurs applicatives

L'interface formalise un ensemble exhaustif d'erreurs applicatives (Application Errors) signalant les violations de préconditions, d'état ou d'intégrité [SWS_UCM_00349]. L'erreur kOperationNotPermitted est partagée par la quasi-totalité des méthodes pour interdire un appel hors contexte d'état [SWS_UCM_00346], [SWS_UCM_00352]. Les vérifications de session et de transfert lèvent notamment kTransferIdInvalid, kBlockIncorrect ou kDataInsufficient en cas d'incohérence dans le flux d'octets [SWS_UCM_00346], [SWS_UCM_00347]. Lors du traitement et de l'activation, des vérifications poussées protègent le système contre les paquets corrompus, incompatibles ou obsolètes (kAuthenticationFailed, kPackageVersionIncompatible, kSwclRemovalDenied, kDependencyMissing, kUpdateSessionRejected, kVerificationFailed) [SWS_UCM_00349], [SWS_UCM_00352].