翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した言語バージョンのアップグレード 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: 前提条件
続行する前に、 の「Amazon Q のセットアップIDE」の手順が完了していることを確認してください。
コード変換ジョブを開始する前に、次の前提条件を満たしていることを確認してください。
-
プロジェクトはJava、 上に構築された 8 または Java 11 のプロジェクトですMaven。
-
プロジェクトは Mavenで を使用して正常に構築されますIDE。 は 2.8 Maven Amazon Q Developer Agent for code transformationをサポートしていますが、3.9.5 Maven 以降をお勧めします。
-
プロジェクトソースJDKはローカルで使用でき、ソースコードのバージョンです。例えば、Java 8 コードを変換する場合、ローカルJDKインストールは 8 JDK である必要があります。
-
プロジェクトは 55 分以内に構築されます。
-
プロジェクトが正しく設定され、正しいJDKバージョンが指定されています。詳細については、「ステップ 2: プロジェクトを設定する」を参照してください。
-
プロジェクトでは、仮想プライベートクラウド (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 バケットへのアクセスを許可する」を参照してください。
-
のコンパイラの最小バージョン
maven-compiler-plugin
は v13.13.0 です。
ステップ 2: プロジェクトを設定する
プロジェクトを設定するには、使用している IDE に次の情報を使用します。
でプロジェクトを設定する JetBrains
でプロジェクトを設定するにはJetBrains、次のプロジェクト構造設定を指定する必要があります。
-
プロジェクト SDK – プロジェクトのコンパイルJDKに使用される 。プロジェクトを構築するには、これを指定する必要があります。
-
プロジェクト言語レベル – プロジェクトで使用されるJava言語。これは、プロジェクトで使用されるJavaバージョンがJDKバージョンと異なる場合に指定する必要があります。
-
モジュール言語レベル – モジュールで使用されるJava言語。これは、モジュールで使用されるJavaバージョンがプロジェクトまたはJDKバージョンと異なる場合に指定する必要があります。
サポートされていない を使用しているが、プロジェクトまたはモジュールでサポートされている言語バージョンを使用している場合はJDK、これらの設定を調整する必要がある場合があります。例えば、Java8 つのプロジェクトを変換しているが、18 JDK を使用している場合は、プロジェクトの言語レベルを 8 Java に設定する必要があります。
さらに、プロジェクトに異なる言語バージョンを使用する複数のモジュールが含まれている場合は、変換するモジュールの言語レベルを設定する必要があります。
プロジェクト設定の更新
プロジェクト SDK、プロジェクト言語、またはモジュール言語設定を更新するには、次のステップを実行します。
-
からJetBrainsIDE、ファイル を選択し、次にプロジェクト構造 を選択します。
-
プロジェクト構造ウィンドウが開きます。プロジェクト設定 で、プロジェクト を選択します。
-
を更新するにはJDK、 の横にあるドロップダウンメニューから を選択しますSDK。
-
プロジェクト言語を更新するには、言語レベル の横にあるドロップダウンから を選択します。
-
-
[Project Settings] で [Modules] を選択します。
-
モジュール言語を更新するには、言語レベル の横にあるドロップダウンから を選択します。
-
詳細については、 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。