で言語バージョンをアップグレードする Amazon Q Developer Agent for Code Transformation - Amazon Q Developer

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

で言語バージョンをアップグレードする Amazon Q Developer Agent for Code Transformation

Amazon Q Developer Agent for Code Transformation は、所定のファイルのコード言語バージョンをアップグレードできます。でモジュールを変換JetBrainsし、 でプロジェクトまたはワークスペース全体を変換できますVisual Studio Code。

Amazon Q はまずソース言語バージョンでコードを構築し、コードの変換に必要な情報があることを確認します。Amazon Q がコードを正常に変換したら、統合開発環境 (IDE) の変更を検証して受け入れます。詳細については、「Amazon Q Developer Agent for Code Transformation のしくみ」を参照してください。

現在、Amazon Q Java は 8 と 11 Java のコードを 17 Java のコードにアップグレードできます。

ステップ 1: 前提条件

続行する前に、IDE の「Amazon Q のセットアップ」の手順が完了していることを確認してください。

コード変換ジョブを開始する前に、次の前提条件を満たしていることを確認してください。

  • プロジェクトはJava、 上に構築された 8 つまたは Java 11 つのプロジェクトですMaven。

  • プロジェクトは IDE Mavenで を使用して正常に構築されます。Amazon Q コード変換は Maven 2.8 をサポートしていますが、3.9.5 Maven 以降をお勧めします。

  • プロジェクトソース JDK はローカルで使用でき、ソースコードのバージョンです。例えば、Java 8 コードを変換する場合、ローカル JDK インストールは JDK 8 である必要があります。

  • プロジェクトは 55 分以内に構築されます。

  • プロジェクトが正しく設定され、正しい JDK バージョンが指定されています。詳細については、「ステップ 2: プロジェクトを設定する」を参照してください。

  • プロジェクトでは、Virtual Private Cloud (VPC) やオンプレミスネットワークなど、プライベートネットワーク上のリソースにアクセスする必要はありません。例えば、プロジェクトにネットワーク内のデータベースに接続するユニットテストが含まれている場合、変換は失敗します。

  • プロジェクトは、Java プロジェクトで Java 以外の言語をパッケージ化するプラグインを使用しません。例えば、プロジェクトが Java ソース JavaScript コードに加えてフロントエンドコードfrontend-maven-pluginを実行するために を使用する場合、変換は失敗します。

  • プロジェクトでは、pom.xmlファイル依存関係のバージョン範囲を使用しません。例えば、pom.xmlファイルに が含まれている場合<version>[1.0.0,)</version>、変換は失敗します。詳細については、Apache Maven プロジェクトのドキュメントの「バージョン範囲の仕様」を参照してください。

  • ローカルネットワークでは、Amazon Q がコードを変換するために使用する Amazon S3 バケットへのアップロードが許可されます。詳細については、「データ境界 で Amazon S3 バケットへのアクセスを許可する」を参照してください。

ステップ 2: プロジェクトを設定する

プロジェクトを設定するには、使用している IDE に次の情報を使用します。

でプロジェクトを設定する JetBrains

でコード変換用にプロジェクトを設定するにはJetBrains、プロジェクト構造設定でプロジェクトの JDK バージョンを指定します。詳細については、 JetBrainsIDEAドキュメントのMaven「プロジェクトで JDK バージョンを変更する」および「プロジェクト構造」の「JDK バージョンを変更する」の手順に従います。

でプロジェクトを設定する VS Code

でコード変換用にプロジェクトを設定するにはVS Code、プロジェクトに以下が含まれている必要があります。

  • プロジェクトルートフォルダ内のpom.xmlファイル

  • プロジェクトディレクトリ内の.javaファイル

プロジェクトにMavenラッパー実行可能ファイル (mvnw の場合は macOS、 mvnw.cmdの場合は Windows) が含まれている場合は、それがプロジェクトのルートにあることを確認してください。Amazon Q はラッパーを使用し、他のMaven設定は必要ありません。

Maven ラッパーを使用していない場合は、 をインストールしますMaven。詳細については、 Apache Mavenドキュメントの「インストールApache Maven」を参照してください。

をインストールしたらMaven、PATH変数に追加します。詳細については、「Java Maven を に追加するにはどうすればよいですかPATH? runtime変数は JRE ではなく JDK も指している必要があります」を参照してください。設定が正しいことを確認するには、 を実行しますmvn -v。出力には、JDK へのパスを指すMavenバージョンとruntime変数が表示されます。

ステップ 3: コードを変換する

独自のコードを変換する前に、サンプルプロジェクトを変換して IDE が正しく設定されていることをテストすることをお勧めします。コード変換の対象となるサンプル GitHub プロジェクトは次のとおりです。https://github.com/dhasani23/QCT-sample-app

IDE のセットアップをテストするには、サンプルプロジェクトをダウンロードして解凍し、IDE の次の手順を実行します。提案された変更と変換の概要を表示できる場合は、独自のコードプロジェクトを変換する準備が整います。変換が失敗した場合、IDE が正しく設定されていません。設定の問題に対処するには、ステップ 2: プロジェクトを設定する「」と「」を確認してくださいトラブルシューティング

注記

プロジェクトのビルド時間が 55 分を超える場合、またはプロジェクトビルドアーティファクトが 1 GB を超える場合、変換は失敗します。ビルド時間とビルドアーティファクトサイズの対処については、「」を参照してくださいトラブルシューティング

変換を開始する前に IDE から移動すると、変換は失敗し、再起動する必要があります。

コードプロジェクトまたはモジュールの言語バージョンをアップグレードするには、IDE の次の手順を実行します。

JetBrains
  1. でアップグレードするモジュールを開きますJetBrains。IDE でプロジェクトが正常に構築されたことを確認します。

  2. Amazon Q ロゴを選択し、開いた Amazon Q チャットパネル/transformに と入力します。

  3. アプリケーションの変換ポップアップが表示されます。ドロップダウンメニューからアップグレードするプロジェクトを選択し、変換 を選択します。

  4. Amazon Q は変換を開始します。「変換の詳細」タブで進捗状況を表示できます。

  5. 変換が完了したら、プロジェクトを更新する前に、アップグレードされたコードを確認できます。新しいコードを表示するには、「変換の詳細」タブに移動し、「差分を表示」を選択します。表示されるパッチの適用ウィンドウでファイルを選択して、ソースコードとアップグレードされたコードを含む差分ビューを開きます。

  6. Amazon Q が行った変更を受け入れるには、差分を表示を選択してパッチ適用ウィンドウを開きます。更新されたファイルをすべて選択し、OK を選択してプロジェクトを更新します。

  7. コードのアップグレード方法の詳細と次のステップの提案を取得するには、「変換の詳細」タブで「変換の概要を表示」を選択します。

Visual Studio Code
  1. でアップグレードするプロジェクトまたはワークスペースを開きますVS Code。IDE でプロジェクトが正常に構築されたことを確認します。

  2. Amazon Q ロゴを選択し、開いた Amazon Q チャットパネル/transformに と入力します。

  3. IDE の上部にある検索バーからアップグレードするプロジェクトを選択します。

  4. Amazon Q がソースコードのバージョンを見つけられない場合は、コードバージョンを選択するように求められます。ソースコードが書き込まれるバージョンを選択し、ポップアップで変換を選択して続行します。

  5. プロンプトが表示されたら、JDK へのJAVA_HOMEパスを入力します。詳細については、VS Code「プロジェクトを設定する」を参照してください。

  6. Amazon Q は変換を開始します。進行状況は、Transformation Hub タブで確認できます。

  7. 変換が完了すると、変更案タブが開きます。プロジェクトを更新する前にアップグレードされたコードを確認するには、提案された変更のダウンロード を選択します。ファイルを選択して、ソースコードとアップグレードされたコードを含む差分ビューを開きます。

  8. Amazon Q が行った変更を受け入れるには、変更案タブに移動し、「受け入れる」を選択します。

  9. コードのアップグレード方法の詳細と次のステップの提案を取得するには、Transformation Hub 「アクションの表示」と「その他のアクション」の省略記号ボタンを選択し、「変換の概要を表示」を選択します。