.NET アップグレード アシスタントを使用したコード分析とは

この記事では、.NET アップグレード アシスタントのコード分析機能の概要について説明します。 コード分析では、プロジェクトの構成、依存関係、およびコードに基づいてレポートが生成されます。 このレポートには、アップグレード中に発生する可能性のある問題と、それらの問題を修復するために実行できる手順に関する情報が含まれています。

分析の種類

コードに対して実行できる分析には、次の 2 種類があります。

• ソース コードと設定

  ソース コード、構成、設定を分析します。

• バイナリ依存関係

  プロジェクトの外部バイナリ依存関係 (NuGet パッケージなど) を分析します。

Reports

分析が完了すると、ダッシュボード レポートが生成されます。 このレポートでは、プロジェクト、ファイル、インシデント、 のポイント別に結果を分類。 集計ビューを使用して、検出されたプロジェクトに関係なく、同様の問題をグループ化することもできます。

ヒント

ストーリー ポイントは、問題を解決するために必要な複雑さと労力を見積もるのに役立つアジャイルの概念です。 詳細については、「 Incident ストーリー ポイント 」セクションを参照してください。

レポート内の各問題は、 に分類され 必要な修正プログラムの優先順位付けに役立ちます。 問題は必須または省略可能です。 必須の問題により、アップグレードがブロックされます。 オプションの問題により、新しい機能、ライブラリ、またはコードの機能強化にアップグレードできます。

次のセクションでは、レポートの領域について詳しく説明します。

ダッシュボード​

Dashboard ページには、スキャンによって検出されたインシデントがパネルにグループ化されて表示されます。

• まとめ

  • プロジェクト

    これは、インシデントが検出されたプロジェクトの数です。

  • 問題

    スキャン中にトリガーされた一意のルールの数。 各問題には、検出された各インスタンス (インシデント) と共に、独自の重大度とストーリー ポイントがあります。

  • インシデント

    インシデントとは、コードやバイナリ ファイルなど、特定の場所で検出された問題のインスタンスです。 各インシデントには、問題をトリガーしたコンテキスト情報が含まれています。

  • ストーリー ポイント

    アップグレードを完了するために必要なストーリー ポイントの合計数。 ストーリー ポイントの詳細については、「 Incident ストーリー ポイント 」セクションを参照してください。

• 重大度 と カテゴリ

  これら 2 つのパネルは、インシデントを重大度とカテゴリ別にグループ化するグラフを示しています。 重大度の詳細については、「 Incident severity 」セクションを参照してください。

プロジェクト

Projects ページでは、プロジェクトごとに問題、インシデント、ストーリー ポイントが分割されます。 各プロジェクトは、そのプロジェクトにフィルター処理されたドリルダウン レポートを開くリンクです。

問題の集計

Aggregate の問題ページには、トリガーされた各問題の詳細が表示されます。 各問題を展開して、その問題のすべてのインシデントを一覧表示できます。 State 列は、修正した問題や該当しないと見なした問題を追跡するのに役立ちます。

インシデントの重大度

各問題インシデントには重大度が関連付けられているため、アップグレードがブロックされる可能性があります。 重大度は、アップグレードを成功させるために更新する必要がある内容を理解するのに役立ちます。

重大度	説明
必須	アドレス指定する必要があります。 アップグレード プロセスでは、ターゲット フレームワーク ランタイム (TFM) の更新など、これらの問題が処理される場合があります。
省略可能	これらはアップグレードに問題を引き起こすべきではありませんが、アップグレードの前または後に対処することを検討することをお勧めします。
Potential	アップグレード後に問題が発生する可能性がある問題 (今すぐ対処しない場合)。
情報	アップグレードに関連する追加情報。

インシデント ストーリー ポイント

各問題インシデントには、ストーリー ポイントが関連付けられています。 ストーリー ポイントは、インシデントの複雑さを測定するための測定単位であり、インシデントの解決に必要な時間を見積もるのに役立ちます。 .NET アップグレード アシスタントでは、次の表に示すストーリー ポイントの値を定義します。

ストーリー ポイント	[サイズ]
1	単純変換
3	Complex
5	再設計
7	再設計
13	Unknown

関連するコンテンツ

• .NET アップグレード アシスタントを使用してプロジェクトを分析する