Rövid útmutató: Java-projekt frissítése a GitHub Copilot alkalmazás modernizálásával – Frissítés Java-ra (előzetes verzió)

Ez a rövid útmutató bemutatja, hogyan frissíthet Java-projektet a GitHub Copilot App Modernization – Upgrade for Java (előzetes verzió) használatával.

Előfeltételek

• Egy GitHub-fiók, amelyen engedélyezve van a GitHub Copilot a Vállalati vagy Nagyvállalati csomag használatával.

• A Visual Studio Code legújabb verziója.

• A GitHub Copilot bővítmény legújabb verziója a Visual Studio Code-ban.

• GitHub Copilot App Modernization bővítménycsomag. A telepítési utasításokért tekintse meg a következő szakaszt.

  Ez a bővítménycsomag a következő két bővítményt köti össze:

  • GitHub Copilot App Modernization for Java (előzetes verzió)
  • GitHub Copilot-alkalmazás modernizálása – Frissítés Javához (előzetes verzió)

  Az alkalmazás modernizálásához nincs szükség Java-ra a helyi környezetben. A projekt sikeres létrehozásához azonban telepítse a Java és a Maven megfelelő verzióját. Javasoljuk a Microsoft Build of OpenJDK-t és a Maven-t.

• A forrás- és cél JDK-k telepített verziói.

• Git által felügyelt Java-projekt a Maven vagy a Gradle használatával.

• Maven-alapú projektek esetén: hozzáférés a nyilvános Maven Central-adattárhoz.

• Győződjön meg arról, hogy a "chat.extensionTools.enabled" értéke igaz a Visual Studio Code beállításai között. Ezt a beállítást a szervezet szabályozhatja.

Megjegyzés:

Ha Gradle-t használ, csak a Gradle burkoló 5+ verziója támogatott. A Kotlin DSL nem támogatott.

Jelentkezzen be a Copilot használatához, majd telepítse a szükséges bővítményt

A GitHub Copilot használatához jelentkezzen be a GitHub-fiókjába a Visual Studio Code-ban. A GitHub Copilot panel eléréséhez válassza a Visual Studio Code tetején található Copilot ikont. A GitHub Copilot beállításáról további információt a GitHub Copilot beállítása a VS Code-ban című témakörben talál.

Ezután a következő lépésekkel telepítse a bővítményt a Visual Studio Code-ban:

1. A Visual Studio Code-ban nyissa meg a Bővítmények nézetet a tevékenységsávon.
2. Keresse meg a GitHub Copilot alkalmazás modernizációját a piactéren.
3. Válassza ki a GitHub Copilot App Modernization bővítménycsomagot.
4. A bővítménylapon válassza a Telepítés lehetőséget.
5. Indítsa újra a Visual Studio Code-ot.

A telepítés befejezése után egy értesítésnek kell megjelennie a Visual Studio Code sarkában, amely megerősíti a sikerességet.

További információ: VS Code-bővítmény telepítése.

Java-projekt kiválasztása a frissítéshez

Az oktatóanyag alkalmazásában válasszon az alábbi mintaadattárak közül:

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

Indítsa el a GitHub Copilot-ügynök üzemmódot, és indítsa el a frissítést

A GitHub Copilot-ügynök mód elindításához és a frissítési folyamat elindításához kövesse az alábbi lépéseket:

1. Nyissa meg a kijelölt Java-projektet a Visual Studio Code-ban.
2. Nyissa meg a GitHub Copilot Csevegés panelt.
3. Váltson ügynök üzemmódra.
4. Adjon meg egy kérdést, például frissítse a projektet Java 21-re és Spring Boot 3.2-re.
5. Amikor a rendszer kéri, válassza a Folytatás lehetőséget a frissítési terv létrehozásához.

A frissítési terv áttekintése és szerkesztése

Alkalmazáskorszerűsítés – A Java -frissítés (előzetes verzió) elemzi a Java-projektet az aktuális munkaterületen, beleértve a JDK-t, a buildelési eszközöket és a függőségeket. Az eszköz létrehoz egy plan.md fájlt, amely a következő tervezett módosításokat vázolja fel:

• Forrás- és cél JDK-verziók.
• Keretrendszer- és tárfrissítési útvonalak.

Tekintse át a tervet, és szükség esetén végezze el a módosításokat, majd válassza a Folytatás lehetőséget a folytatáshoz.

Jótanács

Győződjön meg arról, hogy a terv megfelel a kívánt frissítési céloknak – például Java 8-ról Java 21-re, Spring Boot 2.7-ről 3.2-re.

Kódmódosítások alkalmazása és buildelési problémák elhárítása

A GitHub Copilot ezután folytatja a projekt kódátalakítási fázisát. Egy OpenRewrite nevű nyílt forráskódú eszközt használ bizonyos kódmódosítások implementálásához adott receptek alapján. Ezután az AI egy dinamikus buildelési/javítási cikluson keresztül oldja meg a fennmaradó problémákat. A Visual Studio Code szerkesztőterületén bármikor nyomon követheti a folyamat előrehaladását a progress.md Markdown-fájl ellenőrzésével.

A folyamat különböző szakaszaiban a GitHub Copilot kéri a folytatást.

Az OpenRewrite átalakítási lépés megerősítéséhez válassza a Java-kód OpenRewrite használatával történő frissítésének folytatása lehetőséget. Ez a lépés eltarthat néhány percig.

A dinamikus buildelési/javítási ciklus lépésének jóváhagyásához válassza a Folytatás lehetőséget a projekt létrehozásához és a hibák kijavításához.

A Copilot iterál, és továbbra is kijavítja a hibákat, amíg nincs több probléma. A folyamat egy progress.md fájlban jelenik meg. A hurok addig folytatódik, amíg a projekt sikeresen elkészül.

Biztonsági rések és kód viselkedésének változásainak ellenőrzése

Bizonyos körülmények között a frissítés kódviselkedési változásokat okozhat, vagy gyakori biztonsági résekkel és kitettségekkel (CVE) kapcsolatos kódtárakat eredményezhet. Az eszköz további ellenőrzést végez ezekre a problémákra.

Amikor a GitHub Copilot a Futtatás ellenőrzése parancsot kéri, ha a módosított függőségek ismert CVE-kkel rendelkeznek, válassza a Folytatás lehetőséget.

Ha CVE-k találhatók, a GitHub Copilot-ügynök mód megpróbálja kijavítani őket. Tekintse át a VS Code módosításait, és döntse el, hogy megtartja-e őket.

A CVE ellenőrzése után, amikor a rendszer kéri a kód viselkedésének konzisztenciájának futtatását, válassza a Folytatás lehetőséget.

Ha problémákat talál, a GitHub Copilot-ügynök mód megpróbálja megoldani őket. Döntse el, hogy megtartja vagy elveti-e a módosításokat.

Az ellenőrzések befejeződése után a GitHub Copilot újraépíti a projektet, és újrafuttatja az előző ellenőrzéseket.

Ha kisebb problémák maradnak, amelyek nem igényelnek azonnali javítást, a frissítés befejeződött. Ellenkező esetben a GitHub Copilot visszatér a problémák megoldásához.

Az összefoglaló megtekintése

A frissítés után az eszköz létrehoz egy összegzést a summary.md fájlban, amely a következő információkat tartalmazza:

• Projektinformációk.
• A kódsorokat módosították.
• Frissített függőségek.
• Összegzett kódmódosítások.
• Kijavítottuk a CVE biztonsági és kódkonzisztencia-problémáit, ha vannak ilyenek.
• Nem megoldott kisebb CVE-problémák.

Következő lépés

Rövid útmutató: Egységtesztek létrehozása a GitHub Copilot alkalmazás modernizálásával – Frissítés Java-ra (előzetes verzió)