Анализ проектов с помощью помощника по обновлению .NET

В этой статье описывается, как выполнять анализ кода для проектов с помощью помощника по обновлению .NET с помощью Visual Studio или терминала. Анализ создает отчет, который можно просмотреть, чтобы получить дополнительные сведения об обновлении.

Это важно

Помощник по обновлению .NET официально устарел. Вместо этого используйте агент чата модернизации GitHub Copilot , который входит в состав Visual Studio 2026 и Visual Studio 2022 17.14.16 или более поздней версии. Этот агент анализирует проекты и зависимости, создает пошаговый план миграции с целевыми рекомендациями и автоматическими исправлениями кода и фиксирует каждое изменение, чтобы можно было проверить или откатить. Она автоматизирует распространенные задачи переноса — обновление файлов проекта, заменяя устаревшие API и устраняя проблемы сборки, чтобы ускорить модернизацию с меньшими усилиями вручную.

Предварительные требования

Создание отчета в Visual Studio

Выполните следующие действия, чтобы проанализировать проект в Visual Studio.

  1. Откройте Visual Studio.

  2. Откройте проект или решение.

  3. В окне Обозреватель решений щелкните правой кнопкой мыши на решении>Обновить.

    Окно

  4. На вкладке "Помощник по обновлению : главная " выберите "Создать отчет".

    Страница приветствия помощника по обновлению .NET в Visual Studio. Выделена ссылка

  5. Выберите один или несколько проектов для анализа, а затем нажмите кнопку "Далее".

    Страница

  6. Выберите целевую платформу, например .NET 8.0. Затем выберите Далее.

    Страница

  7. Выберите компоненты для анализа и нажмите кнопку "Далее".

    Страница

  8. Индикатор хода выполнения отображается для каждого проекта, который анализируется.

    Мастер анализа помощника по обновлению .NET выполняет анализ.

  9. После завершения анализа отображается информационная панель отчета. Дополнительные сведения о панели мониторинга см. в разделе "Отчеты".

    Мастер анализа .NET Upgrade Assistant отображает дашборд, содержащий результаты анализа.

Создать отчет из командной строки

Выполните следующие действия, чтобы проанализировать проект с помощью терминала. Глобальный инструмент .NET — это интерактивное средство, которое поможет вам выполнить анализ. Используйте клавиши СТРЕЛКА ВВЕРХ и СТРЕЛКА ВНИЗ, чтобы изменить выделенный параметр, и Введите, чтобы запустить этот параметр. На каждом экране представлены параметры настройки отчета.

  1. Откройте терминал и перейдите в папку, содержащую решение или проект, который требуется проанализировать.

  2. Чтобы запустить средство, выполните upgrade-assistant analyze команду.

  3. Вас спрашивают о том, что вы хотите проанализировать. В этом примере выберите источники приложений и нажмите клавишу ВВОД.

    Терминал, показывающий начальный экран опций глобального инструмента .NET Upgrade Assistant. Задан вопрос: «Что вы хотите проанализировать?».

  4. Выберите целевую платформу, например .NET 8.0, и нажмите клавишу ВВОД.

  5. Выберите типы элементов, которые требуется проверить. Используйте Пробел для переключения параметров, а затем нажмите клавишу ВВОД.

  6. На экране файла конфигурации нажмите клавишу N, если у вас нет файла конфигурации набора правил.

  7. Выберите формат созданного отчета. В этом примере выберите "Сохранить как HTML".

  8. Введите имя MyReport и нажмите клавишу ВВОД.

  9. Выберите соответствующий режим конфиденциальности, например "Ограниченный " и нажмите клавишу ВВОД.

  10. Окончательный запрос — это подтверждение, отображающее все выбранные параметры. Нажмите клавишу ВВОД , чтобы выполнить анализ и создать отчет.

    Терминал, показывающий сводный экран параметров глобального инструмента помощника по обновлению .NET. Пользователю будет предложено продолжить работу.

  11. После завершения отчета отобразится сводка отчета. Результаты отчета сохраняются в папке проекта или решения, который был проанализирован.

    Терминал, показывающий результаты команды анализа при использовании глобального средства помощника по обновлению .NET.