附录 A. 参考材料

--additionalClassPath

要添加到类路径的额外 JAR 文件或目录列表（以空格分隔），以便它们可用于处理或进行其他分析。

--addonDir

将指定的目录添加为自定义附加组件存储库。

--analyzeKnownLibraries

用于分析应用程序中嵌入的已知软件工件的标志。默认情况下，MTR 仅分析应用程序代码。

--batchMode

指定 MTR 应该在不提示确认的情况下以非互动模式运行的标志。这个模式采用未传递给命令行的任何参数的默认值。

--debug

在调试模式下运行 MTR 的标志。

--disableTattletale

可禁用 Tattletale 报告的生成标志。如果同时将 enableTattletale 和 disableTattletale 设定为 true，则 disableTattletale 会被忽略，但仍会生成 Tattletale 报告。

--discoverPackages

用于列出输入二进制应用程序中的所有可用软件包的标志。

--enableClassNotFoundAnalysis

标志，以启用对类路径上不可用的 Java 文件进行分析。如果一些类在分析时不可用，则不应使用。

--enableCompatibleFilesReport

启用生成可组合文件报告的标志。由于处理的所有文件都未发现问题，对于大型应用程序，此报告可能需要很长时间才能完成。

--enableTattletale

用于为每个应用程序生成 Tattletale 报告的标志。当 eap 位于包含的目标中时，默认启用这个选项。如果同时将 enableTattletale 和 disableTattletale 设定为 true，则 disableTattletale 会被忽略，但仍会生成 Tattletale 报告。

--enableTransactionAnalysis

[技术预览] 标记来启用生成交易报告，该报告显示调用堆栈，该堆栈对关系数据库表执行操作。Enable Transaction Analysis 功能支持 Spring Data JPA，以及用于 SQL 语句执行的传统的 preparedStatement() 方法。它不支持 ORM 框架，如 Hibernate。

--excludePackages

要排除在评估中排除的软件包列表。例如，输入 com.mycompany.commonutilities 排除所有软件包名称以 com.mycompany.commonutilities 开头的类。

--excludeTags

要排除的以逗号分隔的标签列表。指定后，不会处理具有这些标签的规则。要查看完整的标记列表，请使用 --listTags 参数。

--explodedApp

指定提供的输入目录包含单个应用程序的源文件的标志。

--exportCSV

标志，将报告数据导出到本地文件系统中的 CSV 文件。MTR 在由 --output 参数指定的目录中创建文件。CSV 文件可导入到电子表格程序，以便进行数据操作和分析。

--exportSummary

指示 MTR 在输出目录中生成 analysisSummary.json 导出文件的标记。文件包含了对每个被分析的应用程序的分析摘要信息，包括按类别划分的事件和故事点数，以及与分析的应用程序关联的所有技术标签。

--exportZipReport

此参数在输出文件夹中创建一个 report.zip 文件。该文件包含分析输出，通常是报告。如果请求，它也可以包含 CSV 导出文件。

--help

显示 MTR 帮助信息。

--immutableAddonDir

将指定目录添加为自定义只读附加组件存储库。

--includeTags

要使用的空格分隔的标记列表。指定后，仅处理具有这些标签的规则。要查看完整的标记列表，请使用 --listTags 参数。

--input

到要分析的一个或多个应用程序的文件或目录的路径列表。此参数是必需的。

--install

指定要安装的附加组件。语法为 <GROUP_ID>:<ARTIFACT_ID>[:<VERSION>]。例如：--install core-addon-x 或 --install org.example.addon:example:1.0.0。

--keepWorkDirs

标志指示 MTR 不会删除临时文件，如图形数据库和提取的存档文件。这对于调试非常有用。

--legacyReports

指示 MTR 生成旧格式报告而不是新的格式报告的标记。

--list

列出已安装的附加组件的标志。

--listSourceTechnologies

用于列出所有可用的源技术的标志。

--listTags

用于列出所有可用的标签的标志。

--listTargetTechnologies

用于列出所有可用目标技术的标记。

--mavenize

标志，基于应用的结构和内容创建 Maven 项目目录结构。这将使用适当的 Java EE API 和项目模块之间依赖关系创建 pom.xml 文件。另请参阅 --mavenizeGroupId 选项。

--mavenizeGroupId

与 --mavenize 选项一起使用时，所有生成的 pom.xml 文件都使用为它们的 <groupId> 提供的值。如果省略了这个参数，则 MTR 将尝试根据应用程序确定适当的 <groupId> 参数，或者将默认为 com.mycompany.mavenized。

--online

标志，允许对需要的功能进行网络访问。目前，根据外部资源验证 XML 模式是否依赖于互联网访问。请注意，这附带了一个性能损失。

--output

指定输出 MTR 生成的报告信息的目录路径。

--overwrite

用于强制删除 --output 指定的现有输出目录的标志。如果没有指定此参数，且存在 --output 目录，则会提示您选择是否覆盖内容。

--packages

MTR 要评估的软件包用空格分隔的列表。强烈建议您使用此参数。

--remove

删除指定的附加组件。语法为 <GROUP_ID>:<ARTIFACT_ID>[:<VERSION>]。例如： --remove core-addon-x 或 --remove org.example.addon:example:1.0.0。

--skipReports

表示 HTML 报告不应生成的标志。此参数的常见用途是使用 --exportCSV 将报告数据导出到 CSV 文件时。

--source

要迁移的一个或多个源技术、服务器、平台或框架的空格分隔列表。此参数与 --target 参数结合使用有助于确定使用哪个规则集。使用 --listSourceTechnologies 参数列出所有可用的源。

--sourceMode

用于表示要评估的应用包含源文件而非编译的二进制文件的标志。sourceMode 参数已弃用。现在，不再需要指定它。MTR 可以直观地处理向其呈现的任何输入。另外，可以使用同一分析执行中的二进制输入来分析项目源文件夹。

--target

要迁移到的一个或多个目标技术、服务器、平台或框架的空格分隔列表。此参数与 --source 参数结合使用有助于确定使用哪个规则集。使用 --listTargetTechnologies 参数列出所有可用的目标。

--userIgnorePath

除了 ${user.home}/.mtr/ignore/ 之外，为 MTR 指定位置，以识别应忽略的文件。

--userLabelsDirectory

指定 MTR 来查找自定义 Target Runtime Labels 的位置。该值可以是含有标签文件或单个标签文件的目录。Target Runtime Label 文件必须使用 .windup.label.xml 后缀。提供的 Target Runtime Labels 在 $MTR_HOME/rules/migration-core/core.windup.label.xml 中定义。

--userRulesDirectory

除 <MTR_HOME>/rules/ 和 ${user.home}/.mtr/rules/ 外为 MTR 指定一个位置来查找自定义 MTR 规则。该值可以是包含规则集文件或单个规则集文件的目录。ruleset 文件必须使用 .windup.xml 后缀。

--version

显示 MTR 版本。

--skipSourceCodeReports

此选项会在生成应用程序分析报告时跳过生成源代码报告。当需要关注应用程序分析中的源代码信息时，请使用此高级选项。