Pré-requisitos
Revisa os requisitos de sistema, ambiente e projeto antes de iniciar um fluxo de trabalho de Java Modernization com IBM Bob.
Revisa esses requisitos antes de iniciar um fluxo de trabalho de Java Modernization. Um projeto bem preparado leva a uma análise mais rápida e precisa, com menos interrupções durante a migração.
Requisitos do sistema
| Requisito | Detalhes |
|---|---|
| Java Development Kit (JDK) | Mínimo JDK 8. Recomenda-se a pré-instalação da versão JDK de destino (por exemplo, JDK 21). Bob pode instalar versões de destino via SDKMan ou WinGet. |
| IBM Bob | Versão 2.0.0 ou posterior, instalado e autenticado. |
| Pacote Java Modernization | Licença ativa para IBM Bob Premium Package para Java Modernization. |
| Git | Necessário se usares as funcionalidades de Git flow para gestão de branches e pull requests. |
SDKMan é necessário para gerir as instalações de versões Java. Bob verifica o SDKMan durante o fluxo de trabalho e pode solicitar a sua instalação se não for detectado.
Para inicializar o SDKMan no teu shell, certifica-te de que está incluído no teu perfil shell (~/.bashrc ou ~/.zshrc). Reinicia a sessão do terminal após a instalação.
WinGet (Windows Package Manager) é necessário para a gestão de instalações Java.
Após instalar o WinGet, reinicia o IBM Bob e quaisquer sessões de terminal abertas para que Bob possa detectá-lo no PATH atualizado.
Requisitos do projeto
Configuração do build
O teu projeto deve cumprir estes requisitos antes de iniciar qualquer fluxo de trabalho:
- Configuração de build Maven (
pom.xml) ou Gradle (build.gradle) válida presente. - Projeto aberto no nível raiz correto no teu IDE.
- Código-fonte numa estrutura de diretórios padrão (
src/main/java,src/test/java). - Todas as dependências resolvidas e o projeto compilando com sucesso.
- Projetos de módulo único: Abre a pasta que contém o teu
pom.xmloubuild.gradleprincipal. - Projetos multi-módulo: Abre a raiz do projeto pai. Certifica-te de que todos os módulos estão listados no POM pai e que as dependências entre módulos estão corretamente configuradas.
- Workspaces com múltiplos projetos: Seleciona a raiz de projeto correta quando solicitado pelo Bob.
Controlo de versão
Inicializa o Git com um diretório de trabalho limpo. Faz commit ou stash de quaisquer alterações não commitadas antes de começar.
Cria um branch de migração dedicado:
git checkout -b java-modernizationConfiguração do ambiente
Antes de iniciar um fluxo de trabalho, garante que o teu ambiente está pronto:
- Ferramenta de build (Maven ou Gradle) instalada e configurada.
- Acesso ao terminal disponível para executar builds e testes.
- Acesso à rede disponível para downloads de dependências.
- Ficheiros desnecessários e editores fechados.
- Artefactos de build limpos (opcional mas recomendado).
Configuração de .bobignore
Configura .bobignore para proteger ficheiros sensíveis e excluir ruído da análise do Bob. O ficheiro usa o formato .gitignore e está localizado em .bob/.bobignore.
Excluir:
- Dependências grandes e artefactos de build
- Ficheiros de dados de teste
- Ficheiros de configuração sensíveis
Requisitos específicos de fluxo de trabalho
Backup e segurança
Antes de iniciar qualquer fluxo de trabalho:
Cria um backup recente dos ficheiros do teu projeto e garante que o teu repositório Git está limpo com todas as alterações commitadas. Notifica a tua equipa que o trabalho de modernização está em curso.