Installer l’Assistant de mise à niveau .NET

Cet article explique comment installer l’Assistant Mise à niveau .NET dans Visual Studio ou à l’aide de l’outil CLI (interface de ligne de commande).

Important

L’Assistant Mise à niveau .NET est officiellement obsolète. Utilisez plutôt l’agent de conversation de modernisation GitHub Copilot , qui est inclus avec Visual Studio 2026 et Visual Studio 2022 17.14.16 ou version ultérieure. Cet agent analyse vos projets et vos dépendances, produit un plan de migration pas à pas avec des recommandations ciblées et des correctifs de code automatisés, et valide chaque modification afin de pouvoir valider ou restaurer. Il automatise les tâches courantes de portage : mise à jour des fichiers projet, remplacement des API déconseillées et résolution des problèmes de génération, afin de pouvoir moderniser plus rapidement avec moins d’efforts manuels.

Prérequis

Méthodes

L’Assistant Mise à niveau .NET est intégré à Visual Studio ou peut être installé en tant qu’outil global .NET.

L’Assistant Mise à niveau s’exécute dans Visual Studio, sur la solution ou le projet que vous avez ouvert. L’outil global .NET est une application console interactive qui s’exécute sur une solution ou un fichier projet situé ou sous le répertoire actif.

Pour une expérience simplifiée d'ouverture et de mise à niveau d'un projet dans Visual Studio, utilisez l'Assistant Mise à niveau.

Visual Studio

Les étapes suivantes activent l’Assistant Mise à niveau héritée dans Visual Studio.

  1. Ouvrez Visual Studio.

    Si la fenêtre Ouvrir récent \ Commencer s’ouvre, sélectionnez le lien Continuer sans code.

  2. Sélectionnez le menuOptions>, qui ouvre la fenêtre Options.

  3. Accédez à Tous les paramètres>Projets et solutions>Modernisation.

  4. Sélectionnez l’élément Activer l’Assistant Mise à niveau héritée .

  5. Redémarrer Visual Studio

    Capture d’écran montrant la fenêtre options dans Visual Studio avec la page paramètres de modernisation ouverte.

Outil global .NET

Les étapes suivantes installent l’Assistant Mise à niveau .NET en tant qu’outil global .NET. L’Assistant Mise à niveau .NET est distribué dans le package NuGet upgrade-assistant.

  1. Ouvrez une invite de commandes avec la commande dotnet dans le Path.

  2. Exécutez la commande suivante pour installer l’outil :

    dotnet tool install -g upgrade-assistant

    Important

    L’installation de cet outil peut échouer si vous avez configuré une autre source de flux NuGet. Utilisez le --ignore-failed-sources paramètre pour traiter ces échecs comme des avertissements au lieu d’erreurs, en contournant ces autres sources de flux NuGet :

    dotnet tool install -g --ignore-failed-sources upgrade-assistant

Validation

Les informations suivantes vous aident à déterminer que l’Assistant Mise à niveau .NET est installé.

  • Visual Studio

    Pour déterminer si l’Assistant Mise à niveau .NET est activé, cliquez avec le bouton droit sur n’importe quel projet .NET ou .NET Framework dans la fenêtre Explorateur de solutions et recherchez un élément de menu Mettre à niveau .

  • Outil global .NET

    Ouvrez une invite de commandes et exécutez la upgrade-assistant commande. Si la réponse de commande indique que la commande est inconnue, l’outil n’a pas été installé correctement ou n’est pas dans PATH.

Résoudre les problèmes - Outil global .NET

Si vous avez configuré des sources de flux NuGet supplémentaires, l’installation peut échouer avec une erreur indiquant que le package NuGet n’est pas disponible dans le flux. Utilisez le --ignore-failed-sources paramètre pour traiter ces échecs comme des avertissements au lieu d’erreurs, en contournant les autres sources de flux NuGet :

dotnet tool install -g --ignore-failed-sources upgrade-assistant
  • Last updated on