UnifiedASATVisualizer

Unified ASAT Visualizer

について

このツールは、ASATSによって生成された警告/欠陥の視覚化を作成するためのものです（自動静的分析ツール）。この視覚化により、次のことに関する情報を入手できます。

• ほとんどの警告が出身です。
• どのパッケージ（およびクラス）からほとんどの警告は出身です。
• 3つのカテゴリ（機能的欠陥、保守性の欠陥など）のうち、ほとんどの警告はfromからです。 （3つのカテゴリの詳細については、このペーパーをご覧ください。）

要件：

• 次のインターネットブラウザーのいずれか：Google ChromeまたはSafari。
• Java JDK 1.8（更新40以降）。
• Asatsバージョン：
  • CheckStyle 6.1.1、PMD 5.2.3およびFindBugs 3.0.1。 （CheckStyle 6.17およびPMDバージョン5.3.2も機能します）。
• ユーザーは、 mvn siteを実行するためにMaven（IDEプラグインまたはスタンドアロンアプリ）をインストールする必要があります。
• 分析されるプロジェクトは、Mavenプロジェクトでなければなりません。
• 分析される予定のプロジェクトは、ASATSの実行をサポートする必要があります。 FindBugs、CheckStyle、PMDをサポートしています。

建物

• mvn packageを実行します。
• UAVの開発に貢献したい場合は、Lombokをインストールしてゲッターとセッターを自動生成してください。 （ java -jar lib/lombok.jar install path/to/your/ide ）

プログラムの実行：

UAVの実行はシンプルです。それを構築した後、最新の実行可能なJARがプロジェクトのベースフォルダーに納得できるように配置されています。あなたがしなければならないのは：

• java -jar UnifiedASATVisualizer-1.1.2.jar経由でuavを開始します
• UAVのユーザーインターフェイスの命令に従ってください。
• 視覚化するトップレベルのプロジェクトディレクトリ（コンピューター上）を選択します。
• Visualizeボタンをクリックします。プロジェクトのサイズと警告の数に応じて、これにはHTMLの視覚化を生成するのに時間がかかる場合があります。
• 視覚化が自動的に開かれない場合（Linuxの既知の問題）、またはJavaアプリケーションがクラッシュしたように見えます。ChromeまたはSafariで手動で開いてください。/visualization/main.html。

UAVでは、 maven siteを介して生成されたASAT警告を使用して、Javaプロジェクトで実行する必要があります。多くの有名なプロジェクトにはすでにこれが含まれていますが、そうでないプロジェクトを分析したい場合は、次の方法があります。

• 分析するプロジェクトのpom.xmlファイルに次のスニペットを追加します。

 < reporting >
    < plugins >
    
      < plugin >
        < groupId >org.apache.maven.plugins</ groupId >
        < artifactId >maven-checkstyle-plugin</ artifactId >
        < version >2.17</ version >
        < reportSets >
          < reportSet >
            < reports >
              < report >checkstyle</ report >
            </ reports >
          </ reportSet >
        </ reportSets >
      </ plugin >

      < plugin >
        < groupId >org.apache.maven.plugins</ groupId >
        < artifactId >maven-pmd-plugin</ artifactId >
        < version >3.7</ version >
      </ plugin >
    
      < plugin >
        < groupId >org.codehaus.mojo</ groupId >
        < artifactId >findbugs-maven-plugin</ artifactId >
        < version >3.0.4</ version >
      </ plugin >
    
    </ plugins >
 </ reporting >

pom.xmlに<reporting>がない場合にのみ、スニペット全体をコピーします。もしそうなら、プラグインをコピーするだけです。特定のファイルを除外する方法または特定のルールセットの使用方法の詳細については、次のリンクを確認してください。（FindBugs、CheckStyle、PMD）

• 分析するプロジェクトでmvn siteを実行します（これにより、UAVが読み取るASATレポートが生成されます）。