什麼是 .NET Upgrade Assistant 的程式代碼分析？

本文提供 .NET Upgrade Assistant 程式代碼分析函式的概觀。 程式代碼分析會根據您的項目組態、相依性和程式代碼產生報表。 報告包含您在升級期間可能遇到的潛在問題和問題的相關信息，以及您可以採取哪些步驟來補救這些問題。

分析類型

您可以在程式代碼上執行兩種類型的分析：

• 原始碼和設定

  分析您的原始碼、組態和設定。

• 二進位相依性

  分析專案的外部二進位相依性（例如 NuGet 套件）。

報表

分析完成之後會產生儀錶板報表。 此報表會依專案、檔案、事件和 故事點細分結果。 您也可以使用匯總檢視，將類似問題分組在一起，而不論他們偵測到的項目為何。

提示

本文要點是敏捷式概念，可協助預估修正問題所需的複雜度和精力。 如需詳細資訊，請參閱 事件故事點 一節。

報表中的每個問題都會依 嚴重性 分類，以協助您優先處理您需要進行的任何修正。 問題是必要或選擇性的問題。 強制問題會封鎖升級。 選擇性問題可讓您升級至較新的功能、連結庫或程式代碼增強功能。

下列各節將詳細說明報表的區域。

儀表板

[ 儀錶板 ] 頁面提供掃描偵測到的事件檢視，並分組到面板：

• 摘要

  • 專案

    這是偵測到事件的項目數目。

  • 問題

    掃描期間觸發的唯一規則數目。 每個問題都有自己的嚴重性和故事點，以及每個偵測到的實例（事件）。

  • 事件

    事件是特定位置偵測到的問題實例，例如一段程式代碼或二進位檔。 每個事件都包含觸發問題的內容資訊。

  • 故事點

    完成升級所需的故事點總數。 如需故事點為何的詳細資訊，請參閱 事件故事點 一節。

• 嚴重性和類別

  這兩個面板會顯示依嚴重性和類別分組事件的圖表。 如需嚴重性的詳細資訊，請參閱 事件嚴重性 一節。

專案

[ 專案] 頁面會依專案細分問題、事件和故事點。 每個專案都是開啟篩選至該專案之向下切入報表的連結。

匯總問題

[ 匯總問題] 頁面會詳細說明觸發的每個問題。 每個問題都可以展開，以列出該問題的每個事件。 [狀態] 資料行可協助您追蹤已修正或視為不適用的問題。

事件嚴重性

每個問題事件都有相關聯的嚴重性，可能會封鎖升級。 嚴重性可協助您了解升級必須更新哪些專案才能成功。

嚴重性	描述
必要	必須尋址。 升級程式可能會為您處理這些問題，例如更新目標 Framework 運行時間 （TFM）。
選擇性	這些不應該對升級造成問題，但您可能想要考慮在升級之前或之後加以解決。
可能性	如果您現在未解決升級問題，可能會在升級之後造成問題的問題。
資訊	與升級相關的額外資訊。

事件案例點

每個問題事件都有相關聯的故事點。 故事點是測量事件複雜度測量的單位，可協助預估解決該事件所需的時間。 .NET Upgrade Assistant 會依下表定義故事點值：

故事點數	大小
1	一般
3	Complex
5	重新設計
7	重新架構
13	Unknown

相關內容

• 使用 .NET Upgrade Assistant 分析專案