Migrer une application Angular ancienne : préparer la montée de version
Une application peut fonctionner au quotidien et devenir difficile à maintenir : outils anciens, bibliothèques incompatibles ou compilation fragile. Migrer Angular consiste à remettre cette base à niveau en conservant les parcours existants. Le chantier demande un inventaire des dépendances, des étapes vérifiables et une vraie recette métier.
Une montée de version ne devrait pas commencer par « installons la dernière version et voyons ce qui casse ». Il faut d’abord disposer d’une version de référence qui se lance et dont on connaît le comportement. Sans ce point de départ, il devient difficile de distinguer un défaut ancien d’une régression de migration. Cet article porte sur la remise à niveau technique ; si personne ne peut plus livrer ou comprendre le projet, une reprise Angular peut être nécessaire en premier.
Quelles versions d’Angular sont encore prises en charge
Voici la situation au 3 novembre 2026, d’après la politique de versions Angular. Ces dates sont indicatives et évoluent : elles se revérifient au moment du chantier.
- Angular 22 : sortie le 3 juin 2026, support actif jusqu’en juin 2027, puis correctifs critiques et de sécurité jusqu’en juin 2028.
- Angular 21 : correctifs critiques et de sécurité uniquement, jusqu’en juin 2027.
- Angular 20 : correctifs critiques et de sécurité uniquement, jusqu’au 28 novembre 2026.
- Angular 2 à 19 : plus pris en charge.
Une application en Angular 17 n’est pas en panne pour autant : elle continue de fonctionner. Mais une faille découverte sur sa version n’aura pas de correctif officiel, et les bibliothèques tierces abandonnent peu à peu les versions anciennes. La migration n’a pas besoin d’être faite dans l’urgence, justement parce qu’on peut encore la préparer : le moment subi, c’est celui où une bibliothèque ou une exigence de sécurité l’impose.
Le rythme a aussi changé. Jusqu’à la version 22, Angular sortait une version majeure tous les six mois. La politique annonce désormais une version majeure tous les 12 mois, chacune normalement prise en charge 24 mois, et la version 23 est attendue vers juin 2027. Une application tenue à jour aura moins de montées à absorber.
Identifier la version de départ et une cible compatible
L’inventaire doit relever Angular, Angular CLI, Node.js, TypeScript et RxJS, ainsi que les bibliothèques utilisées. Leurs versions ne se choisissent pas indépendamment : la table officielle de compatibilité Angular précise les combinaisons attendues. Il faut la consulter au moment du chantier, car les versions prises en charge évoluent.
La cible dépend aussi des outils d’interface et des contraintes de livraison de l’entreprise. Une bibliothèque indispensable peut imposer une étape intermédiaire, un changement de composant ou un travail supplémentaire. Le résultat attendu de l’inventaire est un chemin de migration expliqué, avec ses préalables et les points encore incertains.
Inventorier les dépendances qui peuvent bloquer
- Composants d’interface : grilles de données, calendrier, éditeur de texte, fenêtres de dialogue et composants graphiques.
- Formulaires et traductions : validateurs personnalisés, messages d’erreur, internationalisation et formats de dates ou de nombres.
- Services transverses : authentification, échanges avec les API, gestion des erreurs et état partagé entre écrans.
- Construction et livraison : configuration du projet, outils de test, intégration continue et environnement d’hébergement.
- Code spécifique : composants internes, adaptations de bibliothèques et usages d’API anciennes à vérifier.
Exemple fictif : le framework peut être mis à jour, mais un éditeur utilisé dans les comptes rendus ne prend pas en charge la cible retenue. Découvrir ce point avant le chantier permet de comparer les solutions et de prévoir la validation des documents. Le découvrir à la fin met toute la livraison en attente.
Avancer par versions majeures successives
La politique officielle de mise à jour Angular prévoit les montées de version majeure une à une pour ng update. Le guide interactif de migration adapte les instructions aux versions choisies et au projet. Ces outils automatisent certaines transformations, mais ne remplacent pas les vérifications du comportement métier.
Concrètement, passer d’Angular 19 à 22 revient à enchaîner trois montées : de 19 à 20, de 20 à 21, puis de 21 à 22. De 18 à 21, c’est aussi trois étapes. Chacune doit compiler et passer ses vérifications avant la suivante.
- Créer une branche de migration et conserver la référence de la version actuellement livrée.
- Préparer les outils compatibles avec l’étape visée et examiner les instructions officielles correspondantes.
- Appliquer les migrations prévues, mettre à jour les bibliothèques concernées et traiter les incompatibilités.
- Compiler, lancer les vérifications disponibles et essayer les parcours prioritaires avant l’étape suivante.
- Conserver un historique des étapes et des ajustements, puis préparer la recette de la version cible.
Pour un projet très ancien, les étapes intermédiaires peuvent elles-mêmes ne plus être prises en charge. Les outils officiels et les bibliothèques demandent alors une analyse particulière : il ne faut pas présenter toute migration historique comme un enchaînement automatiquement garanti. Le chemin réel doit être validé sur le code du projet.
Passer d’Angular 21 à 22 : ce qui change
La mise à jour se lance avec la commande ng update @angular/core@22 @angular/cli@22, mais le projet doit d’abord remplir deux conditions. D’après la table de compatibilité consultée le 3 novembre 2026, Angular 22 demande Node.js 22 (à partir de 22.22.3), 24 (à partir de 24.15) ou 26, ainsi que TypeScript 6.0. Node.js 20 n’est plus accepté : le poste de développement et l’intégration continue doivent suivre, ainsi que l’hébergement si l’application est rendue côté serveur.
Le guide officiel liste ensuite les changements selon la complexité de l’application. Sur une application métier, ceux-ci méritent le plus d’attention :
- Détection des changements : un composant sans réglage explicite passe en OnPush par défaut. Un écran qui comptait sur l’ancien comportement peut ne plus se rafraîchir ; ChangeDetectionStrategy.Eager permet de le conserver, composant par composant.
- Contrôle des templates : strictTemplates est désormais activé par défaut. Un projet qui ne l’utilisait pas verra apparaître de nouvelles erreurs de compilation.
- Chaînage optionnel : dans un template, une expression avec ?. renvoie undefined et non plus null. Les comparaisons strictes à null sont à revoir.
- Paramètres de route : paramsInheritanceStrategy vaut désormais « always ». Un écran peut donc recevoir des paramètres hérités de toutes les routes parentes.
- API retirées : provideRoutes(), ComponentFactoryResolver et l’intégration de Hammer.js ne sont plus disponibles.
Cette liste ne remplace pas le guide, qui adapte les instructions au projet. Elle montre surtout pourquoi une recette reste nécessaire, même pour une seule version : une partie de ces changements compile sans erreur et ne se voit qu’à l’usage.
Partir d’Angular 17, 18, 19 ou 20 : l’ampleur du chemin
Le guide officiel associe à chaque version majeure une liste d’étapes, classées selon la complexité de l’application : « basique », « moyenne » ou « avancée ». Une application simple n’est concernée que par les premières ; une grosse application métier, par une bonne partie des autres. Leur nombre ne donne pas une durée, mais il mesure l’écart entre deux versions.
- Depuis Angular 17 : cinq montées (18, 19, 20, 21, 22) et 131 étapes listées, dont 30 au niveau basique. C’est le chemin le plus long : il cumule les composants autonomes par défaut (v19), deux changements de version de Node.js (v20, puis v22) et les nouveaux réglages par défaut de la v22.
- Depuis Angular 18 : quatre montées et 106 étapes, dont 26 au niveau basique.
- Depuis Angular 19 : trois montées et 88 étapes, dont 20 au niveau basique.
- Depuis Angular 20 : deux montées et 60 étapes, dont 12 au niveau basique.
Séparer la migration d’une refonte générale
Une migration peut obliger à adapter une partie du code, mais ce n’est pas une raison pour changer simultanément le design, les règles métier et tous les composants. Conserver un périmètre lisible facilite l’identification des régressions. Les améliorations facultatives peuvent être consignées pour un lot ultérieur.
L’équipe doit distinguer trois catégories : les changements indispensables pour compiler et fonctionner, les corrections d’anomalies déjà présentes, et les évolutions souhaitées. Chacune a ses critères d’acceptation. Cela aide à expliquer le devis et évite de faire porter à la montée de version tous les problèmes du produit.
La compilation réussie ne suffit pas à valider la migration
Une application peut compiler et présenter un défaut dans une interaction précise. La recette doit couvrir les parcours utilisés par l’entreprise : connexion, accès selon les profils, saisie et validation, filtres, pagination, exports et changements de langue. Les essais se font avec des données représentatives et sur les appareils réellement visés.
Avant la mise en production, il faut connaître la version à livrer, la procédure de retour et les éléments à observer après le déploiement. Le compte rendu de migration doit préciser la cible atteinte, les dépendances modifiées, les vérifications effectuées et les limites restantes. Il devient la nouvelle référence de maintenance.
Ce qu’il faut pour chiffrer une migration Angular
Le nombre de versions à franchir compte, mais ne suffit pas à estimer le travail. La disponibilité des sources, la qualité de la procédure de lancement, les composants tiers et les moyens de recette peuvent peser davantage. Un audit de compatibilité limité permet de préciser les lots et les risques avant de promettre un délai global.
Je travaille sur des applications web métier Angular, avec une expérience d’interfaces hospitalières comprenant grilles avancées, internationalisation et navigation clavier. Pour préparer votre migration, indiquez la version de départ si vous la connaissez, les principales bibliothèques et les contraintes de livraison. Je vous réponds sous 48 heures pour préciser les informations nécessaires au cadrage. Après la remise à niveau, un suivi de maintenance Angular aide à organiser les prochaines mises à jour.
Questions fréquentes
Peut-on sauter plusieurs versions majeures d’Angular ?
Le chemin documenté avec ng update avance d’une version majeure à la suivante : pour aller de la 19 à la 22, on passe par la 20 et la 21. Pour un projet ancien, il faut examiner les outils, les versions intermédiaires et les bibliothèques avant de valider ce chemin. Une mise à jour directe de toutes les dépendances ne constitue pas une méthode de migration fiable.
Une application en Angular 17 ou 18 doit-elle migrer ?
Ces versions ne sont plus prises en charge : l’application continue de fonctionner, mais une faille découverte n’y aura pas de correctif officiel. Il n’y a pas d’urgence du jour au lendemain, mais il vaut mieux planifier la montée, après un inventaire des dépendances. Au 3 novembre 2026, la cible la plus durable est Angular 22, prise en charge jusqu’en juin 2028.
Combien de temps faut-il pour passer d’Angular 19 à 22 ?
Il n’existe pas de durée standard. Il s’agit de trois montées successives, et le temps dépend moins du framework que des bibliothèques tierces, du code spécifique et des moyens de recette. Un audit de compatibilité limité, sur le code réel, permet de donner un délai fondé.
Faut-il changer tous les écrans pendant la migration ?
Non. L’objectif principal est de remettre à niveau la base technique en conservant les usages. Certains composants peuvent nécessiter une adaptation ou un remplacement, mais une refonte visuelle et de nouvelles fonctions peuvent être traitées dans des lots séparés.
AngularJS et Angular se migrent-ils de la même façon ?
Non. AngularJS désigne les versions 1.x et relève d’un chantier distinct. Avant un devis, il faut identifier précisément le framework de départ. Les instructions de montée de version d’une application Angular moderne ne suffisent pas pour un projet AngularJS.
Quand Angular 20 n’est-il plus pris en charge ?
Le 28 novembre 2026, d’après le calendrier officiel. Après cette date, plus aucun correctif n’est publié pour Angular 20, même de sécurité. L’application continue de fonctionner, mais une faille découverte ensuite ne sera pas corrigée : la cible durable est Angular 22, prise en charge jusqu’en juin 2028.
Combien d’étapes pour passer d’Angular 17 à Angular 22 ?
Cinq montées successives. Le guide officiel liste 131 étapes nécessaires sur ce chemin, dont 30 au niveau basique ; les autres dépendent de ce que le code utilise. Relevé du 6 novembre 2026, à refaire au moment du chantier : ce nombre ne donne pas une durée, il mesure l’écart.
Quand sortira Angular 23 ?
Vers juin 2027, d’après le calendrier officiel. Angular est passé à une version majeure par an : après la v22 de juin 2026, la suivante n’arrive plus six mois plus tard, mais un an plus tard.
Développeuse indépendante à Angers. Huit ans de projets pour l’hôpital, les services de secours, l’aéronautique et l’assurance (CNP, Sodifrance), et trois applications publiées sur l’App Store et Google Play : VetSafe, Equio et Ellyo.