通过

快速入门：使用 AppCAT 7 评估 Java 项目

本快速入门介绍如何针对示例 Java 项目下载、安装和运行 AppCAT 7。

下载并安装

要使用 appcat CLI，必须下载特定于环境的包，并在环境中具有所需的依赖项。 appcat CLI 可在任何环境下运行，如 Windows、Linux 或 Mac，使用 Intel、Arm 或 Apple Silicon 硬件。

OS Architecture 下载链接 其他文件
x64
Windows x64 Download sha256 / sig
macOS x64 Download sha256 / sig
Linux x64 Download sha256 / sig
AArch64
Windows AArch64 / ARM64 Download sha256 / sig
macOS Apple Silicon Download sha256 / sig
Linux AArch64 / ARM64 Download sha256 / sig

要安装 appcat，请下载适合平台的 zip 文件。 下载文件后，根据作系统，应找到 .tar.gz （Linux/macOS）或 .zip 文件（Windows）。

从下载的文件中提取二进制文件。 应该看到以下文件夹结构：

/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

针对示例 Java 项目运行 AppCAT

在以下步骤中，你将使用 AppCAT 对 Airsonic-Advanced 执行应用程序评估，这是一种基于社区驱动的基于 Web 的媒体流式传输程序，可用于访问和共享音乐集合。

  1. 若要从终端中的任何位置运行 appcat ，请将存档提取到所需位置。 然后，更新 PATH 环境变量以包含提取存档的目录。

    Note

    appcat调用二进制文件时，它会首先在环境变量中指定的PATH可执行文件文件夹中查找其依赖项。 如果未找到依赖项，则它会回退到用户的主目录 - Linux/Mac 上的 ~/.appcat ，或在 Windows 上 %USERPROFILE%\.appcat 。

  2. 使用以下命令将应用程序存储库克隆到本地文件夹：

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

  3. 通过提供上一步克隆文件夹的路径，在下载的 AppCAT 发布包的示例文件夹中运行评估脚本。 根据作系统运行相应的脚本，如以下示例所示。 报表在 Web 浏览器中自动生成并打开。 可以在 ../samples/report-* (Linux/macOS) 或 ..\samples\report-* (Windows) 下找到该报告。

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

Note

确保提取文件夹中脚本的文件权限设置为允许执行。

在 示例 目录中，可以找到以下脚本来运行不同类型的分析：

  • 运行评估：提供代码评估和将 Airsonic 迁移到 Tomcat 上的 Azure 应用服务的步骤的报告。
  • run-assessment-transform-rules：将 Windup XML 规则转换为与 analyzer-lsp 兼容的 YAML 规则。
  • run-assessment-custom-rules：使用自定义规则 将 XML 转换为 YAML 提供代码评估报告。
  • run-assessment-openjdk21：生成包含代码评估和将 Airsonic 迁移到 OpenJDK 21 的步骤的报告。
  • 仅运行评估包：通过评估特定包生成报告。

后续步骤