A Java-projekt frissítési tervének testreszabása a GitHub Copilot-alkalmazások modernizálása során

Ez a cikk bemutatja, hogyan szabhatja testre a GitHub Copilot-alkalmazás modernizálása által létrehozott Java-projektfrissítési tervet.

Frissítési munkamenet indításakor a GitHub Copilot létrehoz egy plan.md fájlt, amely ismerteti a frissítéshez szükséges lépéseket és feladatokat. Ez a fájl a frissítési folyamat tervrajzaként szolgál, amelyet testre szabhat a projekt igényeinek megfelelően.

Miután az eszköz létrehozta a plan.md fájlt, automatikusan megnyílik a Visual Studio Code-szerkesztőben. Ebben a szakaszban áttekintheti és testre szabhatja a tervet, hogy megfeleljen a konkrét frissítési céloknak.

Példa plan.md fájlstruktúrára

A következő szakaszok egy plan.md fájlstruktúrát mutatnak be a testreszabási pontok szemléltetéséhez.

Kulcsparaméterek

A következő szakaszok a módosítható terv legfontosabb paramétereit ismertetik.

Eszköz összeállítása parancsbeállítás

Ez a beállítás a Projektadatok területen található, és lehetővé teszi egyéni parancssori paraméterek megadását a buildelési eszközök végrehajtásához. Az érvényes lehetőségekért tekintse meg a Maven CLI vagy a Gradle CLI dokumentációját a projekttől függően.

Examples:

• Maven esetén: Build tool command options: -Dmaven.javadoc.skip=true -s "/path/to/custom/settings.xml"

• Gradle esetén: Build tool command options: --info -Penv=production

Megjegyzés:

Szükség szerint cserélje le az elérési utat a tényleges settings fájlhelyre. Ez az elérési út csak egy példa.

Teszt validálása

A További feladatok szakaszban a jelölő módosításával engedélyezheti vagy letilthatja a run tests before and after the upgrade tesztvégrehajtást.

• Az egységtesztek frissítés előtti és utáni engedélyezésére true van beállítva.
• Állítsa false értékét a tesztellenőrzés kihagyására.

Ez a beállítás azt szabályozza, hogy az eszköz egységteszteket futtat-e a frissítés során a funkcionális helyesség ellenőrzéséhez.

A beállítások módosításával finomhangolhatja a frissítési folyamatot, hogy jobban megfeleljen a projekt követelményeinek.

A frissítési célok testreszabása és irányelvek megadása

Java-frissítési forgatókönyvekben gyakran a szokásos JDK- vagy keretrendszerfrissítéseken túli testreszabásra van szükség – például projektspecifikus kódmódosítások alkalmazásához vagy belső kódtárak frissítéséhez, amelyeket az eszköz nem észlel automatikusan. Ezeknek az igényeknek a támogatásához a GitHub Copilot alkalmazás modernizálása mostantól lehetővé teszi a frissítési csomagon belüli testreszabást. Ez a funkció lehetővé teszi, hogy saját recepteket, utasításokat és bemeneteket adjon meg a frissítési folyamat irányításához. Ezt a testreszabást a Frissítési célok és irányelvek szakasz módosításával hajthatja végre.

A Frissítési célok szakasz

A Frissítési célok szakaszban mostantól további frissítési célokat és a kezdeti parancssorban szereplő célkitűzéseket is megadhat. Ha például az elsődleges feladat a projekt java 17-ről Java 21-re való frissítése, de a projekthez a Log4j 1.x-ről 2.x-re való frissítésére is szükség van, ezt további célként is listázhatja, ahogyan az alábbi példa parancssorában látható:

## Upgrade Goals
- Upgrade from Java 17 to 21
- Upgrade org.apache.logging.log4j:* to 2.24.3 
- Upgrade org.internal.lib to 2.0

Az Irányelvek szakasz

Az Irányelvek szakasz azt határozza meg, hogy a Copilot hogyan végezze el a frissítést. Míg a Frissítési célok szakasz a frissíteni kívánt elemekre összpontosít, az Irányelvek szakasz rögzíti a Copilot viselkedését irányító módszertant, konvenciót, eszközt és szabályokat a kódátalakítás során.

Bármilyen utasítást megadhat, amely segít befolyásolni, hogy a Copilot hogyan módosítja a kódot, például az alábbi utasításokat:

• Útmutató a kódmódosításokhoz használandó eszközökről, receptekről vagy keretrendszerekről.
• Bizonyos frissítési megközelítések korlátozásai vagy tilalmai.
• Kódstílusra vagy konvenciókra vonatkozó követelmények.
• Az ügynök által elérhető belső fájlokra, dokumentációkra vagy szkriptekre mutató hivatkozások.
• A hibák kijavításához vagy a frissítések végrehajtásához hasznos tartományismeret.
• Az ügynöknek a kódmódosítások megjegyzéseivel kapcsolatos követelmények.
• A frissítési folyamat során létrehozott ideiglenes összetevőkre vonatkozó karbantartási utasítások.

Ennek a szakasznak a tartalma lehet egyszerű szöveg, hiperhivatkozás vagy helyi fájlokra való utalás, amíg a Copilot hozzáfér hozzájuk.

Examples:

## Guidelines
- Do not use Log4j 1 to Log4J 2 API bridge to upgrade to Log4J 2. 
- Please follow the code conventions defined in /xxx/bbb/rules.txt.
- Please provide detailed comments explaining why each code change is necessary.
- "com.example:internal-lib:2.0.0" is compatible with Java 21.
- Use our internal MCP tool get_internal_lib_knowledge to retrieve compatibility information for internal libraries.
- After the upgrade, please remove any temporary files created during the process, such as code modification scripts.

Lásd még

GitHub Copilot-alkalmazás modernizálása