Guia de início rápido: avaliar um projeto Java usando o AppCAT 7

Este guia de início rápido mostra como baixar, instalar e executar o AppCAT 7 em um projeto Java de exemplo.

Transferir e instalar

Para usar a appcat CLI, você deve baixar o pacote específico para seu ambiente e ter as dependências necessárias em seu ambiente. A appcat CLI é executada em qualquer ambiente, como Windows, Linux ou Mac, usando hardware Intel, Arm ou Apple Silicon.

Para instalar o appcat, descarregue o ficheiro zip apropriado para a sua plataforma. Depois de baixar o arquivo, dependendo do seu sistema operacional, você deve encontrar um arquivo .tar.gz (Linux/macOS) ou .zip (Windows).

Extraia o binário do arquivo baixado. Você deve ver a seguinte estrutura de pastas:

/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

Execute o AppCAT em um projeto Java de exemplo

Nas etapas a seguir, você faz uma avaliação de aplicativo usando o AppCAT contra o Airsonic-Advanced - um streamer de mídia baseado na Web orientado pela comunidade que permite acessar e compartilhar sua coleção de músicas.

1. Para executar appcat a partir de qualquer local no seu terminal, extraia o arquivo para o local desejado. Em seguida, atualize a PATH variável de ambiente para incluir o diretório onde você extraiu o arquivo.

   Observação

   Quando o appcat binário é chamado, ele primeiro procura suas dependências na pasta executável especificada na PATH variável de ambiente. Se as dependências não forem encontradas, ele retornará ao diretório inicial do usuário - ~/.appcat no Linux/Mac ou %USERPROFILE%\.appcat no Windows.

2. Clone o repositório do aplicativo em uma pasta local usando o seguinte comando:

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

3. Execute os scripts de avaliação na pasta de exemplos do pacote de versão AppCAT baixado, fornecendo o caminho para a pasta clonada da etapa anterior. Dependendo do seu sistema operacional, execute o script apropriado, conforme mostrado no exemplo a seguir. Os relatórios são gerados e abertos automaticamente no seu navegador da web. Pode encontrar os relatórios em .. /samples/report-* (Linux/macOS) ou .. \samples\report-* (Windows).

   • Linux / macOS
   • Windows

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

No diretório de exemplos, você pode encontrar os seguintes scripts para executar diferentes tipos de análise:

• run-assessment: fornece um relatório com avaliação de código e etapas para migrar o Airsonic para o Serviço de Aplicativo do Azure no Tomcat.
• run-assessment-transform-rules: Converte regras XML de Windup em regras YAML compatíveis com analyzer-lsp.
• run-assessment-custom-rules: fornece um relatório de avaliação de código usando regras personalizadas que transformam XML em YAML.
• run-assessment-openjdk21: Gera um relatório com avaliação de código e etapas para migrar o Airsonic para o OpenJDK 21.
• run-assessment-package-only: Produz um relatório através da avaliação de pacotes específicos.

Próximos passos

• Interpretar o relatório AppCAT 7
• Guia de comandos da CLI para AppCAT 7
• Guia de desenvolvimento de regras para AppCAT 7