Memutakhirkan versi bahasa dengan Amazon Q Developer Agent for code transformation - Pengembang Amazon Q

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

Bagian Amazon Q Developer Agent for code transformation dapat meningkatkan versi bahasa kode file Anda di tempat. Anda dapat mengubah modul di JetBrains dan proyek atau seluruh ruang kerja di Visual 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 Amazon Q Developer Agent for code transformation cara kerja.

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

Langkah 1: Prasyarat

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

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

  • Proyek Anda adalah Java 8 atau Java 11 proyek dibangun di atas Maven.

  • Proyek Anda berhasil dibangun dengan Maven di dalam AndaIDE. Amazon Q Developer Agent for code transformation mendukung Maven 3.8 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.

  • 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 Anda di JetBrains, Anda mungkin perlu menentukan pengaturan proyek dan modul berikut.

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

  • Proyek SDK — Yang JDK digunakan untuk mengkompilasi proyek Anda.

  • Tingkat bahasa proyek - The Java versi yang digunakan dalam proyek Anda.

  • Modul SDK - Yang JDK digunakan untuk mengkompilasi modul Anda.

  • Tingkat bahasa modul - The Java versi yang digunakan dalam modul Anda.

  • Maven Runner JRE — JDK Anda membangun modul Anda dengan.

Perbarui pengaturan proyek dan modul

Untuk memperbarui pengaturan tingkat bahasa SDK dan proyek Anda, selesaikan langkah-langkah berikut:

  1. Dari Anda JetBrains IDE, pilih File dan kemudian Project Structure.

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

    1. Untuk memperbarui proyek AndaJDK, pilih dari daftar dropdown 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 modul AndaJDK, pilih dari daftar dropdown di sebelah. SDK

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

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

Perbarui pengaturan Maven

Untuk memperbarui Maven Runner AndaJRE, selesaikan langkah-langkah berikut:

  1. Dari Anda JetBrains IDE, pilih ikon roda gigi, lalu pilih Pengaturan di menu yang muncul.

  2. Di jendela Pengaturan, pilih Build, Execution, Deployment, lalu Build Tools, lalu Maven, dan kemudian Runner.

  3. Di JRE bidang, pilih yang JDK digunakan untuk membangun modul yang Anda ubah.

Konfigurasikan proyek di VS Code

Untuk mengonfigurasi proyek Anda di VS 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 (untuk mvnw macOS atau mvnw.cmd untuk Windows), pastikan itu di akar proyek Anda. Amazon Q akan menggunakan pembungkusnya, dan tidak ada yang lain Maven konfigurasi diperlukan.

Jika Anda tidak menggunakan Maven pembungkus, pasang Maven. Untuk informasi selengkapnya, lihat Menginstal Apache Mavendi Apache Maven dokumentasi.

Setelah menginstal Maven, 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 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 tingkatkan JetBrains. 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 daftar dropdown, 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.

Visual Studio Code
  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.

  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 Tampilkan Ringkasan Transformasi.