Přizpůsobení plánu upgradu projektu v Javě při modernizaci aplikace GitHub Copilot

Tento článek popisuje, jak přizpůsobit plán upgradu projektu v Javě vygenerovaný modernizací aplikace 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.

Příkazová možnost nástroje sestavení

Tato možnost se nachází v části Informace o projektu a umožňuje definovat vlastní parametry příkazového řádku pro spuštění nástroje sestavení. Platné možnosti najdete v dokumentaci k rozhraní příkazového řádku Maven nebo Gradle CLI v závislosti na vašem projektu.

Examples:

Pro Maven: Build tool command options: -Dmaven.javadoc.skip=true -s "/path/to/custom/settings.xml"
Pro Gradle: Build tool command options: --info -Penv=production

Poznámka:

Podle potřeby nahraďte cestu skutečným settings umístěním souboru. Tato cesta je jen příkladem.

Ověření testu

Nachází se v části Další úlohy , můžete povolit nebo zakázat spuštění testu úpravou příznaku run tests before and after the upgrade .

Nastavte na true povolení testů jednotek před upgradem a po upgradu.
Nastavte false pro přeskočení ověření testu.

Toto nastavení určuje, jestli nástroj spouští testy jednotek, aby během upgradu ověřil funkční správnost.

Úpravou těchto nastavení můžete proces upgradu doladit tak, aby lépe vyhovoval požadavkům vašeho projektu.

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 aplikace GitHub Copilot 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 teď můžete zadat více cílů upgradu společně s cíli stanovenými ve vaší počáteční výzvě. Pokud je například primárním úkolem upgrade projektu z Javy 17 na Javu 21, ale projekt také vyžaduje upgrade Log4j z verze 1.x na 2.x, můžete to zobrazit jako další cíl, jak je znázorněno v následujícím příkladu 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.

Můžete zahrnout jakékoli pokyny, které vám pomůžou určit, 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.