Requisitos previos
Revisa los requisitos del sistema, entorno y proyecto antes de iniciar un flujo de trabajo de Java Modernization con IBM Bob.
Revisa estos requisitos antes de iniciar un flujo de trabajo de Java Modernization. Un proyecto bien preparado conduce a un análisis más rápido y preciso, con menos interrupciones durante la migración.
Requisitos del sistema
| Requisito | Detalles |
|---|---|
| Java Development Kit (JDK) | Mínimo JDK 8. Se recomienda preinstalar la versión JDK de destino (por ejemplo, JDK 21). Bob puede instalar versiones de destino mediante SDKMan o WinGet. |
| IBM Bob | Versión 2.0.0 o posterior, instalado y autenticado. |
| Paquete Java Modernization | Licencia activa para el IBM Bob Premium Package para Java Modernization. |
| Git | Requerido si usas funciones de Git flow para la gestión de ramas y pull requests. |
SDKMan es necesario para gestionar las instalaciones de versiones de Java. Bob comprueba si SDKMan está presente durante el flujo de trabajo y puede pedirte que lo instales si no se detecta.
Para inicializar SDKMan en tu shell, asegúrate de que esté incluido en tu perfil de shell (~/.bashrc o ~/.zshrc). Reinicia tu sesión de terminal después de la instalación.
WinGet (Windows Package Manager) es necesario para gestionar la instalación de Java.
Después de instalar WinGet, reinicia IBM Bob y cualquier sesión de terminal abierta para que Bob pueda detectarlo en el PATH actualizado.
Requisitos del proyecto
Configuración de build
Tu proyecto debe cumplir estos requisitos antes de iniciar cualquier flujo de trabajo:
- Configuración de build válida de Maven (
pom.xml) o Gradle (build.gradle) presente. - Proyecto abierto en el nivel raíz correcto en tu IDE.
- Código fuente en una estructura de directorios estándar (
src/main/java,src/test/java). - Todas las dependencias resueltas y el proyecto compilando correctamente.
- Proyectos de módulo único: Abre la carpeta que contiene tu
pom.xmlobuild.gradleprincipal. - Proyectos de múltiples módulos: Abre la raíz del proyecto padre. Asegúrate de que todos los módulos estén listados en el POM padre y que las dependencias entre módulos estén correctamente configuradas.
- Espacios de trabajo con múltiples proyectos: Selecciona la raíz correcta del proyecto cuando Bob te lo solicite.
Control de versiones
Inicializa Git con un directorio de trabajo limpio. Confirma o guarda en stash cualquier cambio sin confirmar antes de comenzar.
Crea una rama de migración dedicada:
git checkout -b java-modernizationConfiguración del entorno
Antes de iniciar un flujo de trabajo, asegúrate de que tu entorno esté listo:
- Herramienta de build (Maven o Gradle) instalada y configurada.
- Acceso a terminal disponible para ejecutar builds y pruebas.
- Acceso a red disponible para descargar dependencias.
- Archivos innecesarios y editores cerrados.
- Artefactos de build eliminados (opcional pero recomendado).
Configuración de .bobignore
Configura .bobignore para proteger archivos sensibles y excluir ruido del análisis de Bob. El archivo usa el formato .gitignore y se encuentra en .bob/.bobignore.
Excluir:
- Dependencias grandes y artefactos de build
- Archivos de datos de prueba
- Archivos de configuración sensibles
Requisitos específicos del flujo de trabajo
Copia de seguridad y seguridad
Antes de iniciar cualquier flujo de trabajo:
Crea una copia de seguridad reciente de los archivos de tu proyecto y asegúrate de que tu repositorio Git esté limpio con todos los cambios confirmados. Notifica a tu equipo que el trabajo de modernización está en progreso.