Eclipse 插件指南

流程

1. 启动 Eclipse。
2. 从菜单栏中，选择 Help → Install New Software。
3. 在 Work with 字段旁边，点 Add。
4. 在 Name 字段中输入 MTR。
5. 在 Location 字段中，输入 https://marketplace.eclipse.org/content/migration-toolkit-runtimes-mtr 并点 OK。

6. 选择要使用的 Java 版本。

   • 如果使用 Java 11，请在 JRE 列表中选择 JavaSE 11。
   • 如果使用 Java 17，请保留 JRE 选择不变。

7. 选择所有 JBoss Tools - MTR 复选框，点 Next。
8. 检查安装详情并点 Next。
9. 接受许可协议条款并点 完成。
10. 重新启动 Eclipse。

流程

1. 点 Configure MTR 图标打开配置设置。
2. 使用 CLI 的父目录的路径填充 CLI 字段。
3. 点应用。

流程

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

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

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

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

      注意

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

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

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

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

流程

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

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

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

流程

1. 点 Window → Show View → Issue Explorer。

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

   

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

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

   表 4.1. 问题图标

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

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。