Eclipse プラグインガイド

手順

1. Oracle JDK ダウンロードページ から、システムに適した JDK tar.gz ファイルをダウンロードします。

   注記

   続行するには、Oracle ライセンス契約に同意する必要があります。

   または、コマンドラインインターフェイスを使用して JDK をダウンロードすることもできます。

   $ wget https://download.oracle.com/java/11/latest/<jdk-file>

2. tar.gz ファイルを展開します。

   $ tar -xzf <jdk-file>

3. オプション: JDK をシステム全体で使用できるようにするには、展開したフォルダーを /opt ディレクトリーに移動します。

   $ sudo mv <jdk-extracted-folder> /opt/<jdk-file>

4. JAVA_HOME 環境変数を設定し、JDK bin ディレクトリーを PATH 変数に追加します。

   1. .bashrc ファイルを開きます。

      $ nano ~/.bashrc

   2. ファイルに以下の行を追加します。

      export JAVA_HOME=/opt/<jdk-file>
      export PATH=$PATH:$JAVA_HOME/bin

   3. ファイルを保存して閉じます。

   4. 新しい変更を適用するには、ファイルを再読み込みします。

      $ source ~/.bashrc

手順

1. Eclipse ダウンロードページ から、必要な Eclipse IDE tar.gz ファイル (Eclipse IDE for Java Developers など) をダウンロードします。

2. tar.gz ファイルを展開します。

   $ tar -xzf <file_name>.tar.gz

3. オプション: Eclipse をシステム全体で使用できるようにするには、展開したフォルダーを /opt ディレクトリーに移動します。

   $ sudo mv eclipse /opt/eclipse

4. オプション: Eclipse をコマンドラインから起動するには、実行可能ファイルへのシンボリックリンクを作成します。

   $ sudo ln -s /opt/eclipse/eclipse /usr/bin/eclipse

5. オプション: アプリケーションメニューから Eclipse を起動するには、デスクトップエントリーを作成します。

   1. 新しい eclipse.desktop ファイルを作成します。

      sudo nano /usr/share/applications/eclipse.desktop

   2. eclipse.desktop ファイルに次の内容を追加します。

      [Desktop Entry]
      Name=Eclipse IDE 2024-03
      Type=Application
      Exec=/opt/eclipse/eclipse
      Terminal=false
      Icon=/opt/eclipse/icon.xpm
      Comment=Intergrated DEvelopment Environment
      NoDisplay=false
      Categories=Development;IDE;
      Name[en]=Eclipse IDE 2024-03

手順

1. Eclipse を起動します。
2. メニューバーから、Help Install New Software を選択します。
3. https://download.jboss.org/jbosstools/photon/development/updates/ の場所を指定して、JBoss Tools 更新 Web サイトを追加します。

手順

1. Eclipse を起動します。
2. メニューバーから Help → Install New Software を選択します。
3. Work with フィールドの横にある Add をクリックします。
4. Name フィールドに MTA を入力します。
5. Location フィールドに https://marketplace.eclipse.org/content/migration-toolkit-applications-mta と入力し、OK をクリックします。

6. 使用する Java バージョンを選択します。

   • Java 11 を使用している場合は、JRE リストで JavaSE 11 を選択します。
   • Java 17 を使用している場合は、JRE の選択を変更しないでください。

7. すべての JBoss Tools - MTA チェックボックスを選択して、Next をクリックします。
8. インストールの詳細を確認し、Next をクリックします。
9. ライセンス契約の条件に同意し、Finish をクリックします。
10. Eclipse を再起動します。

手順

1. Window → Perspective → Open Perspective → Other をクリックします。

2. MTA を選択し、OK をクリックします。

   以下のコンポーネントが表示されます。

   • Issue Explorer は、MTA プラグインで識別される移行の問題を表示します。

   • MTA Server は、プロジェクトを分析し、移行の問題にフラグを立て、レポートを生成する別個のプロセスです。

     Issue Explorer で MTA サーバーの開始、停止、およびステータス表示を行うことができます。

   • Issue Details には、ヒント、重大度、追加のリソースなど、選択した問題に関する詳細情報が表示されます。

   • MTA Report は MTA プラグインによって生成された HTML レポートです。レポートのランディングページから、アプリケーションの詳細、問題、依存関係などの詳細なレポートに移動できます。

     注記

     デフォルトでは、レポートは生成されません。実行設定で Generate Report オプションを選択する必要があります。

手順

1. Issue Explorer で MTA アイコン ( ) をクリックし、実行設定を作成します。

2. 入力 タブで、以下のフィールドを入力します。

   1. 移行パスを選択します。
   2. Projects フィールドの横にある Add をクリックし、1 つ以上のプロジェクトを選択します。

   3. Packages フィールドの横にある Add をクリックし、パッケージを 1 つまたは複数選択します。

      注記

      分析するパッケージを指定すると、ランタイム時間が短縮されます。パッケージを選択しないと、プロジェクト内のすべてのパッケージがスキャンされます。

3. Options タブで Generate Report を選択し、HTML レポートを生成することができます。レポートは Report タブに表示され、ファイルとして保存されます。

   その他のオプションが表示されます。詳細は、CLI ガイド の MTA コマンドライン引数について を参照してください。

4. Rules タブで、MTA プラグインにインポートまたは作成したカスタムルールセットを選択できます。
5. 実行 をクリックして分析を開始します。

手順

1. MTA パースペクティブで、Run ボタン ( ) をクリックし、実行設定を選択します。

   MTA プラグインはプロジェクトを分析します。Issue Explorer は、ルールセットで検出された移行の問題を表示します。

2. プロジェクトの分析が終了したら、Issue Explorer で MTA サーバーを停止して、メモリーを節約します。

手順

1. Window → Show View → Issue Explorer をクリックします。

2. オプション: Options メニュー をクリックし、Group By およびオプションを選択して問題をフィルタリングします。

   

3. 右クリックし、Issue Details を選択して問題に関する情報を表示します。これには、重大度や対処方法が含まれます。

   以下のアイコンは、問題の重大度および状態を示しています。

   Expand

   表3.1 問題アイコン

   アイコン	説明
   	移行を成功させるには、この問題を修正する必要があります。
   	移行については、この問題の修正は任意となります。
   	この問題は、移行時に対処する必要がある場合があります。
   	この問題は解決されています。
   	この問題は古くなっています。問題としてマークされたコードは、MTA が最後に問題として識別したときから変更されています。
   	この問題にはクイック修正を利用できます。正常に移行するには修正は必須となります。
   	この問題にはクイック修正を利用できます。移行については、修正は任意となります。
   	この問題にはクイック修正を利用できます。これは、移行中に問題が発生する可能性があります。

   Show more
4. 問題をダブルクリックして、エディターで関連するコードの行を開きます。

手順

1. Rulesets タブをクリックします。
2. System をデプロイメントして、システムのルールセットまたは Custom を表示してカスタムルールセットを表示します。
3. ルールセットをデプロイメントします。
4. ルールをダブルクリックして、ビューアーで開きます。
5. Source タブをクリックして、ルールの XML ソースを表示します。

手順

1. Rulesets タブをクリックします。
2. ルールセットの作成アイコン ( ) をクリックします。
3. ルールセットのプロジェクトおよびディレクトリーを選択します。

4. ファイル名を入力します。

   注記

   ファイルには拡張子 .windup.xml が必要です。

5. ruleset ID (my-ruleset-id など) を入力します。
6. オプション: Generate quickstart template を選択し、基本的なルールテンプレートをファイルに追加します。
7. Finish をクリックします。
8. エディターでルールセットファイルが開かれ、ルールを追加および編集できます。
9. Source タブをクリックして、ルールセットファイルの XML ソースを編集します。

手順

1. Rulesets タブをクリックします。
2. ルールセットのインポートアイコン ( ) をクリックします。

3. インポートする XML ルールファイルを参照して選択します。

   Rulesets タブで Custom を拡張すると、カスタムルールセットが表示されます。

手順

1. Rulesets タブをクリックします。
2. 矢印アイコン ( ) をクリックし、Submit Ruleset を選択します。

3. 以下のフィールドに入力します。

   • Summary: ルールの目的を説明します。これは送信時のタイトルになります。
   • Code Sample: ルールが実行するソースコードの例を入力します。
   • Description: ルールの簡単な説明を入力します。
4. Choose Files をクリックし、ルールセットファイルを選択します。
5. Submit をクリックします。