发行说明

本文提供有关 Azure Migrate 应用程序和 Java 代码评估(AppCAT 7)的发行说明。 它包括有关新功能、bug 修复和已知问题的信息。

发行历史

7.7.0.7

此版本包含以下修补程序和增强功能:

  • 修复了 Eclipse Java 开发工具语言服务器(JDTLS)搜索期间的潜在死锁。
  • 添加了对 Jakarta EE 和其他迁移方案的规则支持。
  • 改进了在位置解析失败时的 XML 匹配回退机制。

7.7.0.6

此版本包含以下功能和修补程序:

  • 添加一个新的仅限问题的分析模式,该模式仅检测问题,并且不发现项目使用的技术。
  • 当基础分析服务超时而不是停滞时,快速失败。

7.7.0.4

此版本包含以下新功能和增强功能:

  • 增强的命令参数:向 appcat analyze 命令添加了新参数:
    • --list-capabilities:显示可用的迁移功能。
    • --list-os:显示可用的迁移目标操作系统。
    • --capability:指定用于分析的功能技术。
    • --os: 指定要分析的操作系统。
  • 改进了目标规范:通过删除 OS 和功能值来优化 --targets 参数,这些值现在由专用参数处理。
  • 统一输出格式:引入了新的合并 report.json 输出文件。

7.7.0.3

此版本包含以下修补程序和增强功能:

  • 优化问题域名和类别名称。
  • .appcat-ignore 移动到用户主路径而不是 AppCAT 安装文件夹。
  • 在分析过程中删除不必要的临时文件,例如特定于 Eclipse 的配置。
  • 直接返回非 Java 项目的错误消息。

7.7.0.2

此版本包含以下修补程序和增强功能:

  • 从先决条件中删除了 JDK。
  • 从结果输出中删除 了output.jsonoutput.yaml
  • 修复了规则仅检测一个冲突的问题 azure-password-01000 ,即使同一文件中存在多个冲突也是如此。

7.7.0.1

此版本包含以下修补程序和增强功能:

  • 将默认值 --output-format 更改为 json.

7.7.0.0 (GA)

此版本包含以下修补程序和增强功能:

  • 添加了优雅的错误处理机制,并为不同类型的错误定义了明确的退出代码。
  • 删除了 appcat test 命令。
  • 通过添加应用程序概述部分来增强报表。
  • Bug 修复: mvnw 现在在 Linux 和 macOS 中是可执行的。

7.6.0.7

此版本包含以下修补程序和增强功能:

  • 支持分析基于 Gradle 的 Spring 应用。
  • 支持分析 Open Liberty 项目。
  • 通过显示评估期间处理的规则数来显示评估进度。
  • 已将 Maven 从先决条件中移除。
  • airsonic.war替换为airsonic-advanced,作为已发布构件中的示例应用程序。

7.6.0.6

此版本包含以下修补程序和增强功能:

  • 默认 的 .appcat-ignore 文件现在包含在发布包中。 此文件会导致该工具排除不需要分析的指定文件夹或路径。
  • 修复了使用 full 模式(使用 --mode 指定)时报告中缺少依赖项的问题。
  • 当未指定目标时,将分析范围限定为 AppCAT 支持的特定目标。
  • 在分析中忽略了注释行。
  • 修复了 XML 规则的错误位置。

7.6.0.5

此版本包含以下修补程序和增强功能:

  • 标志 --input 现在接受多个值,使你可以在单个命令执行中分析多个应用程序。
  • 静态报表对其问题列表进行分类,以提高可读性。
  • 用户现在可以在用户主目录以外的目录中安装 AppCAT。
  • 修复了运行analyze--bulk--skip-static-report组合时未能生成多个输出文件的问题。
  • 解决了在没有启动 Java 提供程序时,使用 --bulk--rules 进行分析时出现的故障。
  • 修复了在使用 --packages 标志时找不到指定包时分析失败的问题。
  • 标志 --exclude-paths 已弃用。 若要排除文件或目录,请使用放置在输入目录或安装目录中的 .appcat-ignore 文件(支持 glob 模式)。

7.6.0.4

此版本包含以下修补程序和增强功能:

  • 支持遥测数据的收集。 使用 --disable-telemetry 标志禁用遥测。
  • 重构 CLI 命令格式以提高清晰度。
    • 更新--source标志,将其从--source <source1> --source <source2> ...更改为--source <source1>,<source2>,...
    • 更新--target标志,将其从--target <target1> --target <target2> ...更改为 --target <target1>,<target2>,...
    • 更新--rules标志,将其从--rules <rule1> --rules <rule2> ...更改为--rules <rule1>,<rule2>,...
    • --maven-settings 标志更新为 --custom-maven-settings
    • --limit-code-snips 标志更新为 --code-snips-number
    • 删除--json-output标志。 请改用 --output-format 标志,选择 yamljson。 默认值是 yaml
    • 删除--provider--override-provider-settings--list-providers--dependency-folders标志
  • --exclude-paths 标志:指定应在分析中忽略的路径。 对多个值使用逗号分隔的列表: --exclude-paths <path1>,<path2>,... 默认值是 []
  • --packages 标志:指定要评估的应用程序类包。 对多个值使用逗号分隔的列表: --packages <package1>,<package2>,... 默认值是 []
  • --dry-run 标志:检查标志是否有效,而无需实际运行分析。 默认值是 false
  • 删除azure-spring-apps从 appcat --list-targets中。

7.6.0.3

此版本包含以下修补程序和增强功能:

  • --limit-code-snips 标志:控制规则评估期间的代码片段限制(0=无限制,-1=禁用代码段)。
  • 修复了批量分析模式下缺少依赖项文件导致的失败:该工具在非 Java 项目或使用--mode=source-only的 Java 项目进行批量分析时不再中止。

7.6.0.2

此版本包含以下修复。

  • java-removals-00150 规则现已正确触发。

7.6.0.1

此版本包含以下修复内容和增强功能。

  • --analyze-known-libraries 标识:现在可以在 Windows 上使用。
  • 目录清理:在 Windows 上分析期间创建的额外目录现在会自动清理。
  • --json-output 标志:现在正常运行。
  • 规则分析错误:已解决此错误 unable to parse all the rules for ruleset
  • 见解选项卡说明:缺失的规则说明现在已存在。
  • Internet 连接依赖项:在没有 Internet 连接的情况下分析不再失败。
  • --context-lines 标志:现在设置为 0 时的行为与预期相同。
  • 运行该工具不再需要 Python。

7.6.0.0

此版本基于 Konveyor 项目的一组不同的组件。

常规更新

已知问题

7.7.0.7

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.7.0.6

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.7.0.4

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.7.0.3

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.7.0.2

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.7.0.1

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
    • azure-password-01000 规则仅检测一个冲突,即使同一文件中存在多个冲突也是如此。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.7.0.0

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
    • azure-password-01000 规则仅检测一个冲突,即使同一文件中存在多个冲突也是如此。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.6.0.7

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
    • azure-password-01000 规则仅检测一个冲突,即使同一文件中存在多个冲突也是如此。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.6.0.6

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
    • azure-password-01000 规则仅检测一个冲突,即使同一文件中存在多个冲突也是如此。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.6.0.5

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
    • azure-password-01000 规则仅检测一个冲突,即使同一文件中存在多个冲突也是如此。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.6.0.4

  • 规则问题:
    • 未触发 azure-system-config-01000 规则。
    • azure-password-01000 规则仅检测一个冲突,即使同一文件中存在多个冲突也是如此。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。

7.6.0.3

  • 不支持 --overrideProviderSettings 标志。
  • 规则问题:
    • 未触发 azure-system-config-01000http-session-01000 规则。
    • 未触发 FileSystem - Java IO 规则。
  • 在 Windows 上分析 WAR 文件会产生以下错误:Failed to Move Decompiled File. 在 Windows 上分析 WAR 文件时发生错误,导致在 Windows 上出现一些冗余问题。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely the **been missed**。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。
  • Ctrl+C 无法停止正在进行的分析。 为了解决该问题,可通过显式终止进程来手动终止进程。
  • 在二进制分析报告中,代码片段标题显示不正确的或不存在的文件路径。

7.6.0.2

  • 不支持 --overrideProviderSettings 标志。
  • 规则问题:
    • 未触发 azure-system-config-01000http-session-01000 规则。
    • 未触发 FileSystem - Java IO 规则。
  • 在 Windows 上分析 WAR 文件会产生以下错误:Failed to Move Decompiled File. 在 Windows 上分析 WAR 文件时发生错误,导致在 Windows 上出现一些冗余问题。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。
  • Ctrl+C 无法停止正在进行的分析。 为了解决该问题,可通过显式终止进程来手动终止进程。
  • 在二进制分析报告中,代码片段标题显示不正确的或不存在的文件路径。

7.6.0.1

  • 不支持 --overrideProviderSettings 标志。
  • 规则问题:
    • 未触发 azure-system-config-01000http-session-01000java-removals-00150 规则。
    • 未触发 FileSystem - Java IO 规则。
  • 在 Windows 上分析 WAR 文件会产生以下错误:Failed to Move Decompiled File. 在 Windows 上分析 WAR 文件时发生错误,导致在 Windows 上出现一些冗余问题。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。
  • Ctrl+C 无法停止正在进行的分析。 为了解决该问题,可通过显式终止进程来手动终止进程。
  • 在二进制分析报告中,代码片段标题显示不正确的或不存在的文件路径。

7.6.0.0

  • 标志 --analyze-known-libraries 在 Windows 上不起作用。
  • 在 Windows 上,在分析过程中会生成以下额外文件夹,但在完成后不会自动移除。 您可能想要在分析完成后移除这些额外的文件夹。
    • .metadata
    • org.eclipse.osgi
    • org.eclipse.equinox.app
    • org.eclipse.core.runtime
    • org.eclipse.equinox.launcher
  • 不支持 --overrideProviderSettings 标志。
  • 不支持 --json-output 标志。 在将来的版本中,它将为 output.yamldependency.yaml 文件生成 JSON 输出。
  • 规则问题:
    • 未触发 azure-system-config-01000http-session-01000java-removals-00150 规则。
    • 未触发 FileSystem - Java IO 规则。
    • 运行分析时出现错误 unable to parse all the rules for ruleset。 当工具无法分析规则集中的所有规则时,在分析过程中会发生此错误。
  • 在 Windows 上分析 WAR 文件会产生以下错误:Failed to Move Decompiled File. 在 Windows 上分析 WAR 文件时发生错误,导致在 Windows 上出现一些冗余问题。
  • “见解”选项卡上的某些规则缺少说明。某些标记规则缺少说明,导致报告的“见解”选项卡上显示空白标题。
  • Windows 上的“观察程序错误”通道出错:Windows system assumed buffer larger than it is, events have likely been missed。 在 Windows 上长时间运行的作业期间,此错误消息会出现在命令行上。
  • 此版本需要活动的互联网连接才能进行依赖项分析。
  • Ctrl+C 无法停止正在进行的分析。 为了解决该问题,可通过显式终止进程来手动终止进程。
  • 当标志 --context-lines 设置为数字 0 时,它不会按预期工作。 此标志使用户能够限制应在报表上显示多少源代码。 设置为值 0 可能无法按预期工作。