Resolução de problemas
Encontra soluções para problemas comuns que podes encontrar ao executar um fluxo de trabalho de Java Modernization com IBM Bob.
SDKMan ou WinGet não detetado
Garante que o SDKMan está inicializado no teu perfil shell e que reiniciaste a sessão do terminal após a instalação.
- Abre o teu perfil shell (
~/.bashrcou~/.zshrc). - Verifica que o bloco de inicialização do SDKMan está presente no final do ficheiro.
- Reinicia a sessão do terminal.
Após instalar o WinGet, reinicia o VS Code e todos os terminais abertos para que o Bob possa detetar o PATH atualizado.
Se a instalação automática estiver bloqueada pela política corporativa, instala manualmente o JDK de destino e define JAVA_HOME para apontar para ele.
Erros de resolução de dependências
Executa um build limpo para forçar o re-download das dependências.
mvn clean install -Ugradle clean build --refresh-dependenciesProblemas de integração com o Git flow
Confirma que o Git está instalado e acessível no PATH do sistema:
git --versionSe o comando não for encontrado, instala o Git para o teu sistema operativo e garante que está disponível no PATH antes de reiniciar o Bob.
UI Modernization: saída de backend ou frontend em falta
Garante que os diretórios back/ e front/ existem na raiz do projeto antes de iniciar o fluxo de trabalho de UI Modernization. Estes diretórios devem ser criados manualmente antes de iniciar o fluxo de trabalho.
Problemas com o bundle AMA (modernização para Liberty)
O AMA Migration Bundle deve ser gerado a partir do AMA versão 4.6.0 ou posterior.
Verifica o seguinte se encontrares problemas com o bundle AMA:
- O ZIP deve conter
server.xml, receitas de migração e análise de dependências ao nível superior — sem pasta de envolvimento extra. - Se o deployment no Liberty falhar, verifica que:
- O conjunto de funcionalidades do
server.xmlcorresponde à versão do Liberty instalada. - A versão do
liberty-maven-pluginestá alinhada com o teu runtime do Liberty.
- O conjunto de funcionalidades do