Szybki start: uaktualnianie projektu Java przy użyciu modernizacji GitHub Copilot

GitHub Copilot modernizacje i uaktualnienia dla Java obsługują następujące scenariusze:

• Uaktualnij zestaw Java Development Kit (JDK) do Java 11, 17, 21 lub 25.
• Uaktualnij program Spring Boot do wersji 3.5.
• Uaktualnij platformę Spring Framework do wersji 6.2 lub nowszej.
• Uaktualnij Java EE do Dżakarta EE, do Dżakarta EE 10.
• Uaktualnij program JUnit.
• Zaktualizuj zależności zewnętrznych dostawców do określonej wersji.
• Uaktualnij kompilację Ant do narzędzia Maven.

W tym przewodniku Szybki start pokazano, jak uaktualnić projekt Java przy użyciu modernizacji GitHub Copilot.

Wymagania wstępne

• Konto GitHub z włączonym GitHub Copilot. Wymagany jest plan Free Tier, Pro, Pro+, Business lub Enterprise.
• Jedno z następujących IDE:
  • Najnowsza wersja Visual Studio Code. Musi być w wersji 1.101 lub nowszej.
    • GitHub Copilot w Visual Studio Code. Aby uzyskać instrukcje dotyczące konfiguracji, zobacz Konfigurowanie GitHub Copilot w Visual Studio Code. Pamiętaj, aby zalogować się do konta GitHub w Visual Studio Code.
    • GitHub Copilot modernizacja. Uruchom ponownie Visual Studio Code po instalacji.
  • Najnowsza wersja IntelliJ IDEA. Musi być w wersji 2023.3 lub nowszej.
    • GitHub Copilot. Musi być w wersji 1.5.59 lub nowszej. Aby uzyskać więcej instrukcji, zobacz Set up GitHub Copilot in IntelliJ IDEA (Konfigurowanie GitHub Copilot w środowisku IntelliJ IDEA. Pamiętaj, aby zalogować się do konta GitHub w środowisku IntelliJ IDEA.
    • GitHub Copilot modernizacja. Uruchom ponownie środowisko IntelliJ IDEA po instalacji. Jeśli nie masz zainstalowanego GitHub Copilot, możesz zainstalować GitHub Copilot modernizację bezpośrednio.
    • Aby efektywniej korzystać z GitHub Copilot: w ustawieniach środowiska IntelliJ IDEA, wybierz okno konfiguracji Tools>GitHub Copilot, a następnie zaznacz Auto-approve oraz Trust MCP Tool Annotations. Aby uzyskać więcej informacji, zobacz Konfigurowanie ustawień modernizacji GitHub Copilot w celu zoptymalizowania środowiska IntelliJ.
• Java JDK zarówno dla wersji źródłowej, jak i docelowej zestawu JDK.
• Maven lub Gradle do kompilowania projektów Java.
• Projekt Java zarządzany przez usługę Git przy użyciu narzędzia Maven lub narzędzia Gradle.
• W przypadku projektów opartych na narzędziu Maven: dostęp do publicznego repozytorium Maven Central.
• W ustawieniach Visual Studio Code upewnij się, że chat.extensionTools.enabled jest ustawiona na true. To ustawienie może być kontrolowane przez organizację.

Zaloguj się, aby użyć Copilot, a następnie zainstaluj wymagane rozszerzenie

Aby użyć GitHub Copilot, zaloguj się do konta GitHub w Visual Studio Code. Wybierz ikonę Copilot w górnej części Visual Studio Code, aby uzyskać dostęp do okienka GitHub Copilot. Aby uzyskać więcej informacji na temat konfigurowania GitHub Copilot, zobacz Konsekguruj GitHub Copilot w programie VS Code.

Następnie wykonaj następujące kroki, aby zainstalować rozszerzenie w Visual Studio Code:

1. W Visual Studio Code otwórz widok Extensions na pasku działań.
2. Wyszukaj modernizację GitHub Copilot na rynku.
3. Wybierz GitHub Copilot modernizacja.
4. Na stronie rozszerzenia wybierz pozycję Zainstaluj.
5. Uruchom ponownie Visual Studio Code.

Po zakończeniu instalacji w rogu programu Visual Studio Code pojawi się powiadomienie potwierdzające powodzenie.

Aby uzyskać więcej informacji, zobacz Instalowanie rozszerzenia programu VS Code.

Wybierz projekt Java do uaktualnienia

Na potrzeby tego samouczka wybierz jedno z następujących przykładowych repozytoriów:

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

Uruchom tryb agenta GitHub Copilot i rozpocznij uaktualnienie

Wykonaj następujące kroki, aby uruchomić GitHub Copilot w trybie agenta i rozpocząć proces aktualizacji:

1. Otwórz wybrany projekt Java w Visual Studio Code.

2. Otwórz panel czatu GitHub Copilot.

3. Przełącz się do trybu agenta.

4. Wprowadź monit, taki jak Uaktualnij projekt do Java 21 za pomocą narzędzi do uaktualniania Java lub Uaktualnij projekt do Java 21 i Spring Boot 3.2 za pomocą narzędzi do uaktualniania Java, aby dołączyć informacje o frameworku.

   Uwaga / Notatka

   Jeśli musisz zaktualizować tylko framework lub zależność zewnętrzną, zobacz Zaktualizuj framework lub zewnętrzną zależność przy użyciu modernizacji GitHub Copilot.

5. Po wyświetleniu monitu wybierz pozycję Kontynuuj , aby wygenerować plan uaktualnienia.

Przeglądanie i edytowanie planu uaktualniania

Modernizacja GitHub Copilot analizuje projekt Java w bieżącym obszarze roboczym, w tym jego JDK, narzędzia kompilacji i zależności. Narzędzie generuje plik plan.md , który przedstawia następujące planowane zmiany:

• Źródłowe i docelowe wersje zestawu JDK.
• Ścieżki uaktualniania platformy i biblioteki.

Przejrzyj plan i w razie potrzeby wprowadź zmiany, a następnie wybierz pozycję Kontynuuj , aby kontynuować. Aby uzyskać więcej informacji na temat dostosowywania, takich jak dodawanie dodatkowych parametrów narzędzia kompilacji, zobacz Dostosowywanie planu uaktualniania.

Stosowanie zmian kodu i rozwiązywanie problemów z kompilacją

GitHub Copilot następnie przechodzi do fazy transformacji kodu projektu. Używa narzędzia open-source o nazwie OpenRewrite do zaimplementowania niektórych zmian kodu na podstawie określonych reguł. Następnie sztuczna inteligencja rozwiązuje pozostałe problemy za pośrednictwem dynamicznej pętli kompilacji/naprawy. Postęp można monitorować w obszarze edytora Visual Studio Code, sprawdzając plik progress.md markdown w dowolnym momencie.

Na różnych etapach procesu GitHub Copilot monituje o kontynuowanie.

Aby potwierdzić przekształcenie OpenRewrite, wybierz „Kontynuuj”, aby zaktualizować kod Java za pomocą OpenRewrite. Ten krok może potrwać kilka minut.

W kroku Zatwierdź dynamiczną kompilację/poprawkę wybierz pozycję Kontynuuj , aby skompilować projekt i naprawić błędy.

Copilot iteruje i nadal naprawia błędy, dopóki nie będzie więcej problemów. Postęp jest wyświetlany w pliku progress.md . Pętla będzie kontynuowana do momentu pomyślnego utworzenia projektu.

Zrzut ekranu przedstawiający okienko czatu GitHub Copilot w Visual Studio Code z wynikiem Build-Fix oraz wyróżnionym przyciskiem Kontynuuj.

Sprawdzanie pod kątem luk w zabezpieczeniach i zmian zachowania kodu

W pewnych okolicznościach uaktualnienie może spowodować zmiany w zachowaniu kodu lub wprowadzić biblioteki z problemami związanymi z typowymi lukami i ekspozycjami (CVE). Narzędzie przeprowadza dodatkową kontrolę nad tymi problemami.

Gdy GitHub Copilot monituje Uruchom Walidację, jeśli jakiekolwiek zmodyfikowane zależności mają znane CVE, wybierz pozycję Kontynuuj.

Jeśli znaleziono CVEs, tryb agenta GitHub Copilot próbuje je naprawić. Przejrzyj zmiany w programie VS Code i zdecyduj, czy je zachować.

Po sprawdzeniu CVE po wyświetleniu monitu o uruchomienie weryfikacji spójności zachowania kodu wybierz pozycję Kontynuuj.

Jeśli problemy zostaną znalezione, GitHub Copilot tryb agenta spróbuje je rozwiązać. Zdecyduj, czy zmiany mają być zachowywane, czy odrzucane.

Po zakończeniu testów GitHub Copilot ponownie skompiluje projekt i ponownie uruchomi poprzednie testy.

Jeśli drobne problemy pozostają, które nie wymagają natychmiastowych poprawek, uaktualnienie zostanie ukończone. W przeciwnym razie GitHub Copilot wraca, aby się nimi zająć.

Wyświetl podsumowanie

Po uaktualnieniu narzędzie generuje podsumowanie w pliku summary.md , który zawiera następujące informacje:

• Informacje o projekcie
• Zmieniono wiersze kodu.
• Zaktualizowane zależności.
• Podsumowane zmiany kodu.
• Rozwiązano problemy z zabezpieczeniami i niespójnością kodu CVE, jeśli istnieją.
• Nieuwzględnione drobne problemy z CVE.

Następny krok

Quickstart: generowanie testów jednostkowych za pomocą modernizacji GitHub Copilot