UnifiedASATVisualizer

Visualiseur ASAT unifié

À propos

Cet outil consiste à créer une visualisation des avertissements / défauts générés par les ASAT (outils d'analyse statique automatisés). Avec cette visualisation, vous pouvez obtenir des informations sur les choses suivantes:

• D'où viennent la plupart des avertissements.
• À partir de quels packages (et aussi des classes) la plupart des avertissements proviennent.
• À partir de laquelle des trois catégories ( défauts fonctionnels , défauts de maintenabilité et autres ), la plupart des avertissements proviennent. (Veuillez jeter un œil à ce document pour plus d'informations sur les trois catégories.)

Exigences:

• L'un des navigateurs Internet suivants: Google Chrome ou Safari.
• Java JDK 1.8 (mise à jour 40 ou plus).
• Version ASATS:
  • CheckStyle 6.1.1, PMD 5.2.3 et Findbugs 3.0.1. (CheckStyle 6.17 et PMD version 5.3.2 fonctionnent également).
• Les utilisateurs doivent avoir installé Maven (plugin IDE ou autonome) pour exécuter mvn site .
• Le projet qui va être analysé doit être un projet Maven.
• Le projet qui va être analysé doit soutenir l'exécution des ASAT. Nous prenons en charge FindBugs, CheckStyle, PMD.

Bâtiment

• Exécutez mvn package .
• Si vous souhaitez contribuer au développement d'UAV, veuillez installer Lombok pour générer automatiquement les getters et les setters. (Via java -jar lib/lombok.jar install path/to/your/ide )

Exécution du programme:

L'exécution de l'UAV est simple: après l'avoir construite, le dernier pot exécutable a été placé de manière convaincante dans le dossier de base du projet. Tout ce que vous avez à faire est:

• Démarrer UAV via java -jar UnifiedASATVisualizer-1.1.2.jar
• Suivez l'instruction sur l'interface utilisateur d'UAV.
• Sélectionnez le répertoire de projet de niveau supérieur (sur votre ordinateur) que vous souhaitez visualiser.
• Cliquez sur le bouton Visualize . Selon la taille du projet et le nombre d'avertissements, cela peut prendre un certain temps pour générer la visualisation HTML.
• Si la visualisation ne s'ouvre pas automatiquement (problèmes connus avec Linux) ou que l'application Java semble s'être écrasée, ouvrir manuellement ./visualization/main.html dans Chrome ou Safari.

L'UAV vous oblige à fonctionner sur un projet Java avec des avertissements ASAT générés via maven site . De nombreux projets célèbres incluent déjà cela, mais si vous souhaitez analyser un projet qui ne le fait pas, voici comment vous le faites:

• Ajoutez l'extrait suivant dans le fichier pom.xml du projet que vous souhaitez analyser:

 < 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 >

Copiez l'extrait entier uniquement si vous n'avez pas <reporting> dans votre pom.xml. Si vous le faites, copiez simplement les plugins. Pour plus d'informations sur la façon d'exclure certains fichiers ou comment utiliser des ensembles de règles spécifiques, veuillez vérifier les liens suivants: (findBugs, CheckStyle, PMD)

• Exécutez mvn site sur le projet que vous souhaitez analyser (cela génère les rapports ASAT qui sont lus par UAV).