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, lihat[Bagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java](how-CT-works.md).
**Topics**
+ [Upgrade Java yang didukung dan IDEs](#supported-languages-IDEs)
+ [Langkah 1: Prasyarat](#java-upgrade-prerequisites)
+ [Langkah 2: Konfigurasikan proyek Anda](#configure-project)
+ [Langkah 3: Buat file peningkatan ketergantungan (opsional)](#create-dependency-upgrade-file)
+ [Langkah 4: Ubah kode Anda](#transform-code-java)
+ [Bagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java](how-CT-works.md)
## 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.
**Upgrade Java yang didukung**
| Versi kode sumber | Versi target yang didukung |
| --- | --- |
| Java 8 | Java 17 dan Java 21 |
| Java 11 | Java 17 dan Java 21 |
| Jawa 17 | Java 17 dan Java 21 |
| Jawa 21 | Java21 |
Amazon Q mendukung peningkatan Java sebagai berikut: IDEs
+ Modul di JetBrains IDEs
+ Proyek dan ruang kerja di Visual Studio Code
## Langkah 1: Prasyarat
Sebelum melanjutkan, pastikan Anda telah menyelesaikan langkah-langkah dalam [Mengatur Amazon Q di IDE Anda](q-in-IDE-setup.md).
Pastikan bahwa prasyarat berikut terpenuhi sebelum Anda memulai pekerjaan Transformasi Kode:
+ Proyek Anda ditulis dalam [Javaversi yang didukung](#supported-languages-IDEs) dan dibangun di atasnyaMaven.
+ Proyek Anda berhasil dibangun dengan Maven IDE Anda. Maven3.8 atau yang lebih baru saat ini didukung.
+ Sumber proyek Anda JDK tersedia secara lokal dan merupakan versi kode sumber Anda. Misalnya, jika Anda mengubah kode Java 8, instalasi JDK lokal Anda harus JDK 8.
+ Proyek Anda dibangun dalam 55 menit atau kurang.
+ Proyek Anda dikonfigurasi dengan benar, dan versi JDK yang benar ditentukan. Untuk informasi selengkapnya, lihat [Langkah 2: Konfigurasikan proyek Anda](#configure-project).
+ Proyek Anda tidak memerlukan akses ke sumber daya di jaringan pribadi Anda, termasuk virtual private cloud (VPC) atau jaringan on-premise. Misalnya, jika proyek Anda berisi pengujian unit yang terhubung ke database di jaringan Anda, transformasi akan gagal.
+ Proyek Anda tidak menggunakan plugin yang mengemas bahasa selain Java di proyek Java Anda. Misalnya, jika proyek Anda menggunakan kode [frontend-maven-plugin](https://github.com/eirslett/frontend-maven-plugin)untuk mengeksekusi front-end selain JavaScript kode sumber Java Anda, transformasi akan gagal.
+ Jaringan lokal Anda memungkinkan unggahan ke bucket Amazon S3 yang digunakan Amazon Q untuk mengubah kode Anda. Untuk informasi selengkapnya, lihat [Mengizinkan akses ke bucket Amazon S3 di](firewall.md#data-perimeters) perimeter data.
+ Aplikasi Anda hanya menggunakan karakter UTF-8. Jika aplikasi Anda menggunakan karakter non-UTF-8, Amazon Q masih akan mencoba mengubah kode Anda.
## 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.
+ Project SDK — JDK yang digunakan untuk mengkompilasi proyek Anda.
+ Tingkat bahasa proyek - Java Versi yang digunakan dalam proyek Anda.
+ Modul SDK - JDK yang digunakan untuk mengkompilasi modul Anda.
+ Tingkat bahasa modul - Java Versi yang digunakan dalam modul Anda.
+ Maven Runner JRE - JDK tempat Anda membangun modul Anda.
**Perbarui pengaturan proyek dan modul**
Untuk memperbarui pengaturan tingkat SDK dan bahasa untuk proyek atau modul Anda, selesaikan langkah-langkah berikut:
1. Dari JetBrains IDE Anda, pilih **File** dan kemudian **Project Structure**.
1. Jendela Struktur Proyek terbuka. Di bawah **Pengaturan Proyek**, pilih **Proyek**.
1. **Untuk memperbarui JDK proyek Anda, pilih dari daftar tarik-turun di samping SDK.**
1. Untuk memperbarui bahasa proyek Anda, pilih dari dropdown di sebelah tingkat **Bahasa**.
1. Di bawah **Pengaturan Proyek**, pilih **Modul**.
1. **Untuk memperbarui modul JDK Anda, pilih dari daftar tarik-turun di sebelah SDK.**
1. Untuk memperbarui bahasa modul Anda, pilih dari dropdown di sebelah tingkat **Bahasa**.
Untuk informasi selengkapnya, lihat [Pengaturan struktur proyek](https://www.jetbrains.com/help/idea/project-settings-and-structure.html) dan [Pengaturan struktur modul](https://www.jetbrains.com/help/idea/configure-modules.html) dalam JetBrains dokumentasi.
**Perbarui pengaturan Maven**
Untuk memperbarui Maven Runner JRE Anda, selesaikan langkah-langkah berikut:
1. Dari JetBrains IDE Anda, pilih ikon roda gigi, lalu pilih **Pengaturan** di menu yang muncul.
1. **Di jendela **Pengaturan**, pilih **Build, Execution, Deployment,** lalu **Build Tools**, lalu **Maven**, dan kemudian Runner.**
1. Di bidang JRE, pilih JDK yang digunakan untuk membangun modul yang Anda ubah.
### Konfigurasikan proyek di VS Code
Untuk mengonfigurasi proyek AndaVS Code, proyek Anda harus berisi yang berikut:
+ `pom.xml`File di folder root proyek
+ Sebuah `.java` file dalam direktori proyek
Jika proyek Anda berisi Maven wrapper executable (`mvnw`untuk 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](https://maven.apache.org/install.html) 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`](troubleshooting-code-transformation.md#add-maven-to-path) Anda juga harus menunjuk ke JDK dan bukan ke JRE. Untuk mengonfirmasi konfigurasi Anda benar, jalankan`mvn -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](how-CT-works.md#java-local-builds). 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:
+ name - Nama file upgrade dependensi.
+ deskripsi (opsional) - Deskripsi file peningkatan ketergantungan, dan untuk transformasi mana.
+ DependencyManagement - Berisi daftar dependensi dan plugin untuk meng-upgrade.
+ dependensi - Berisi nama dan versi pustaka untuk ditingkatkan.
+ plugins - Berisi nama dan versi plugin untuk meng-upgrade.
+ identifier - Nama perpustakaan, plugin, atau ketergantungan lainnya.
+ TargetVersion - Versi ketergantungan untuk meng-upgrade ke.
+ versionProperty (opsional) - Versi dependensi yang Anda definisikan, seperti yang ditetapkan dengan `properties` tag dalam file aplikasi Anda. `pom.xml`
+ OriginType - Apakah ketergantungan adalah pihak pertama atau ketiga, ditentukan oleh FIRST\$1PARTY atau THIRD\$1PARTY.
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
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](#configure-project) dan[Pemecahan masalah](troubleshooting-code-transformation.md).
**catatan**
Jangan mematikan, menutup, atau menidurkan mesin lokal Anda selama transformasi kode. Build awal dan validasi menggunakan lingkungan sisi klien, yang membutuhkan koneksi jaringan yang stabil.
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.
1. Pilih logo Amazon Q, dan minta Amazon Q untuk mengubah aplikasi Anda di panel obrolan yang terbuka.
1. Muncul pop-up **Transform aplikasi Anda**. **Pilih proyek yang ingin Anda tingkatkan dari daftar dropdown, lalu pilih Transform.**
1. 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 di[Langkah 3: Buat file peningkatan ketergantungan (opsional)](#create-dependency-upgrade-file).
1. Amazon Q memulai transformasi. Anda dapat melihat kemajuan pada tab **Detail transformasi**.
1. 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.
1. 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.
1. 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.
1. Pilih logo Amazon Q, dan minta Amazon Q untuk mengubah aplikasi Anda di panel obrolan yang terbuka.
1. Pilih proyek yang ingin Anda tingkatkan dari bilah pencarian di bagian atas IDE.
1. 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.
1. Jika diminta, masukkan `JAVA_HOME` jalur ke JDK Anda. Untuk informasi selengkapnya, lihat [Mengonfigurasi VS Code proyek Anda](#configure-vsc).
1. 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 di[Langkah 3: Buat file peningkatan ketergantungan (opsional)](#create-dependency-upgrade-file).
1. Amazon Q memulai transformasi. Anda dapat melihat kemajuan pada tab **Transformation Hub**.
1. 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.
1. Untuk menerima perubahan yang dibuat Amazon Q, buka tab **Perubahan yang Diusulkan** dan pilih **Terima**.
1. 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.
------
# Bagaimana Pengembang Amazon Q mengubah kode untuk peningkatan bahasa Java
Untuk mengubah kode Anda, Amazon Q Developer membuat rencana transformasi yang digunakan untuk meningkatkan versi bahasa kode proyek Anda. Setelah mengubah kode Anda, ini memberikan ringkasan transformasi dan perbedaan file bagi Anda untuk meninjau perubahan sebelum menerimanya. 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. Bagian berikut memberikan rincian lebih lanjut tentang bagaimana Amazon Q melakukan transformasi.
## Membangun kode Anda dan membuat rencana transformasi
Untuk mulai mengubah kode Anda, Amazon Q membangun proyek Anda secara lokal dan menghasilkan artefak build yang berisi kode sumber, dependensi proyek, dan log build.
Setelah membuat artefak build, Amazon Q membuat kode Anda di lingkungan build yang aman dan membuat rencana transformasi, yang disesuaikan dengan proyek atau modul yang Anda upgrade. Rencana transformasi menguraikan perubahan spesifik yang akan dilakukan Amazon Q, termasuk versi dependensi baru, perubahan kode utama, dan penggantian yang disarankan untuk kode yang tidak digunakan lagi. Perubahan ini didasarkan pada pembuatan awal kode Anda, dan mungkin berubah selama transformasi.
## Mengubah kode Anda
Untuk mengubah kode Anda, Amazon Q mencoba memutakhirkan kode Anda ke versi Java target berdasarkan perubahan yang diusulkan dalam rencana transformasi. Saat membuat perubahan, ia membangun kembali dan menjalankan pengujian unit yang ada di kode sumber Anda untuk memperbaiki kesalahan yang ditemui secara berulang. Upgrade JDK dapat dilakukan dari versi kode sumber berikut ke versi target:
+ Java 8 hingga 17
+ Java 8 hingga 21
+ Jawa 11 hingga 17
+ Java 11 hingga 21
+ Java 17 hingga 21
Amazon Q membuat perubahan minimal yang diperlukan untuk membuat kode Anda kompatibel dengan versi Java target. 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 mencoba membuat perubahan berikut saat memutakhirkan kode Anda:
+ Perbarui komponen kode usang sesuai dengan rekomendasi versi Java target
+ Tingkatkan pustaka dan kerangka kerja populer ke versi yang kompatibel dengan versi Java target. Ini termasuk memperbarui pustaka dan kerangka kerja berikut ke versi utama terbaru yang tersedia:
+ Apache Commons IO
+ Apache HttpClient
+ bc-fips
+ Mentimun-JVM
+ Hibernasi
+ jackson-annotations
+ JakartaEE
+ Javax
+ javax.servlet
+ jaxb-api
+ jaxb-impl
+ jaxen
+ jcl-over-slf4j
+ json sederhana
+ jsr305
+ junit
+ junit-jupiter-api
+ Log4j
+ Mikronaut
+ Mockito
+ mockito-inti
+ Okio
+ PowerMockito
+ Quarkus
+ slf4j
+ slf4j-api
+ Sepatu Bot Musim Semi
+ Kerangka Musim Semi
+ Keamanan Musim Semi
+ Kesombongan
+ testng
**catatan**
Jangan mematikan atau menutup mesin lokal Anda selama transformasi kode karena build sisi klien memerlukan koneksi jaringan yang stabil.
## Membangun kode di lingkungan lokal Anda
Selama transformasi, Amazon Q melakukan build verifikasi di lingkungan lokal Anda. Amazon Q mengubah kode Anda di sisi server dalam beberapa langkah. Setelah setiap langkah, Amazon Q mengirimkan kode ke lingkungan lokal Anda untuk membangun dan menguji perubahan yang dibuatnya. Kode kemudian dikirim kembali ke sisi server untuk melanjutkan transformasi.
Build di lingkungan lokal Anda membantu memverifikasi kode yang diubah dengan mengizinkan Amazon Q menjalankan pengujian yang memerlukan akses ke sumber daya pribadi. Untuk meminimalkan risiko keamanan yang terkait dengan pembuatan kode yang dihasilkan AI di lingkungan lokal Anda, Amazon Q meninjau dan memperbarui kode yang dihasilkannya untuk mengatasi masalah keamanan.
## Meninjau ringkasan transformasi dan menerima perubahan
Setelah transformasi selesai, Amazon Q memberikan ringkasan transformasi dengan detail tentang perubahan yang dibuat, termasuk status build akhir yang menunjukkan apakah seluruh proyek Anda ditingkatkan. Anda juga dapat melihat ringkasan log build untuk memahami masalah apa pun yang mencegah Amazon Q membuat kode Anda dalam versi yang ditingkatkan.
Ringkasan transformasi juga mencakup perbedaan antara perubahan yang diusulkan dalam rencana transformasi dan perubahan yang akhirnya dibuat Amazon Q untuk meningkatkan kode Anda, dan perubahan tambahan apa pun yang tidak ada dalam paket awal.
Setelah meninjau ringkasan transformasi, Anda dapat melihat perubahan yang diusulkan Amazon Q dalam tampilan diff file. Perubahan kode apa pun yang disarankan Amazon Q tidak akan memengaruhi file proyek Anda saat ini hingga Anda menerima perubahan tersebut. Kode yang diubah tersedia hingga 30 hari setelah transformasi selesai.
## Menyelesaikan transformasi yang berhasil sebagian
Bergantung pada kompleksitas dan spesifikasi basis kode Anda, mungkin ada contoh di mana transformasi sebagian berhasil. Ini berarti Amazon Q hanya dapat mengubah file atau area kode tertentu dalam proyek Anda. Dalam hal ini, Anda harus memperbarui kode yang tersisa secara manual agar proyek Anda dapat dibangun dalam versi bahasa yang diperbarui.
Untuk membantu mengubah sisa kode Anda, Anda dapat menggunakan obrolan Amazon Q di IDE. Anda dapat meminta Amazon Q untuk meninjau file yang diperbarui sebagian dan memberikan kode baru untuk mengatasi masalah, seperti kesalahan kompilasi. Anda juga dapat menggunakan fitur seperti [Pengembangan fitur](q-in-IDE-chat.md#develop-code) dan [konteks Workspace](workspace-context.md) untuk menyertakan lebih banyak proyek Anda sebagai konteks dan mendapatkan saran untuk beberapa file sekaligus.