このクイックスタートでは、GitHub Copilot アプリのモダン化 - Java のアップグレード (プレビュー) を使用して Java プロジェクトをアップグレードする方法について説明します。
[前提条件]
ビジネスプランまたはエンタープライズプランを使用して GitHub Copilot が有効になっている GitHub アカウント。
Visual Studio Code の最新バージョン。
GitHub Copilot アプリモダン化 拡張機能パック。 インストール手順については、次のセクションを参照してください。
この拡張機能パックには、次の 2 つの拡張機能がバンドルされています。
アプリの最新化では、ローカル環境で Java は必要ありません。 ただし、プロジェクトを正常にビルドするには、Java と Maven の正しいバージョンをインストールします。 OpenJDK と Maven の Microsoft ビルドをお勧めします。
ソース JDK とターゲット JDK の両方のインストール済みバージョン。
Maven または Gradle を使用する Git で管理される Java プロジェクト。
Maven ベースのプロジェクトの場合: パブリック Maven Central リポジトリへのアクセス。
Visual Studio Code の設定で "chat.extensionTools.enabled" が true に設定されていることを確認します。 この設定は、組織によって制御される場合があります。
注
Gradle を使用している場合は、Gradle ラッパー バージョン 5 以降のみがサポートされます。 Kotlin DSL はサポートされていません。
Copilot を使用してサインインし、必要な拡張機能をインストールする
GitHub Copilot を使用するには、Visual Studio Code で GitHub アカウントにサインインします。 Visual Studio Code の上部にある Copilot アイコンを選択して、GitHub の [Copilot] ウィンドウにアクセスします。 GitHub Copilot の設定の詳細については、 VS Code での GitHub Copilot の設定を参照してください。
次に、次の手順に従って Visual Studio Code に拡張機能をインストールします。
- Visual Studio Code で、アクティビティ バーから [拡張機能 ] ビューを開きます。
- マーケットプレースで GitHub Copilot アプリのモダン化 を検索します。
- GitHub Copilot アプリモダン化拡張機能パックを選択します。
- 拡張機能ページで、[インストール] を選択 します。
- Visual Studio Code を再起動します。
インストールが完了すると、Visual Studio Code の隅に成功を確認する通知が表示されます。
詳細については、「 VS Code 拡張機能のインストール」を参照してください。
アップグレードする Java プロジェクトを選択する
このチュートリアルでは、次のサンプル リポジトリのいずれかを選択します。
- Maven: uportal-messaging
- Gradle: docraptor-java
GitHub Copilot エージェント モードを起動し、アップグレードを開始する
GitHub Copilot エージェント モードを起動し、アップグレード プロセスを開始するには、次の手順に従います。
- Visual Studio Code で選択した Java プロジェクトを開きます。
- GitHub Copilot チャット パネルを開きます。
- エージェント モードに切り替えます。
- 「 プロジェクトを Java 21 にアップグレードする」や「Spring Boot 3.2」などのプロンプトを入力します。
- メッセージが表示されたら、[ 続行 ] を選択してアップグレード 計画を生成します。
アップグレード 計画を確認して編集する
アプリの最新化 - Java のアップグレード (プレビュー) では、JDK、ビルド ツール、依存関係など、現在のワークスペース内の Java プロジェクトが分析されます。 このツールは、次の計画された変更の概要を示す plan.md ファイルを生成します。
- ソースとターゲットの JDK バージョン。
- フレームワークとライブラリのアップグレード パス。
計画を確認し、必要に応じて変更を加え、[ 続行 ] を選択して続行します。
ヒント
プランが目的のアップグレード ターゲット (Java 8 から Java 21、Spring Boot 2.7 から 3.2 など) と一致していることを確認します。
コードの変更を適用し、ビルドの問題を修正する
GitHub Copilot は、プロジェクトのコード変換フェーズに進みます。 OpenRewrite というオープン ソース ツールを使用して、特定のレシピに基づいていくつかのコード変更を実装します。 次に、AI は動的なビルド/修正ループを通じて残りの問題に対処します。 progress.md マークダウン ファイルをいつでも確認することで、Visual Studio Code のエディター領域で進行状況を監視できます。
プロセスのさまざまな段階で、GitHub Copilot から続行するように求められます。
[ OpenRewrite 変換の確認 ] ステップで、[ 続行 ] を選択し、OpenRewrite を使用して Java コードをアップグレードします。 この手順には数分かかる場合があります。
[ 動的ビルド/修正ループの承認 ] ステップで、[ 続行 ] を選択してプロジェクトをビルドし、エラーを修正します。
Copilot は反復処理を行い、問題がなくなったまでエラーを修正し続けます。 進行状況は 、progress.md ファイルに表示されます。 ループは、プロジェクトが正常にビルドされるまで続行されます。
脆弱性とコード動作の変更を確認する
特定の状況では、アップグレードによってコードの動作が変更されたり、一般的な脆弱性と露出 (CVE) の問題を含むライブラリが導入されたりする可能性があります。 ツールは、これらの問題に対して追加のチェックを実行します。
変更 された依存関係に既知の CVE があるかどうかを確認するプロンプトが GitHub Copilot に表示されたら、[ 続行] を選択します。
CVE が見つかった場合、GitHub Copilot エージェント モードで修正が試みられます。 VS Code の変更を確認し、保持するかどうかを決定します。
CVE チェックの後、 コード動作の整合性の検証の実行を求められたら、[ 続行] を選択します。
問題が見つかった場合、GitHub Copilot エージェント モードは問題の解決を試みます。 変更を保持するか破棄するかを決定します。
チェックが完了すると、GitHub Copilot によってプロジェクトが再構築され、前のチェックが再実行されます。
直ちに修正を必要としない軽微な問題が残っている場合、アップグレードは完了です。 それ以外の場合、GitHub Copilot はそれらに対処するために戻ります。
概要の表示
アップグレード後、ツールによって summary.md ファイルに概要が生成されます。これには、次の情報が含まれます。
- プロジェクト情報。
- コード行が変更されました。
- 更新された依存関係。
- 要約されたコードの変更。
- CVE のセキュリティとコードの不整合の問題 (ある場合) を修正しました。
- 修正されていない軽微な CVE の問題。
次のステップ
クイック スタート: GitHub Copilot アプリのモダン化を使用して単体テストを生成する - Java のアップグレード (プレビュー)