什么是 .NET 升级助手的代码分析？

本文概述了 .NET 升级助手的代码分析函数。 代码分析基于项目配置、依赖项和代码生成报表。 报告包含有关升级过程中可能遇到的潜在问题和问题的信息，以及修正这些问题所要采取的步骤。

分析类型

可以对代码执行两种类型的分析：

• 源代码和设置

  分析源代码、配置和设置。

• 二进制依赖项

  分析项目的外部二进制依赖项（如 NuGet 包）。

报表

分析完成后会生成仪表板报表。 此报表按项目、文件、事件和 情景点细分结果。 还可以使用聚合视图，将类似问题分组在一起，而不管它们检测到的项目是什么。

提示

故事要点是一种敏捷概念，可帮助估算解决问题所需的复杂性和工作量。 有关详细信息，请参阅“ 事件故事点 ”部分。

报表中的每个问题都按 严重性 进行分类，以帮助你确定需要进行的任何修补程序的优先级。 问题要么是必需的，要么是可选的。 强制问题会阻止升级。 可选问题提供了升级到较新的功能、库或代码增强的机会。

以下部分详细介绍了报表的区域。

仪表板

“ 仪表板 ”页提供扫描检测到的事件视图，并分组到面板中：

• 总结

  • 项目

    这是检测到事件的项目数。

  • 问题

    扫描期间触发的唯一规则数。 每个问题都有自己的严重性和情节点，以及每个检测到的实例（事件）。

  • 事件

    事件是特定位置检测到的问题实例，例如代码段或二进制文件。 每个事件都包含触发问题的上下文信息。

  • 故事点

    完成升级所需的故事点总数。 有关故事点是什么的详细信息，请参阅“ 事件故事点 ”部分。

• 严重性和类别

  这两个面板显示按严重性和类别对事件进行分组的图表。 有关严重性的详细信息，请参阅 “事件严重性 ”部分。

项目

“ 项目” 页按项目细分问题、事件和情景点。 每个项目都是一个链接，用于打开筛选到该项目的向下钻取报表。

聚合问题

“ 聚合问题 ”页详细介绍了触发的每个问题。 可以扩展每个问题，列出该问题的每个事件。 “ 状态 ”列可帮助你跟踪已修复或被视为不适用的问题。

事件严重性

每个问题事件都有关联的严重性，这可能会阻止升级。 严重性可帮助你了解必须更新哪些内容才能使升级成功。

Severity	说明
必需	必须解决。 升级过程可能会为你处理这些问题，例如更新目标框架运行时（TFM）。
可选	这些方法不应对升级造成问题，但你可能希望在升级之前或之后考虑解决这些问题。
Potential	升级后可能导致问题的问题（如果现在未解决）。
信息	与升级相关的额外信息。

事件故事点

每个问题事件都有一个关联的故事点。 故事点是衡量事件复杂性的一个度量单位，有助于估计解决该事件所需的时间。 .NET 升级助手通过下表定义故事点值：

故事点	大小
1	无庸赘述
3	Complex
5	重新设计
7	重新架构
13	未知

相关内容

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