Schnellstart: Bewerten eines Java-Projekts mit AppCAT 7

In dieser Schnellstartanleitung erfahren Sie, wie Sie AppCAT 7 für ein Java-Beispielprojekt herunterladen, installieren und ausführen.

Herunterladen und Installieren

Um die appcat-CLI zu verwenden, müssen Sie das für Ihre Umgebung spezifische Paket herunterladen und über die erforderlichen Abhängigkeiten in Ihrer Umgebung verfügen. Die appcat-CLI kann in jeder Umgebung ausgeführt werden, wie Windows, Linux oder Mac mit Intel-, ARM- und Apple Silicon-Hardware.

Um appcat zu installieren, laden Sie die entsprechende ZIP-Datei für Ihre Plattform herunter. Nachdem Sie die Datei heruntergeladen haben, sollten Sie je nach Betriebssystem entweder eine .tar.gz-Datei (Linux/macOS) oder .zip-Datei (Windows) finden.

Extrahieren Sie die Binärdatei aus der heruntergeladenen Datei. Die folgende Ordnerstruktur sollte angezeigt werden:

/azure-migrate-appcat-for-java-cli-<OS>-<architecture>-<release-version>/
├── appcat.exe (Windows) / appcat (Linux/macOS)
├── samples/
├── fernflower.jar
├── LICENSE
├── NOTICE.txt
├── maven.default.index
├── jdtls/
├── justj.zip (Windows) / justj.tar.gz (Linux/macOS)
├── static-report/
├── maven-wrapper/
├── .appcat-ignore
├── rulesets/
├── readme.md
└── readme.html

Ausführen von AppCAT für ein Java-Beispielprojekt

In den folgenden Schritten führen Sie eine Anwendungsbewertung mithilfe von AppCAT gegen Airsonic-Advanced aus – einem communitygesteuerten, webbasierten Medienstreamer, mit dem Sie auf Ihre Musiksammlung zugreifen und diese freigeben können.

1. Um von einem beliebigen Speicherort in Ihrem Terminal aus auszuführen appcat, extrahieren Sie das Archiv an Ihren gewünschten Speicherort. Aktualisieren Sie dann die PATH Umgebungsvariable so, dass sie das Verzeichnis enthält, in das Sie das Archiv extrahiert haben.

   Hinweis

   Wenn die appcat Binärdatei aufgerufen wird, sucht sie zuerst nach ihren Abhängigkeiten im ausführbaren Ordner, der in der Umgebungsvariable PATH angegeben ist. Wenn die Abhängigkeiten nicht gefunden werden, fällt sie auf das Startverzeichnis des Benutzers zurück – ~/.appcat unter Linux/Mac oder %USERPROFILE%\.appcat unter Windows.

2. Klonen Sie das Anwendungs-Repository mit dem folgenden Befehl in einen lokalen Ordner:

   git clone https://github.com/airsonic-advanced/airsonic-advanced.git
   

3. Führen Sie die Bewertungsskripts im Beispielordner des heruntergeladenen AppCAT-Releasepakets aus, indem Sie den Pfad zum geklonten Ordner aus dem vorherigen Schritt angeben. Führen Sie je nach Betriebssystem das entsprechende Skript aus, wie im folgenden Beispiel gezeigt. Die Berichte werden automatisch generiert und in Ihrem Webbrowser geöffnet. Sie finden die Berichte unter ../samples/report-* (Linux/macOS) bzw. ..\samples\report-* (Windows).

   • Linux/macOS
   • Fenster

   ./samples/run-assessment <path-to-airsonic-advanced>
   

Im samples-Verzeichnis finden Sie die folgenden Skripts zum Ausführen verschiedener Analysetypen:

• run-assessment: Stellt einen Bericht mit einer Codebewertung und Schritten für die Migration von Airsonic zu Azure App Service auf Tomcat bereit.
• run-assessment-transform-rules: Konvertiert Windup-XML-Regeln in analyzer-lsp-kompatible YAML-Regeln.
• run-assessment-custom-rules: Stellt einen Codebewertungsbericht mithilfe benutzerdefinierter Regeln transformieren XML in YAML bereit.
• run-assessment-openjdk21: Generiert einen Bericht mit einer Codebewertung und Schritten für die Migration von Airsonic zu OpenJDK 21.
• run-assessment-package-only: Erstellt einen Bericht durch Bewertung bestimmter Pakete.

Nächste Schritte

• Interpretieren des AppCAT 7-Berichts
• CLI-Befehlshandbuch für AppCAT 7
• Leitfaden zur Regelentwicklung für AppCAT 7