を使用した言語バージョンのアップグレード 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 および Java への 11 コード Java 17 コード。

ステップ 1: 前提条件

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

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

  • プロジェクトが Java 8 または Java 上に構築された 11 のプロジェクト Maven.

  • プロジェクトは で正常に構築されます Maven の IDE。Amazon Q Developer Agent for code transformation が をサポート Maven 2.8 ですが、Maven 3.9.5 以降。

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

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

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

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

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

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

  • のコンパイラの最小バージョンmaven-compiler-pluginは v13.13.0 です。

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

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

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

でプロジェクトを設定するには JetBrainsでは、次のプロジェクト構造設定を指定する必要がある場合があります。

  • プロジェクト SDK – プロジェクトのコンパイルJDKに使用される 。プロジェクトを構築するには、これを指定する必要があります。

  • プロジェクト言語レベル – 。Java プロジェクトで使用される言語。これは、Java プロジェクトで使用される のバージョンは、 JDKのバージョンとは異なります。

  • モジュール言語レベル – 。Java モジュールで使用される言語。これは、Java モジュールで使用される バージョンは、プロジェクトまたは JDKバージョンとは異なります。

サポートされていない を使用しているが、プロジェクトまたはモジュールでサポートされている言語バージョンを使用している場合はJDK、これらの設定を調整する必要がある場合があります。例えば、Java 8 プロジェクトですが、18 JDK を使用しています。プロジェクト言語レベルを に設定する必要があります Java 8.

さらに、プロジェクトに異なる言語バージョンを使用する複数のモジュールが含まれている場合は、変換するモジュールの言語レベルを設定する必要があります。

プロジェクト設定の更新

プロジェクト SDK、プロジェクト言語、またはモジュール言語設定を更新するには、次のステップを実行します。

  1. から JetBrains IDEで、ファイル を選択し、次にプロジェクト構造 を選択します。

  2. プロジェクト構造ウィンドウが開きます。プロジェクト設定 で、プロジェクト を選択します。

    1. を更新するにはJDK、 の横にあるドロップダウンリストから を選択しますSDK

    2. プロジェクト言語を更新するには、言語レベル の横にあるドロップダウンから を選択します。

  3. [Project Settings] で [Modules] を選択します。

    1. モジュール言語を更新するには、言語レベル の横にあるドロップダウンから を選択します。

詳細については、「」の「プロジェクト構造設定」と「モジュール構造設定」を参照してください。JetBrains ドキュメント内) を参照してください。

でプロジェクトを設定する 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変数は ではなく JDK を指す必要があります」を参照してくださいJRE。設定が正しいことを確認するには、 を実行しますmvn -v。出力には、Maven バージョンと、 へのパスを指すruntime変数JDK。

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

独自のコードを変換する前に、サンプルプロジェクトを変換してIDE、 が正しくセットアップされていることをテストできます。コード変換の対象となるサンプル GitHub プロジェクトは次のとおりです。 https://github.com/aws-samples/aws-appconfig-java-sample

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

注記

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

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

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

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

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