Szybki start: uaktualnianie projektu Java przy użyciu modernizacji aplikacji Copilot w usłudze GitHub — uaktualnianie dla języka Java (wersja zapoznawcza)

W tym przewodniku wprowadzającym pokazano, jak zaktualizować projekt Java przy użyciu aplikacji GitHub Copilot dla Java (wersja zapoznawcza).

Wymagania wstępne

• Konto usługi GitHub z włączonym rozwiązaniem GitHub Copilot przy użyciu planu Biznesowego lub Enterprise.

• Najnowsza wersja programu Visual Studio Code.

• Najnowsza wersja rozszerzenia GitHub Copilot w programie Visual Studio Code.

• Pakiet rozszerzenia GitHub Copilot App Modernization . Aby uzyskać instrukcje dotyczące instalacji, zobacz następną sekcję.

  Ten pakiet rozszerzeń zawiera następujące dwa rozszerzenia:

  • GitHub Copilot App Modernization for Java (wersja zapoznawcza)
  • Modernizacja aplikacji Copilot w usłudze GitHub — uaktualnianie dla języka Java (wersja zapoznawcza)

  Modernizacja aplikacji nie wymaga języka Java w środowisku lokalnym. Jednak aby pomyślnie skompilować projekt, zainstaluj poprawną wersję języków Java i Maven. Zalecamy kompilację OpenJDK firmy Microsoft oraz Maven.

• Zainstalowane wersje zarówno źródłowego jak i docelowego JDK.

• Projekt Java zarządzany przez usługę Git przy użyciu narzędzia Maven lub Gradle.

• W przypadku projektów opartych na narzędziu Maven: dostęp do publicznego repozytorium Maven Central.

• Upewnij się, że ustawienie "chat.extensionTools.enabled" ma wartość true w ustawieniach programu Visual Studio Code. To ustawienie może być kontrolowane przez organizację.

Uwaga / Notatka

Jeśli używasz narzędzia Gradle, obsługiwana jest tylko wersja wrappera Gradle 5 lub nowsza. DSL Kotlin nie jest wspierany.

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

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

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

1. W programie Visual Studio Code otwórz widok Rozszerzenia na pasku działań.
2. Wyszukaj pozycję GitHub Copilot App Modernization na Marketplace.
3. Wybierz pakiet rozszerzenia GitHub Copilot App Modernization .
4. Na stronie rozszerzenia wybierz pozycję Zainstaluj.
5. Uruchom ponownie program Visual Studio Code.

Po zakończeniu instalacji powinno zostać wyświetlone powiadomienie w rogu programu Visual Studio Code potwierdzającego powodzenie.

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

Wybieranie projektu 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 Copilot usługi GitHub i uruchom uaktualnienie

Wykonaj następujące kroki, aby uruchomić tryb agenta Copilot usługi GitHub i uruchomić proces uaktualniania:

1. Otwórz wybrany projekt Java w programie Visual Studio Code.
2. Otwórz panel Czat Copilot usługi GitHub.
3. Przełącz się do trybu agenta.
4. Wprowadź monit, taki jak Upgrade project to Java 21 and Spring Boot 3.2 (Uaktualnianie projektu do środowiska Java 21 i Spring Boot 3.2).
5. Po wyświetleniu monitu wybierz pozycję Kontynuuj , aby wygenerować plan uaktualnienia.

Przeglądanie i edytowanie planu uaktualniania

Modernizacja aplikacji — uaktualnienie dla języka Java (wersja zapoznawcza) analizuje projekt Java w bieżącym obszarze roboczym, w tym zestaw 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ć.

Wskazówka

Upewnij się, że plan jest zgodny z żądanymi celami uaktualniania — na przykład Java 8 do Java 21, Spring Boot 2.7 do 3.2.

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

Następnie narzędzie GitHub Copilot 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. Możesz monitorować postęp w obszarze edytora programu Visual Studio Code, sprawdzając plik markdown progress.md w każdej chwili.

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

W kroku Potwierdzanie przekształcenia OpenRewrite wybierz pozycję Kontynuuj , aby uaktualnić kod Java przy użyciu polecenia 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 ma więcej problemów. Postęp jest wyświetlany w pliku progress.md . Pętla będzie kontynuowana do momentu pomyślnego utworzenia projektu.

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 w narzędziu GitHub Copilot zostanie wyświetlony monit Uruchom weryfikację, jeśli jakiekolwiek zmodyfikowane zależności mają znane cvEs, wybierz pozycję Kontynuuj.

Jeśli znaleziono CVE, 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, tryb agenta Copilot usługi GitHub spróbuje je rozwiązać. Zdecyduj, czy zmiany mają być zachowywane, czy odrzucane.

Po zakończeniu testów narzędzie 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 je rozwiązać.

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

Szybki start: generowanie testów jednostkowych za pomocą modernizacji aplikacji Copilot w usłudze GitHub — uaktualnianie dla języka Java (wersja zapoznawcza)