使用 .NET 升级助手分析项目

本文介绍如何使用 Visual Studio 或终端通过 .NET 升级助手对项目执行代码分析。 该分析将生成一个报表,你可以浏览以获取有关升级的详细信息。

先决条件

在 Visual Studio 中创建报表

按照以下步骤在 Visual Studio 中分析项目。

  1. 打开“Visual Studio”。

  2. 打开项目或解决方案。

  3. 解决方案资源管理器窗口中,右键单击解决方案>升级

    Visual Studio 中的解决方案资源管理器窗口,显示解决方案的右键单击菜单。突出显示“升级”菜单项。

  4. “升级助手:开始 ”选项卡中,选择“ 新建报表”。

    Visual Studio 中的 .NET 升级助手分析向导的欢迎页面。突出显示了“新建报表”链接。

  5. 选择要分析的一个或多个项目,然后选择“ 下一步”。

    Visual Studio 中的 .NET 升级助手分析向导的“选择项目”页。项目列表与“下一步”按钮一起突出显示。

  6. 选择目标框架,例如 .NET 8.0。 然后选择下一步

    Visual Studio 中的 .NET 升级助手分析向导的“目标框架”页。“.NET 8.0”项与“下一步”按钮一起突出显示。

  7. 选择要分析的组件,然后选择“ 下一步”。

    Visual Studio 中的 .NET 升级助手分析向导的“分析设置”页。已选择“源代码和设置”选项。突出显示了“下一步”按钮。

  8. 将显示正在分析的每个项目的进度指示器。

    运行分析的 .NET 升级助手分析向导。

  9. 分析完成后,将显示报表仪表板。 有关仪表板的详细信息,请参阅 报表

    .NET 升级助手分析向导显示包含分析结果的报表仪表板。

从 CLI 创建报表

按照以下步骤使用终端分析项目。 .NET 全局工具是一种交互式工具,可指导你完成分析选项。 使用向上键向下键更改突出显示的选项,Enter 以运行该选项。 每个屏幕都提供了有关如何配置报表的选项。

  1. 打开终端并导航到包含要分析的解决方案或项目的文件夹。

  2. 若要启动该工具,请运行 upgrade-assistant analyze 命令。

  3. 系统会询问要分析的内容。 对于此示例,请选择 应用程序源 ,然后按 Enter

    显示 .NET 升级助手全局工具选项的初始屏幕的终端。系统询问了“你想要分析什么”的问题。

  4. 选择目标框架(如 .NET 8.0),然后按 Enter

  5. 选择要扫描的项目类型。 使用 空格键 切换选项,然后按 Enter

  6. 配置文件 屏幕上,按 n,除非有要应用的规则集配置文件。

  7. 选择生成的报表的格式。 对于本示例,请选择“ 另存为 HTML”。

  8. 输入名称 MyReport ,然后按 Enter

  9. 选择适当的隐私模式,例如 “受限 ”,然后按 Enter

  10. 最后一个提示是确认,显示你选择的所有选项。 按 Enter 运行分析并生成报表。

    显示 .NET 升级助手全局工具选项摘要屏幕的终端。系统会要求用户继续。

  11. 报表完成后,将显示报表的摘要。 报表的结果将保存到已分析的项目或解决方案的文件夹。

    使用 .NET 升级助手全局工具时显示分析命令的结果的终端。