Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memutakhirkan versi Java dengan Pengembang Amazon Q

Amazon Q Developer dapat memutakhirkan aplikasi Java Anda ke versi bahasa yang lebih baru di lingkungan pengembangan terintegrasi (IDE). Perubahan yang dapat dilakukan Amazon Q untuk memutakhirkan kode Anda termasuk memperbarui komponen kode yang tidak digunakan lagi dan APIs juga memutakhirkan pustaka, kerangka kerja, dan dependensi lainnya dalam kode Anda.

Untuk mengubah kode Anda, Amazon Q pertama-tama membuat kode Anda dalam versi bahasa sumber dan memverifikasi bahwa ia memiliki informasi yang diperlukan untuk melakukan transformasi. Setelah Amazon Q berhasil mengubah kode Anda, Anda memverifikasi dan menerima perubahan dalam IDE Anda. Karena Amazon Q Developer membuat perubahan minimal yang diperlukan untuk membuat kode yang ditingkatkan kompatibel dengan JDK target, transformasi tambahan diperlukan untuk meningkatkan pustaka dan dependensi proyek Anda. Untuk informasi selengkapnya tentang cara Amazon Q mengubah kode Anda, lihatBagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java.

Upgrade Java yang didukung dan IDEs

Amazon Q saat ini mendukung versi kode sumber Java berikut dan versi target untuk transformasi. Mengubah kode ke versi Java yang sama mencakup pemutakhiran pustaka dan dependensi lainnya dalam versi kode sumber.

Amazon Q mendukung peningkatan Java sebagai berikut: IDEs

Langkah 1: Prasyarat

Sebelum melanjutkan, pastikan Anda telah menyelesaikan langkah-langkah dalam Mengatur Amazon Q di IDE Anda.

Pastikan bahwa prasyarat berikut terpenuhi sebelum Anda memulai pekerjaan Transformasi Kode:

Langkah 2: Konfigurasikan proyek Anda

Untuk mengonfigurasi proyek Anda, gunakan informasi berikut untuk IDE yang Anda gunakan.

Konfigurasikan proyek di JetBrains

Untuk mengonfigurasi proyek AndaJetBrains, Anda mungkin perlu menentukan pengaturan proyek dan modul berikut.

Jika modul Anda menggunakan JDK dan tingkat bahasa yang sama dengan proyek Anda, Anda tidak perlu memperbarui pengaturan modul.

Untuk informasi selengkapnya, lihat Pengaturan struktur proyek dan Pengaturan struktur modul dalam JetBrains dokumentasi.

Konfigurasikan proyek di VS Code

Untuk mengonfigurasi proyek AndaVS Code, proyek Anda harus berisi yang berikut:

Jika proyek Anda berisi Maven wrapper executable (mvnwuntuk macOS atau mvnw.cmd untukWindows), pastikan itu di root proyek Anda. Amazon Q akan menggunakan pembungkusnya, dan tidak ada Maven konfigurasi lain yang diperlukan.

Jika Anda tidak menggunakan Maven pembungkus, instalMaven. Untuk informasi selengkapnya, lihat Menginstal Apache Maven di Apache Maven dokumentasi.

Setelah menginstalMaven, tambahkan ke PATH variabel Anda. Untuk informasi lebih lanjut, lihat runtime Variabel Java Bagaimana cara menambahkan Maven ke saya? PATH Anda juga harus menunjuk ke JDK dan bukan ke JRE. Untuk mengonfirmasi konfigurasi Anda benar, jalankanmvn -v. Output harus menunjukkan Maven versi Anda dan runtime variabel yang menunjuk ke jalur ke JDK Anda.

Langkah 3: Buat file peningkatan ketergantungan (opsional)

Anda dapat memberikan Amazon Q dengan file upgrade dependensi, file YAMAL yang mencantumkan dependensi project Anda dan versi mana yang akan ditingkatkan selama transformasi. Dengan menyediakan file pemutakhiran dependensi, Anda dapat menentukan dependensi pihak ketiga dan pertama yang mungkin tidak diketahui Amazon Q untuk ditingkatkan.

Dependensi pihak pertama mengacu pada pustaka, plugin, dan kerangka kerja yang dikelola organisasi Anda dan hanya tersedia secara lokal atau di jaringan pribadi organisasi Anda. Amazon Q dapat mengakses dependensi pihak pertama Anda saat menjalankan build di lingkungan lokal Anda. Untuk informasi selengkapnya, lihat Membangun kode di lingkungan lokal Anda. Dependensi pihak ketiga tersedia untuk umum atau dependensi open source yang tidak unik untuk organisasi Anda.

Anda dapat menentukan dependensi pihak pertama yang ingin Anda tingkatkan dalam file YAMAL, dan Amazon Q memutakhirkannya selama pemutakhiran JDK (misalnya, Java 8 hingga 17). Anda dapat memulai transformasi terpisah (17 hingga 17 atau 21 hingga 21) setelah pemutakhiran JDK awal untuk meningkatkan dependensi pihak ketiga.

Setelah Amazon Q melakukan upgrade JDK minimum, Anda dapat memulai transformasi terpisah untuk memutakhirkan semua dependensi pihak ketiga. Atau, Anda dapat menentukan dependensi pihak ketiga dan versinya dalam file YAMAL untuk hanya memutakhirkan dependensi tersebut selama transformasi pemutakhiran perpustakaan.

Amazon Q akan meminta Anda untuk memberikan file peningkatan ketergantungan selama transformasi. Jika Anda ingin menyediakannya, pertama-tama pastikan Anda telah mengonfigurasi file dengan benar. Bidang berikut diperlukan dalam file YAMM:

Berikut ini adalah contoh file YAMAL pemutakhiran dependensi, dan konfigurasi yang diperlukan untuk diuraikan Amazon Q:

name: dependency-upgrade
  
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
  
  
dependencyManagement:
  
  dependencies:
  
    - identifier: "com.example:library1"
  
      targetVersion: "2.1.0"
  
      versionProperty: "library1.version"  # Optional
  
      originType: "FIRST_PARTY"   
  
    - identifier: "com.example:library2"
  
      targetVersion: "3.0.0"
  
      originType: "THIRD_PARTY"
  
  plugins:
  
    - identifier: "com.example.plugin"
  
      targetVersion: "1.2.0"
  
      versionProperty: "plugin.version"  # Optional
            
      originType: "THIRD_PARTY"  

Langkah 4: Ubah kode Anda

Sebelum Anda mengubah kode Anda sendiri, Anda mungkin ingin menguji apakah IDE Anda diatur dengan benar dengan mengubah proyek sampel. Berikut ini adalah contoh GitHub proyek yang memenuhi syarat untuk transformasi kode: https://github.com/aws-samples/aws-appconfig-java-sample.

Untuk menguji penyiapan IDE Anda, unduh dan unzip proyek sampel, dan selesaikan langkah-langkah berikut untuk IDE Anda. Jika Anda dapat melihat perubahan yang diusulkan dan ringkasan transformasi, Anda siap untuk mengubah proyek kode Anda sendiri. Jika transformasi gagal, IDE Anda tidak dikonfigurasi dengan benar. Untuk mengatasi masalah konfigurasi, tinjau Langkah 2: Konfigurasikan proyek Anda danPemecahan Masalah.

Untuk memutakhirkan versi bahasa proyek atau modul kode Anda, selesaikan langkah-langkah berikut untuk IDE Anda.

JetBrains

1. Buka modul yang ingin Anda tingkatkanJetBrains. Pastikan Anda telah berhasil membangun proyek Anda di IDE.

2. Pilih logo Amazon Q, lalu masukkan /transform di panel obrolan Amazon Q yang terbuka.

3. Muncul pop-up Transform aplikasi Anda. Pilih proyek yang ingin Anda tingkatkan dari daftar dropdown, lalu pilih Transform.

4. Amazon Q meminta Anda untuk menyediakan file ketergantungan pemutakhiran. Jika Anda telah mengonfigurasi YAMAL dengan dependensi dan versi untuk ditingkatkan, tambahkan file Anda. Amazon Q akan memvalidasi file untuk memastikannya dikonfigurasi dengan benar. Jika Anda mendapatkan kesalahan, tinjau format dan bidang wajib yang dijelaskan diLangkah 3: Buat file peningkatan ketergantungan (opsional).

5. Amazon Q memulai transformasi. Anda dapat melihat kemajuan pada tab Detail transformasi.

6. Setelah transformasi selesai, Anda dapat memverifikasi kode yang ditingkatkan sebelum memperbarui proyek Anda. Untuk melihat kode baru, buka tab Transformation details dan kemudian pilih View diff. Di jendela Terapkan tambalan yang muncul, pilih file untuk membuka tampilan diff dengan kode sumber dan kode yang ditingkatkan.

7. Untuk menerima perubahan yang dibuat Amazon Q, pilih View diff untuk membuka jendela Apply patch. Pilih semua file yang diperbarui, dan pilih OK untuk memperbarui proyek Anda di tempat.

8. Untuk mendapatkan detail tentang cara kode Anda ditingkatkan dan disarankan langkah selanjutnya, pada tab Detail transformasi, pilih Lihat ringkasan transformasi.

Kode Studio Visual

1. Buka proyek atau ruang kerja yang ingin Anda tingkatkan. VS Code Pastikan bahwa Anda telah berhasil membangun proyek Anda di IDE.

2. Pilih logo Amazon Q, lalu masukkan /transform di panel obrolan Amazon Q yang terbuka.

3. Pilih proyek yang ingin Anda tingkatkan dari bilah pencarian di bagian atas IDE.

4. Jika Amazon Q tidak dapat menemukan versi kode sumber Anda, Amazon Q meminta Anda untuk memilih versi kode Anda. Pilih versi tempat kode sumber Anda ditulis, lalu pilih Transform di pop-up untuk melanjutkan.

5. Jika diminta, masukkan JAVA_HOME jalur ke JDK Anda. Untuk informasi selengkapnya, lihat Mengonfigurasi VS Code proyek Anda.

6. Amazon Q meminta Anda untuk menyediakan file ketergantungan pemutakhiran. Jika Anda telah mengonfigurasi YAMAL dengan dependensi dan versi untuk ditingkatkan, tambahkan file Anda. Amazon Q akan memvalidasi file untuk memastikannya dikonfigurasi dengan benar. Jika Anda mendapatkan kesalahan, tinjau format dan bidang wajib yang dijelaskan diLangkah 3: Buat file peningkatan ketergantungan (opsional).

7. Amazon Q memulai transformasi. Anda dapat melihat kemajuan pada tab Transformation Hub.

8. Setelah transformasi selesai, tab Perubahan yang Diusulkan terbuka. Untuk memverifikasi kode yang ditingkatkan sebelum memperbarui proyek Anda, pilih Unduh perubahan yang diusulkan. Pilih file untuk membuka tampilan diff dengan kode sumber dan kode yang ditingkatkan.

9. Untuk menerima perubahan yang dibuat Amazon Q, buka tab Perubahan yang Diusulkan dan pilih Terima.

10. Untuk mendapatkan detail tentang cara kode Anda ditingkatkan dan disarankan langkah selanjutnya, pada Transformation Hub, pilih tombol elipsis Views and More Actions, lalu pilih Show Transformation Summary.