Mulai Cepat: Meningkatkan proyek Java dengan modernisasi GitHub Copilot

Modernisasi dengan GitHub Copilot menghadirkan pengalaman berbasis agen bertenaga AI yang mengotomatiskan alur kerja peningkatan versi Java secara end-to-end - mulai dari analisis proyek dan pembuatan rencana hingga transformasi kode, validasi build, dan remediasi CVE.

Skenario peningkatan yang didukung

  • Tingkatkan Java Development Kit (JDK) ke Java 11, 17, 21, atau 25.
  • Tingkatkan Spring Boot hingga versi 4.0.
  • Tingkatkan Spring Framework hingga versi 7.x.
  • Tingkatkan Java EE ke Jakarta EE, hingga Jakarta EE 11.
  • Tingkatkan Azure SDK untuk Java.
  • Perbarui JUnit.
  • Tingkatkan dependensi pihak ketiga ke versi tertentu.

Prasyarat

  • Akun GitHub dengan GitHub Copilot diaktifkan. Anda memerlukan paket Tingkat Gratis, Pro, Pro+, Bisnis, atau Perusahaan.
  • Java JDK untuk versi JDK sumber dan target.
  • Maven atau Gradle untuk membangun proyek Java.
  • Proyek Java yang dikelola Git menggunakan Maven atau Gradle.
  • Untuk proyek berbasis Maven: akses ke repositori Maven Central publik.

  • Instal GitHub Copilot CLI:

    npm install -g @github/copilot

  • Instal plugin modernisasi GitHub Copilot:

    copilot plugin marketplace add microsoft/modernize-java
copilot plugin install modernize-java@modernize-java

Nota

Akun Azure diperlukan hanya untuk menyebarkan sumber daya ke Azure, dan tidak diperlukan saat menggunakan modernisasi GitHub Copilot untuk membuat perubahan kode.

Jika Anda menggunakan Gradle, hanya pembungkus Gradle versi 5 atau yang lebih baru yang didukung.

Kotlin Domain Specific Language (DSL) tidak didukung.

Pilih proyek Java untuk dimutakhirkan

Untuk tutorial ini, pilih salah satu repositori sampel berikut:

Mulai pemutakhiran

Gunakan langkah-langkah berikut untuk memulai proses peningkatan:

  1. Buka proyek Java yang dipilih di Visual Studio Code.

  2. Di bilah sisi, buka panel GitHub Copilot modernization untuk melihat halaman QuickStart.

  3. Pilih Tingkatkan Java Runtime & Framework.

    Tindakan ini membuka gitHub Copilot Chat dalam mode agen dan secara otomatis memulai proses peningkatan.

    Tip

    Anda juga dapat memilih tugas tertentu dari pohon Tugas di bawah panel Mulai Cepat (misalnya, Tingkatkan Versi Spring Boot atau Tingkatkan Versi EE Jakarta) untuk memicu peningkatan yang ditargetkan.

    Atau, Anda dapat mengetik langsung di GitHub Copilot Chat menggunakan mode agen - misalnya, "Tingkatkan proyek Java saya ke Java 21" - untuk memulai peningkatan.

Cuplikan layar Visual Studio Code yang menampilkan halaman QuickStart dengan tombol Upgrade Java Runtime & Frameworks.

Gunakan langkah-langkah berikut untuk memulai proses peningkatan:

  1. Buka proyek Java yang dipilih di IntelliJ IDEA.

  2. Di bilah sisi, buka panel GitHub Copilot modernization untuk melihat halaman QuickStart.

  3. Pilih Tingkatkan Runtime & Kerangka Kerja.

    Tindakan ini membuka gitHub Copilot Chat dalam mode agen dan secara otomatis memulai proses peningkatan.

    Tip

    Anda juga dapat mengetik langsung di GitHub Copilot Chat menggunakan mode agen - misalnya, "Tingkatkan proyek Java saya ke Java 21" - untuk memulai peningkatan.

Cuplikan layar IntelliJ IDEA yang menampilkan panel modernisasi GitHub Copilot dengan tugas peningkatan dan panel Chat yang menjalankan proses peningkatan.

Gunakan langkah-langkah berikut untuk memulai proses peningkatan:

  1. Buka terminal dan navigasikan ke direktori proyek Java Anda.

  2. Jalankan perintah peningkatan:

    copilot --model claude-sonnet-4.6 --agent modernize-java:modernize-java

  3. Setelah agen berjalan, ketik permintaan upgrade Anda:

    upgrade to Java 21 + Spring Boot 3.5.x

Cuplikan layar terminal yang menunjukkan CLI Copilot memulai peningkatan versi Java dengan agen modernize-java.

Pilih target pembaruan

Setelah Anda memulai peningkatan, agen meminta Anda untuk memilih versi target Anda. Pilih versi Java yang diinginkan dan, jika berlaku, versi Spring Boot untuk proyek Anda.

Screenshot Visual Studio Code yang menunjukkan permintaan pemilihan versi Java target dengan opsi untuk Java 21, 17, dan 25.

Meninjau dan mengedit rencana peningkatan

GitHub Copilot menganalisis proyek Java di ruang kerja saat ini sebagai bagian dari upaya modernisasi, termasuk JDK, perangkat pembangun, dan dependensinya. Alat ini menghasilkan file plan.md yang mencakup:

  • Alat yang Tersedia — JDK yang terdeteksi dan alat build di lingkungan Anda.
  • Panduan — batasan yang ditentukan pengguna untuk proses peningkatan.
  • Opsi — cabang kerja dan konfigurasi pengujian.
  • Tujuan Peningkatan — versi sumber dan target untuk setiap komponen.
  • Technology Stack — analisis kompatibilitas dependensi dengan alasan ketidakcocokan.
  • Upgrade Turunan — upgrade tambahan yang diperlukan oleh target utama (misalnya, migrasi namespace dari javax ke jakarta saat melakukan upgrade ke Spring Boot 3.x).
  • Analisis Dampak — perincian terperinci tentang perubahan dependensi, perubahan kode sumber, perubahan konfigurasi, perubahan CI/CD, dan risiko.
  • Langkah-langkah Peningkatan — langkah-langkah migrasi yang diurutkan dengan kriteria alasan dan verifikasi.

Tinjau paket dan buat perubahan jika diperlukan, lalu konfirmasi untuk melanjutkan. Untuk informasi tentang penyesuaian lebih lanjut, lihat Menyesuaikan paket peningkatan.

Tip

Pastikan paket cocok dengan target peningkatan yang Anda inginkan - misalnya, Java 8 hingga Java 21, Spring Boot 1,5 hingga 3,5.

Tangkapan layar Visual Studio Code yang menunjukkan file plan.md dengan tujuan peningkatan dan tumpukan teknologi.

Jalankan peningkatan

Setelah Anda mengonfirmasi rencana, agen secara otomatis melanjutkan fase transformasi kode. Sebagai bagian dari proses ini, ia melakukan tugas-tugas berikut:

  • Memodifikasi file kode dan konfigurasi untuk memastikan kompatibilitas dengan versi target.
  • Melakukan validasi build untuk mengonfirmasi bahwa proyek berhasil dikompilasi di setiap langkah.
  • Menjalankan validasi pengujian jika diaktifkan dalam opsi rencana.

Agen melakukan iterasi melalui setiap langkah peningkatan hingga semua langkah berhasil diselesaikan. Anda dapat memantau kemajuan kapan saja dengan memeriksa file progress.md di editor.

Screenshot Visual Studio Code yang memperlihatkan file progress.md dengan status langkah pemutakhiran.

Validasi dan perbaikan CVE

Setelah langkah-langkah transformasi kode selesai, agen secara otomatis memindai dependensi untuk masalah Common Vulnerabilities and Exposures (CVE). Jika CVE ditemukan, agen memperbaikinya dengan meningkatkan dependensi yang terpengaruh - tidak ada intervensi manual yang diperlukan. Langkah validasi akhir kemudian berjalan untuk mengonfirmasi semuanya masih membangun dan lulus pengujian setelah perbaikan CVE.

Lihat ringkasan

Setelah peningkatan, alat ini menghasilkan file summary.md , yang mencakup:

  • Ringkasan Eksekutif — gambaran umum satu paragraf tentang apa yang ditingkatkan dan hasilnya.
  • Peningkatan Upgrade — tabel perbandingan sebelum/sesudah yang menyoroti manfaat utama.
  • Kompilasi dan Validasi — status kompilasi dan hasil pengujian.
  • Batasan — masalah yang tidak dapat difiksasi tersisa setelah peningkatan.
  • Langkah berikutnya yang disarankan — tindak lanjut yang disarankan, seperti membuat uji unit atau menangani CVE yang masih belum ditangani.
  • Detail tambahan — metadata proyek, perubahan kode, dan hasil pemindaian CVE.

Cuplikan layar Visual Studio Code yang menampilkan konten ringkasan peningkatan.

Tangkapan layar IntelliJ IDEA yang menunjukkan ringkasan upgrade dengan Hasil Upgrade Java dan panel Chat yang menunjukkan bahwa upgrade telah selesai.

Screenshot terminal yang menunjukkan ringkasan peningkatan dengan perubahan file setelah menyelesaikan Java 11 ke 21 dan Spring Boot 2.7 ke 3.5 upgrade.

Langkah selanjutnya

Quickstart: menghasilkan pengujian unit dengan modernisasi GitHub Copilot

  • Last updated on