Přizpůsobení plánu upgradu projektu v Javě při použití modernizace GitHub Copilotu

Tento článek popisuje, jak přizpůsobit plán upgradu projektu Java vygenerovaný modernizací GitHub Copilot.

Když zahájíte relaci upgradu, GitHub Copilot vygeneruje soubor plan.md , který popisuje kroky a úlohy potřebné k upgradu. Tento soubor slouží jako podrobný plán procesu upgradu, který můžete přizpůsobit tak, aby lépe vyhovoval potřebám projektu.

Jakmile nástroj vygeneruje soubor plan.md , automaticky se otevře v editoru Visual Studio Code. V této fázi můžete plán zkontrolovat a přizpůsobit, abyste zajistili, že bude v souladu s vašimi konkrétními cíli upgradu.

Příklad struktury souboru plan.md

Následující části popisují ukázkovou plan.md strukturu souborů, aby bylo možné znázornit body přizpůsobení.

Klíčové parametry

Následující části popisují klíčové parametry v plánu, který můžete upravit.

Možnosti příkazů nástroje sestavení

V části Dostupné nástroje agent rozpozná vaše nástroje sestavení (Maven nebo Gradle) a cesty sady JDK. Pokud potřebujete vlastní parametry příkazového řádku pro spuštění sestavení, přidejte je do části Pokyny .

Examples:

• Pro Maven: Use build options: -Dmaven.javadoc.skip=true -s "/path/to/custom/settings.xml"

• Pro Gradle: Use build options: --info -Penv=production

Přizpůsobení cílů upgradu a poskytnutí pokynů

Ve scénářích upgradu v Javě často potřebujete přizpůsobení nad rámec standardních upgradů sady JDK nebo architektury – například k použití změn kódu specifického pro projekt nebo aktualizaci interních knihoven, které nástroj automaticky nerozpozná. Pro podporu těchto potřeb teď modernizace GitHub Copilotu umožňuje přizpůsobení v rámci plánu upgradu. Tato funkce umožňuje poskytnout vlastní recepty, pokyny a vstupy, které vás provedou procesem upgradu. Toto přizpůsobení můžete provést úpravou oddílů Cíle upgradu a Pokyny .

Část Cíle upgradu

V části Cíle upgradu specifikujte více cílových bodů pro upgrade spolu s cíli, které se nacházejí v původním zadání. Pokud je například primárním úkolem upgrade projektu z Java 17 na Java 21, ale projekt také vyžaduje upgrade Log4j z verze 1.x na 2.x, uveďte tento požadavek jako další cíl, jak ukazuje následující příklad výzvy:

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

Část Pokyny

Oddíl Pokyny definuje, jak má Copilot provést upgrade. Zatímco část Cíle upgradu se zaměřuje na to, co je potřeba upgradovat, oddíl Pokyny zachycuje metodologii, konvence, nástroje a pravidla, která řídí chování Copilotu během transformace kódu.

Uveďte všechny pokyny, které vám pomohou řídit, jak Copilot upraví kód, například následující pokyny:

• Pokyny k nástrojům, návodům nebo architekturám, které se mají použít pro změny kódu
• Omezení nebo zákazy určitých přístupů k upgradu.
• Požadavky na styl kódu nebo konvence
• Odkazy na interní soubory, dokumentaci nebo skripty, ke které má agent přístup.
• Znalosti domény jsou užitečné pro opravu chyb nebo provádění upgradů.
• Požadavky na to, jak má agent přidávat poznámky nebo komentovat změny kódu.
• Pokyny k vyčištění dočasných artefaktů vytvořených během procesu upgradu

Obsah tohoto oddílu může být prostý text, hypertextové odkazy nebo odkazy na místní soubory, pokud k nim bude mít přístup Copilot.

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.

Viz také

Modernizace GitHub Copilotu