GitHub Copilot uygulama modernleştirmesini kullanırken Java proje yükseltme planını özelleştirme

Bu makalede GitHub Copilot uygulama modernleştirmesi tarafından oluşturulan Java proje yükseltme planının nasıl özelleştirileceği açıklanır.

Bir yükseltme oturumu başlattığınızda GitHub Copilot, yükseltme için gereken adımları ve görevleri özetleyen bir plan.md dosyası oluşturur. Bu dosya, projenizin gereksinimlerine daha iyi uyacak şekilde özelleştirebileceğiniz yükseltme işlemi için bir şema görevi görür.

Araç plan.md dosyasını oluşturduktan sonra otomatik olarak Visual Studio Code düzenleyicisinde açılır. Bu aşamada, planı gözden geçirip özelleştirerek belirli yükseltme hedeflerinize uygun olduğundan emin olabilirsiniz.

Örnek plan.md dosya yapısı

Aşağıdaki bölümlerde özelleştirme noktalarını göstermek için örnek plan.md dosya yapısı açıklanmaktadır.

Anahtar parametreleri

Aşağıdaki bölümlerde, plandaki değiştirebileceğiniz anahtar parametreler açıklanmaktadır.

Oluşturma aracı komut seçeneği

Bu seçenek Proje Bilgileri altında bulunur ve derleme aracı yürütme için özel komut satırı parametreleri tanımlamanızı sağlar. Geçerli seçenekler için, projenize bağlı olarak Maven CLI veya Gradle CLI belgelerine bakın.

Examples:

• Maven için: Build tool command options: -Dmaven.javadoc.skip=true -s "/path/to/custom/settings.xml"

• Gradle için: Build tool command options: --info -Penv=production

Uyarı

Gerektiğinde yolu gerçek settings dosya konumunuzla değiştirin. Gösterilen bu yol yalnızca bir örnektir.

Test doğrulama

Ek Görevler bölümünde bulunan bayrağını değiştirerek test yürütmesini run tests before and after the upgrade etkinleştirebilir veya devre dışı bırakabilirsiniz.

• true Yükseltmeden önce ve sonra birim testlerini etkinleştirmek için olarak ayarlayın.
• false olarak ayarlayarak test doğrulamasını atlayın.

Bu ayar, aracın yükseltme sırasında işlevsel doğruluğu doğrulamak için birim testleri çalıştırıp çalıştırmadığını denetler.

Bu ayarları yaparak, yükseltme işlemini projenizin gereksinimlerine daha iyi uyacak şekilde ayarlayabilirsiniz.

Yükseltme hedeflerini özelleştirme ve yönergeler sağlama

Java yükseltme senaryolarında genellikle standart JDK veya çerçeve yükseltmelerinin ötesinde özelleştirmeye ihtiyacınız vardır. Örneğin, projeye özgü kod değişiklikleri uygulamak veya aracın otomatik olarak algılamadığı iç kitaplıkları güncelleştirmek için. Bu ihtiyaçları desteklemek için GitHub Copilot uygulama modernleştirmesi artık yükseltme planında özelleştirmeye olanak sağlıyor. Bu özellik, yükseltme işlemine rehberlik etmek için kendi tariflerinizi, yönergelerinizi ve girişlerinizi sağlamanıza olanak tanır. Yükseltme Hedefleri ve Yönergeler bölümlerini değiştirerek bu özelleştirmeyi gerçekleştirebilirsiniz.

Yükseltme Hedefleri bölümü

Yükseltme Hedefleri bölümünde, artık ilk isteminizdeki hedeflerle birlikte daha fazla yükseltme hedefi belirtebilirsiniz. Örneğin, birincil görev projeyi Java 17'den Java 21'e yükseltmekse, ancak proje log4j'yi 1.x'ten 2.x'e yükseltmeyi de gerektiriyorsa, bunu aşağıdaki örnek istemde gösterildiği gibi ek bir hedef olarak listeleyebilirsiniz:

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

Yönergeler bölümü

Yönergeler bölümü, Copilot'un yükseltmeyi nasıl gerçekleştirmesi gerektiğini tanımlar. Yükseltme Hedefleri bölümü yükseltilmesi gerekenlere odaklanırken, Yönergeler bölümü Kod dönüştürme sırasında Copilot'un davranışına yol gösteren metodolojiyi, kuralları, araçları ve kuralları yakalar.

Aşağıdaki yönergeler gibi Copilot'un kodu nasıl değiştirdiğini yönlendirmeye yardımcı olan tüm yönergeleri ekleyebilirsiniz:

• Kod değişiklikleri için kullanılacak araçlar, tarifler veya çerçeveler hakkında rehberlik.
• Belirli yükseltme yaklaşımlarında kısıtlamalar veya yasaklar.
• Kod stili veya kural gereksinimleri.
• Ajanın erişebileceği iç dosyalara, belgelere veya betiklere erişilebilecek bağlantılar.
• Hataları düzeltmeye veya yükseltmeleri gerçekleştirmeye yardımcı olan etki alanı bilgisi.
• Ajanın kod değişikliklerine açıklama eklemesi için gereksinimler.
• Yükseltme işlemi sırasında oluşturulan geçici yapıtlar için temizleme yönergeleri.

Bu bölümün içeriği, Copilot tarafından erişilebildiği sürece düz metin, köprü veya yerel dosyalara başvuru olabilir.

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.

Ayrıca bakınız

GitHub Copilot uygulamasını modernleştirme