Cambiar la versión de Java en Eclipse

Para cambiar la versión de Java que utiliza un proyecto de Eclipse, primero instala en tu equipo el Java Development Kit (JDK) o el Java Runtime Environment (JRE) que quieras usar. Después, haz que esa instalación esté disponible en Eclipse y selecciónala para el proyecto. Eclipse no descarga ni instala Java desde las preferencias de ejecución. Los proyectos nuevos y los existentes requieren una selección de entorno de ejecución propia, independiente del nivel de compatibilidad del compilador de Java.

Agregar un JRE instalado a Eclipse

Eclipse puede seleccionar un entorno de ejecución de Java que ya esté instalado en el equipo. Antes de cambiar un proyecto, instala la versión del JDK o JRE que quieras utilizar. Un JDK incluye herramientas de desarrollo además del entorno de ejecución y, por lo general, es la opción adecuada para compilar código fuente Java. Un JRE proporciona el entorno de ejecución. El paquete de instalación y las versiones de Java compatibles dependen del sistema operativo y de los requisitos del proyecto.

Registra la instalación local en la configuración de entornos de ejecución de Java de Eclipse; para ello, indica dónde está instalada y asígnale un nombre fácil de reconocer. Las etiquetas de las preferencias y la navegación pueden variar entre versiones de Eclipse, así que utiliza la configuración de Java disponible en la versión instalada en lugar de seguir una secuencia de menús específica. El registro indica a Eclipse dónde está Java: no lo instala ni selecciona automáticamente ese entorno para todos los proyectos.

Si la instalación que quieres usar ya aparece entre los entornos de ejecución disponibles en Eclipse, puedes seleccionar esa opción. Si no aparece, primero instala Java y luego agrega su instalación local a Eclipse. Si tienes varias instalaciones, asígnales nombres claros que incluyan la versión o distribución de Java. Así será más fácil reconocerlas al seleccionar el entorno para un proyecto y evitar confusiones entre instalaciones con nombres parecidos.

Elegir una versión de Java para un proyecto nuevo en Eclipse

Al crear un proyecto, elige uno de los entornos registrados como JRE del proyecto. Esta selección determina qué entorno de ejecución de Java asocia Eclipse al proyecto cuando lo ejecuta o lo compila con esa configuración. Elige la versión que necesiten la aplicación y sus dependencias; instalar una versión más reciente de Java no garantiza por sí solo que una aplicación dirigida a una versión anterior sea compatible.

Si el entorno que necesitas no aparece durante la configuración del proyecto, vuelve a los entornos registrados en Eclipse y comprueba que hayas agregado el JDK o JRE local. Después, vuelve a seleccionar el entorno de ejecución del proyecto. El proyecto también puede tener una configuración independiente de compatibilidad del compilador o de compatibilidad del código fuente. Esta determina el nivel del lenguaje Java y de los archivos de clase al que compila el compilador; seleccionar un entorno de ejecución no necesariamente la modifica. Ajusta ambas configuraciones a los requisitos del proyecto, pero no des por hecho que son la misma opción.

Cambiar la versión de Java de un proyecto existente en Eclipse

En un proyecto existente, cambia el entorno de ejecución asociado por el JDK o JRE registrado que quieras utilizar. Eclipse ofrece una configuración del proyecto para este fin, aunque los nombres y la disposición de los controles varían según la versión. Busca la configuración del entorno de ejecución de Java o de la biblioteca del sistema JRE del proyecto, sustituye la selección actual y aplica el cambio con los controles de tu versión de Eclipse. Si el entorno que necesitas no aparece entre las opciones disponibles, primero registra su instalación local.

Después de aplicar el cambio, revisa la configuración del entorno de ejecución del proyecto y confirma que indique la instalación deseada. También puedes ejecutar el proyecto y comprobar la versión de Java que comunica la aplicación. Para hacer una comprobación sencilla dentro del proyecto, este programa Java completo muestra la versión de ejecución de la JVM que lo ejecuta. En la ejecución registrada para este ejemplo, el programa mostró 17.0.20.1; ese valor identifica la JVM usada en esa ejecución, y el resultado que obtengas dependerá de la JVM seleccionada para tu proyecto. La salida del ejemplo conserva literalmente cualquier etiqueta visible en inglés, ya que el bloque no se modifica.

Ejecuta este ejemplo:

public class Main {
    public static void main(String[] args) {
        System.out.println(System.getProperty("java.version"));
    }
}

17.0.20.1

Una ejecución correcta confirma qué JVM ejecutó el programa, pero no determina el nivel de código fuente ni el nivel de compatibilidad del compilador. Si la versión comunicada no coincide con la que esperabas, vuelve a revisar la selección del entorno de ejecución y comprueba qué proyecto o configuración de ejecución estás usando. Para completar la migración, revisa por separado la configuración de compatibilidad del compilador y asegúrate de que las bibliotecas y herramientas de compilación necesarias sean compatibles con la versión de Java seleccionada.