Быстрый старт: Улучшение проекта Java с помощью модернизации приложения с GitHub Copilot

Модернизация приложений с обновлениями Java поддерживает следующие сценарии:

• Обновление пакета средств разработки Java (JDK) до Java 8, 11, 17, 21 или 25.
• Обновление Spring Boot до версии 3.5.
• Обновление Spring Framework до версии 6.2+.
• Обновление Java EE до Jakarta EE, вплоть до Jakarta EE 10.
• Обновление JUnit.
• Обновите сторонние зависимости до указанной версии.
• Переход от сборки Ant на систему сборки Maven.

В этом кратком руководстве показано, как обновить проект Java с помощью модернизации приложений GitHub Copilot.

Предпосылки

• Учетная запись на GitHub с включенной функцией GitHub Copilot. Требуется бесплатный уровень, Pro, Pro+, Бизнес или Корпоративный план.
• Один из следующих сред разработки:
  • Последняя версия Visual Studio Code. Должен быть версии 1.101 или более поздней.
    • GitHub Copilot в Visual Studio Code. Инструкции по настройке см. в разделе "Настройка GitHub Copilot" в Visual Studio Code. Обязательно войдите в учетную запись GitHub в Visual Studio Code.
    • Модернизация приложений GitHub Copilot. Перезапустите Visual Studio Code после установки.
  • Последняя версия IntelliJ IDEA. Должен быть версии 2023.3 или более поздней.
    • GitHub Copilot. Должен быть версии 1.5.59 или более поздней. Дополнительные инструкции см. в разделе "Настройка GitHub Copilot" в IntelliJ IDEA. Обязательно войдите в учетную запись GitHub в IntelliJ IDEA.
    • Модернизация приложений GitHub Copilot. Перезапустите IntelliJ IDEA после установки. Если у вас нет GitHub Copilot, вы можете напрямую установить модернизацию приложений GitHub Copilot.
    • Для более эффективного использования Copilot в модернизации приложений: в параметрах IntelliJ IDEA выберите окно конфигурации Tools>GitHub Copilot , а затем выберите автозаверять и доверять заметкам средства MCP. Дополнительные сведения см. в разделе "Настройка параметров для модернизации приложений GitHub Copilot" для оптимизации интерфейса IntelliJ.
• JDK Java для исходных и целевых версий JDK.
• Maven или Gradle для создания проектов Java.
• Проект Java, управляемый Git, с использованием Maven или Gradle.
• Для проектов на основе Maven: доступ к общедоступному репозиторию Maven Central.
• В параметрах Visual Studio Code, убедитесь, что chat.extensionTools.enabled задано как true. Этот параметр может контролироваться вашей организацией.

Замечание

Если вы используете Gradle, поддерживается только оболочка Gradle версии 5+. Язык для конкретного домена Kotlin (DSL) не поддерживается.

Функция My Tasks еще не поддерживается для IntelliJ IDEA.

Войдите в систему, чтобы использовать Copilot, а затем установите необходимое расширение

Чтобы использовать GitHub Copilot, войдите в учетную запись GitHub в Visual Studio Code. Щелкните значок Copilot в верхней части Visual Studio Code, чтобы получить доступ к области GitHub Copilot. Дополнительные сведения о настройке GitHub Copilot см. в статье "Настройка GitHub Copilot" в VS Code.

Затем выполните следующие действия, чтобы установить расширение в Visual Studio Code:

1. В Visual Studio Code откройте представление расширений на панели действий.
2. Найдите модернизацию приложений GitHub Copilot в Marketplace.
3. Выберите модернизацию приложений GitHub Copilot.
4. На странице расширения нажмите кнопку "Установить".
5. Перезапустите Visual Studio Code.

Подсказка

Чтобы получить лучший интерфейс в IntelliJ, рекомендуется настроить несколько ключевых параметров. Дополнительные сведения см. в разделе "Настройка параметров для модернизации приложений GitHub Copilot" для оптимизации интерфейса IntelliJ.

После завершения установки появится уведомление в углу Visual Studio Code, подтверждающее успешное выполнение.

Дополнительные сведения см. в разделе "Установка расширения VS Code".

Выбор проекта Java для обновления

В целях работы с этим руководством выберите один из следующих репозиториев:

• Maven: uportal-messaging
• Gradle: docraptor-java

Запуск режима агента GitHub Copilot и запуск обновления

Выполните следующие действия, чтобы запустить режим агента GitHub Copilot и запустить процесс обновления:

1. Откройте выбранный проект Java в Visual Studio Code.

2. Откройте панель чата GitHub Copilot.

3. Переключитесь в режим агента.

4. Введите запрос, например обновите проект до Java 21 с помощью средств обновления Java или обновите проект до Java 21 и Spring Boot 3.2 с помощью средств обновления Java для включения сведений о платформе.

   Замечание

   Если необходимо обновить платформу или только стороннюю зависимость, см. статью Об обновлении платформы или сторонней зависимости с помощью модернизации приложений GitHub Copilot.

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

Просмотр и изменение плана обновления

Модернизация приложения GitHub Copilot анализирует проект Java в текущей рабочей области, включая JDK, средства сборки и зависимости. Средство создает файл plan.md , который описывает следующие запланированные изменения:

• Исходные и целевые версии JDK.
• Пути обновления платформы и библиотеки.

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

Подсказка

Убедитесь, что план соответствует целевым объектам обновления, например Java 8 до Java 21, Spring Boot 2.7 до 3.2.

Применение изменений кода и устранение проблем сборки

Затем GitHub Copilot переходит к этапу преобразования кода проекта. Он использует средство с открытым кодом с именем OpenRewrite для реализации некоторых изменений кода на основе определенных рецептов. Затем ИИ устраняет оставшиеся проблемы с помощью динамического цикла сборки и исправления. Вы можете в любое время отслеживать ход выполнения в области редактора Visual Studio Code, проверив файл markdown progress.md.

На различных этапах процесса GitHub Copilot предложит продолжить работу.

Для шага подтверждения преобразования OpenRewrite выберите Продолжить, чтобы обновить код Java с помощью OpenRewrite. Этот шаг может занять несколько минут.

Чтобы утвердить шаг цикла динамической сборки и исправления , нажмите кнопку "Продолжить сборку проекта" и исправьте ошибки.

Copilot выполняет итерацию и продолжает устранять ошибки до тех пор, пока не возникает никаких проблем. Ход выполнения отображается в файле progress.md . Цикл продолжается до тех пор, пока проект не будет успешно создан.

Проверка уязвимостей и изменений в поведении кода

При определенных обстоятельствах обновление может привести к изменению поведения кода или внедрению библиотек с уязвимостями, относящимися к Common Vulnerabilities and Exposures (CVE). Средство выполняет повторную проверку по этим вопросам.

Когда GitHub Copilot предложит выполнить проверку, если все измененные зависимости имеют известные CVEs, нажмите кнопку "Продолжить".

При обнаружении CVEs режим агента GitHub Copilot пытается исправить их. Просмотрите изменения в VS Code и решите, следует ли сохранить их.

После проверки CVE при появлении запроса на выполнение проверки согласованности кода нажмите кнопку "Продолжить".

Если обнаружены проблемы, режим агента GitHub Copilot пытается устранить их. Решите, следует ли сохранить или отменить изменения.

После завершения проверок GitHub Copilot перестраивает проект и повторно запускает предыдущие проверки.

Если незначительные проблемы остаются без немедленных исправлений, обновление завершится. В противном случае GitHub Copilot возвращается к устранению проблем.

Просмотр сводки

После обновления средство создает сводку в файле summary.md , который содержит следующие сведения:

• Сведения о проекте.
• Изменены строки кода.
• Обновлены зависимости.
• Суммированные изменения кода.
• Исправлены проблемы с безопасностью и несоответствием кода CVE, если таковые имеются.
• Не устранены незначительные проблемы CVE.

Следующий шаг

Краткое руководство. Создание модульных тестов с помощью модернизации приложения GitHub Copilot