Memutakhirkan versi bahasa dengan Amazon Q Developer Agent for code transformation - Pengembang Amazon Q
Langkah 1: PrasyaratLangkah 2: Konfigurasikan proyek AndaLangkah 3: Ubah kode Anda

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

Memutakhirkan versi bahasa dengan Amazon Q Developer Agent for code transformation

Amazon Q Developer Agent for code transformationDapat meng-upgrade versi bahasa kode file Anda di tempat. Anda dapat mengubah modul dalam JetBrains dan proyek atau seluruh ruang kerja diVisual Studio Code.

Amazon Q pertama kali membangun kode Anda dalam versi bahasa sumber dan memverifikasi bahwa ia memiliki informasi yang diperlukan untuk mengubah kode Anda. Setelah Amazon Q berhasil mengubah kode Anda, Anda memverifikasi dan menerima perubahan di lingkungan pengembangan terintegrasi (IDE). Untuk informasi selengkapnya, lihat Bagaimana cara Amazon Q Developer Agent for code transformation kerjanya.

Saat ini, Amazon Q dapat meningkatkan kode Java 8 dan Java 11 menjadi Java 17 kode.

Topik

Langkah 1: Prasyarat

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

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

  • Proyek Anda adalah proyek Java 8 atau Java 11 yang dibangun di atasMaven.

  • Proyek Anda berhasil dibangun dengan Maven di dalam proyek AndaIDE. Amazon Q Developer Agent for code transformationmendukung Maven 2.8, tetapi kami merekomendasikan Maven 3.9.5 atau yang lebih baru.

  • Sumber proyek Anda JDK tersedia secara lokal dan merupakan versi kode sumber Anda. Misalnya, jika Anda mengubah kode Java 8, JDK instalasi lokal Anda harus JDK 8.

  • Proyek Anda dibangun dalam 55 menit atau kurang.

  • Proyek Anda dikonfigurasi dengan benar, dan JDK versi yang benar ditentukan. Untuk informasi selengkapnya, lihat Langkah 2: Konfigurasikan proyek Anda.

  • 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-pluginuntuk mengeksekusi front-end selain JavaScript kode sumber Java Anda, transformasi akan gagal.

  • Proyek Anda tidak menggunakan rentang versi ketergantungan pom.xml file. Misalnya, jika pom.xml file Anda termasuk<version>[1.0.0,)</version>, transformasi akan gagal. Untuk informasi selengkapnya, lihat Spesifikasi Rentang Versi dalam dokumentasi Proyek Apache Maven.

  • 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 perimeter data.

  • Versi kompiler minimum Anda untuk maven-compiler-plugin adalah v13.13.0.

Langkah 2: Konfigurasikan proyek Anda

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

Konfigurasikan proyek di JetBrains

Untuk mengonfigurasi proyek AndaJetBrains, Anda mungkin perlu menentukan pengaturan Struktur Proyek berikut:

  • Proyek SDK — Yang JDK digunakan untuk mengkompilasi proyek Anda. Ini harus ditentukan untuk membangun proyek Anda.

  • Tingkat bahasa proyek - Java Bahasa yang digunakan dalam proyek Anda. Ini harus ditentukan jika Java versi yang digunakan dalam proyek Anda berbeda dari JDK versi Anda.

  • Tingkat bahasa modul - Java Bahasa yang digunakan dalam modul Anda. Ini harus ditentukan jika Java versi yang digunakan dalam modul Anda berbeda dari proyek atau JDK versi Anda.

Anda mungkin perlu menyesuaikan pengaturan ini jika Anda menggunakan yang tidak didukungJDK, tetapi proyek atau modul Anda menggunakan versi bahasa yang didukung. Misalnya, jika Anda mengubah proyek Java 8, tetapi Anda menggunakan JDK 18, Anda harus menetapkan tingkat bahasa proyek Anda ke Java 8.

Selain itu, jika proyek Anda berisi beberapa modul yang menggunakan versi bahasa yang berbeda, Anda harus mengatur tingkat bahasa untuk modul yang Anda ubah.

Perbarui pengaturan proyek

Untuk memperbarui pengaturan proyekSDK, bahasa proyek, atau bahasa modul Anda, selesaikan langkah-langkah berikut:

  1. Dari Anda JetBrainsIDE, pilih File dan kemudian Struktur Proyek.

  2. Jendela Project Structure terbuka. Di bawah Pengaturan Proyek, pilih Proyek.

    1. Untuk memperbaruiJDK, pilih dari menu tarik-turun di sebelah. SDK

    2. Untuk memperbarui bahasa proyek Anda, pilih dari dropdown di sebelah tingkat Bahasa.

  3. Di bawah Pengaturan Proyek, pilih Modul.

    1. Untuk memperbarui bahasa modul Anda, pilih dari dropdown di sebelah tingkat Bahasa.

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:

  • pom.xmlFile di folder root proyek

  • Sebuah .java file dalam direktori proyek

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 selengkapnya, lihat runtime Variabel Java Bagaimana cara menambahkan Maven ke saya? PATH Anda juga harus menunjuk ke a JDK dan bukan ke aJRE. Untuk mengonfirmasi konfigurasi Anda benar, jalankanmvn -v. Output harus menunjukkan Maven versi Anda dan runtime variabel yang menunjuk ke jalur ke AndaJDK.

Langkah 3: Ubah kode Anda

Sebelum Anda mengubah kode Anda sendiri, Anda mungkin ingin menguji IDE apakah Anda sudah 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 IDE penyiapan Anda, unduh dan unzip proyek sampel, dan selesaikan langkah-langkah berikut untuk AndaIDE. Jika Anda dapat melihat perubahan yang diusulkan dan ringkasan transformasi, Anda siap untuk mengubah proyek kode Anda sendiri. Jika transformasi gagal, Anda tidak IDE dikonfigurasi dengan benar. Untuk mengatasi masalah konfigurasi, tinjau Langkah 2: Konfigurasikan proyek Anda danPemecahan Masalah.

catatan

Jika Anda menjauh dari Anda IDE sebelum transformasi dimulai, transformasi akan gagal dan Anda harus memulai kembali.

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

JetBrains

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

  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 menu tarik-turun, lalu pilih Transform.

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

  5. 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.

  6. 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.

  7. 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 diIDE.

  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 atasIDE.

  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 AndaJDK. Untuk informasi selengkapnya, lihat Mengonfigurasi VS Code proyek Anda.

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

  7. 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.

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

  9. 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.