Skip to content

Vous souhaitez recevoir de l'aide sur ce sujet ? rejoignez la communauté Angular.fr sur Discord.

Comment mettre à jour votre projet avec "ng update" ​

La mise à jour régulière de votre projet Angular est essentielle pour bénéficier des dernières fonctionnalités, améliorations de performances et correctifs de sécurité. Voici un guide étape par étape pour vous aider à mettre à jour votre projet Angular en toute sérénité.

1. Préparation ​

Avant de commencer la mise à jour, il est crucial de prendre quelques précautions :

  • Sauvegardez votre projet : Utilisez un système de contrôle de version comme Git pour créer une nouvelle branche dédiée à la mise à jour.
  • Vérifiez votre version actuelle : Dans le terminal, exécutez ng version pour connaître la version d'Angular que vous utilisez actuellement.

2. Mise à jour d'Angular CLI ​

La première étape consiste à mettre à jour Angular CLI :

  1. Mettez à jour Angular CLI globalement :
    sh
    npm install -g @angular/cli@latest
  2. Vérifiez la nouvelle version installée :
    sh
    ng version

3. Mise à jour du projet local ​

Une fois Angular CLI mis à jour, passez à votre projet local :

  1. Naviguez vers le répertoire de votre projet dans le terminal.
  2. Exécutez la commande de mise à jour :
    sh
    ng update @angular/core @angular/cli
    Cette commande mettra à jour le noyau d'Angular et CLI dans votre projet.

4. Mise à jour des dépendances ​

Après avoir mis à jour Angular, il est important de mettre à jour les autres dépendances :

  1. Exécutez :

    sh
    ng update

    Cette commande analysera votre projet et suggérera des mises à jour pour les dépendances compatibles.

  2. Suivez les recommandations fournies par la commande pour mettre à jour les packages nécessaires.

5. Résolution des problèmes de compatibilité ​

Après la mise à jour, vous pourriez rencontrer des problèmes de compatibilité. Voici comment les gérer :

  1. Lisez attentivement les messages d'erreur ou les avertissements lors de la mise à jour.
  2. Consultez le guide de migration officiel d'Angular pour votre version spécifique.
  3. Mettez à jour votre code en conséquence, en suivant les recommandations du guide de migration.

Autres migrations ​

Composant standalone ​

Si vous souhaitez migrer un composant Angular vers un composant standalone, vous pouvez utiliser la commande suivante :

bash
ng g @angular/core:standalone

Migrer vers les contrôles de flux ​

Si vous souhaitez migrer des syntaxes ngIf, ngFor et ngSwitch vers les nouvelles syntaxes @if, @for et @switch, vous pouvez utiliser la commande suivante :

bash
ng g @angular/core:control-flow-migration