Eclipse 插件指南

流程

1. 在 Oracle JDK 下载页面中，下载适用于您系统的 JDK tar.gz 文件。

   注意

   您需要接受 Oracle 许可证协议才能继续。

   另外，您可以使用命令行界面下载 JDK：

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

   Copy to Clipboard Toggle word wrap

2. 提取 tar.gz 文件：

   $ tar -xzf <jdk-file>

   Copy to Clipboard Toggle word wrap

3. 可选： 要使 JDK 在系统范围内可用，将提取的文件夹移到 /opt 目录中：

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

   Copy to Clipboard Toggle word wrap

4. 设置 JAVA_HOME 环境变量，并将 JDK bin 目录添加到 PATH 变量中：

   1. 打开 .bashrc 文件：

      $ nano ~/.bashrc

      Copy to Clipboard Toggle word wrap

   2. 在文件中添加以下行：

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

      Copy to Clipboard Toggle word wrap
   3. 保存文件并关闭该文件。

   4. 要应用新更改，请重新载入该文件：

      $ source ~/.bashrc

      Copy to Clipboard Toggle word wrap

流程

1. 在 Eclipse 下载页面 中，下载所需的 Eclipse IDE tar.gz 文件，例如，用于 Java Developers 的 Eclipse IDE。

2. 提取 tar.gz 文件：

   $ tar -xzf <file_name>.tar.gz

   Copy to Clipboard Toggle word wrap

3. 可选： 要使 Eclipse 在系统范围内可用，请将提取的文件夹移到 /opt 目录中：

   $ sudo mv eclipse /opt/eclipse

   Copy to Clipboard Toggle word wrap

4. 可选： 要从命令行启动 Eclipse，请创建一个到可执行文件的符号链接：

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

   Copy to Clipboard Toggle word wrap

5. 可选： 要从应用程序菜单中启动 Eclipse，请创建一个桌面条目：

   1. 创建新的 eclipse.desktop 文件：

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

      Copy to Clipboard Toggle word wrap

   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

      Copy to Clipboard Toggle word wrap

流程

1. 启动 Eclipse。
2. 从菜单栏中，选择 Help Install New Software。
3. 通过指定 https://download.jboss.org/jbosstools/photon/development/updates/ 位置来添加 JBoss 工具更新网站。

流程

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. 接受许可协议条款并点 完成。
10. 重新启动 Eclipse。

流程

1. 点 Window → Perspective → Open Perspective → Other。

2. 选择 MTA 并点 OK。

   此时会显示以下组件：

   • 问题 管理器显示 MTA 插件确定的迁移问题。

   • MTA 服务器 是一个单独的进程，用于分析项目、标记迁移问题并生成报告。

     您可以在 Issue Explorer 中启动、停止和查看 MTA 服务器的状态。

   • 问题详情显示有关所选问题的详细信息，包括提示、严重性和任何其他资源。

   • MTA 报告是由 MTA 插件生成的 HTML 报告。在报告登录页面中，您可以导航到详细的报告，如应用程序详情、问题和依赖项。

     注意

     默认情况下不生成报告。您必须在运行配置中选择 Generate Report 选项。

流程

1. 在 Issue Explorer 中，点 MTA 图标( )创建运行配置。

2. 在 Input 选项卡中，完成以下字段：

   1. 选择迁移路径。
   2. 在 Projects 字段中，点 Add，然后选择一个或多个项目。

   3. 在 Packages 字段中点 Add，然后选择一个或多个软件包。

      注意

      指定用于分析的软件包可减少运行时。如果您没有选择任何软件包，则项目中的所有软件包都会被扫描。

3. 在 Options 选项卡中，您可以选择 Generate Report 来生成 HTML 报告。该报告显示在 Report 选项卡中，并作为文件保存。

   此时会显示其他选项。详情请参阅 CLI 指南中的 关于 MTA 命令行参数。

4. 在 Rules 选项卡中，您可以选择您为 MTA 插件导入或创建的自定义规则集。
5. 点 Run 以开始分析。

流程

1. 在 MTA 透视图中，点 Run 按钮( )并选择运行配置。

   MTA 插件可以分析您的项目。Issue Explorer 显示使用 ruleset 检测到的迁移问题。

2. 分析完项目后，在 Issue Explorer 中停止 MTA 服务器以节省内存。

流程

1. 点 Window → Show View → Issue Explorer。

2. 可选：点 Options 菜单 来过滤问题，选择 Group By 和 a 选项。

   

3. 在右键并选择 Issue Details 来查看问题的信息，包括其严重性以及如何解决它。

   以下图标表示问题的严重性和状态：

   Expand

   表 3.1. 问题图标

   图标	描述
   	必须解决这个问题才能成功进行迁移。
   	这个问题是修复迁移的可选功能。
   	此问题可能需要在迁移过程中解决。
   	这个问题已解决。
   	这个问题已过时。自该 MTA 第一次将其识别为问题后，被修改标记为问题的代码。
   	这个问题提供了一个快速修复，这是成功进行迁移所必需的。
   	这个问题提供了一个快速修复，对于迁移来说是可选的。
   	这个问题提供了一个快速修复，在迁移过程中可能会有问题。

   Show more
4. 双击一个问题，在编辑器中打开相关的代码行。

流程

1. 点 Rulesets 选项卡。
2. 展开 System 以查看系统规则集或 Custom 来查看自定义规则集。
3. 展开规则集。
4. 双击一条规则，在查看器中打开它。
5. 点 Source 选项卡查看规则的 XML 源。

流程

1. 点 Rulesets 选项卡。
2. 点 Create Ruleset 图标( )。
3. 为规则集选择一个项目和目录。

4. 输入文件名。

   注意

   该文件必须具有 .windup.xml 扩展。

5. 输入 ruleset ID，例如 my-ruleset-id。
6. 可选： 选择 Generate quickstart 模板向文件添加基本规则模板。
7. 点 Finish。
8. ruleset 文件会在编辑器中打开，您可以在文件中添加并编辑规则。
9. 点 Source 选项卡编辑 ruleset 文件的 XML 源。

流程

1. 点 Rulesets 选项卡。
2. 点 Import Ruleset 图标( )。

3. 浏览并选择要导入的 XML 规则文件。

   当您在 Rulesets 选项卡上展开 Custom 时，会显示自定义规则集。

流程

1. 点 Rulesets 选项卡。
2. 点箭头图标( )并选择 Submit Ruleset。

3. 完成以下字段：

   • Summary ：描述规则的目的。这是提交的标题。
   • code Sample ：输入规则应针对的源代码示例。
   • 描述 ：输入规则的简短描述。
4. 点 Choose Files 并选择 ruleset 文件。
5. 点 Submit。