Ändern Sie die Java-Version in Eclipse

Um die von einem Eclipse-Projekt verwendete Java-Version zu ändern, installieren Sie zunächst das gewünschte Java Development Kit (JDK) oder die gewünschte Java Runtime Environment (JRE) auf Ihrem Computer. Binden Sie diese Installation anschließend in Eclipse ein und wählen Sie sie für das Projekt aus. Eclipse lädt Java nicht über die Laufzeiteinstellungen herunter und installiert es auch nicht. Für neue und bestehende Projekte muss jeweils eine eigene Laufzeit ausgewählt werden. Diese Auswahl ist unabhängig von der Java-Compiler-Kompatibilitätsstufe.

Eine installierte JRE in Eclipse einbinden

Eclipse kann eine Java-Laufzeit auswählen, die bereits auf dem Computer vorhanden ist. Installieren Sie daher die gewünschte JDK- oder JRE-Version, bevor Sie ein Projekt ändern. Ein JDK umfasst neben der Laufzeit auch Entwicklungswerkzeuge und eignet sich im Allgemeinen zum Kompilieren von Java-Quellcode. Eine JRE stellt die Laufzeitumgebung bereit. Welches Installationspaket und welche Java-Versionen verfügbar sind, hängt vom Betriebssystem und den Anforderungen des Projekts ab.

Registrieren Sie die lokale Installation in der Java-Laufzeitkonfiguration von Eclipse, indem Sie ihren Installationsort angeben und ihr einen aussagekräftigen Namen geben. Die Bezeichnungen und die Navigation in den Einstellungen können sich zwischen Eclipse-Versionen unterscheiden. Verwenden Sie daher die Java-Laufzeitkonfiguration Ihrer installierten Version, statt sich auf eine bestimmte Menüfolge zu verlassen. Durch die Registrierung weiß Eclipse, wo Java installiert ist. Java wird dadurch weder installiert noch diese Laufzeit automatisch für jedes Projekt ausgewählt.

Wenn die gewünschte Installation bereits in der Liste der verfügbaren Laufzeiten von Eclipse steht, können Sie diesen Eintrag verwenden. Andernfalls installieren Sie Java zuerst und fügen dann die lokale Installation in Eclipse hinzu. Sind mehrere Installationen vorhanden, wählen Sie einen eindeutigen Namen, der die Java-Version oder Distribution enthält. So lässt sich die passende Laufzeit später leichter auswählen und von ähnlich benannten Installationen unterscheiden.

Eine Java-Version für ein neues Eclipse-Projekt auswählen

Wählen Sie beim Erstellen eines Projekts eine der registrierten Laufzeiten als JRE des Projekts aus. Damit legen Sie fest, welche Java-Laufzeit Eclipse diesem Projekt zuordnet, wenn es mit dieser Konfiguration gestartet oder erstellt wird. Wählen Sie die Version, die die Anwendung und ihre Abhängigkeiten benötigen. Eine neuere Java-Installation garantiert für sich genommen keine Kompatibilität mit einer Anwendung, die auf eine ältere Version ausgerichtet ist.

Wird die gewünschte Laufzeit beim Einrichten des Projekts nicht angeboten, prüfen Sie in der Liste der registrierten Laufzeiten von Eclipse, ob das lokale JDK oder die JRE hinzugefügt wurde. Wählen Sie anschließend erneut die Projektlaufzeit aus. Für das Projekt kann außerdem eine separate Einstellung für die Compiler-Kompatibilität oder die Quellcode-Kompatibilität gelten. Sie legt fest, auf welche Java-Sprach- und Klassendateiversion der Compiler abzielt. Durch die Auswahl einer Laufzeit wird diese Einstellung nicht zwingend geändert. Stimmen Sie beide Einstellungen auf die Anforderungen des Projekts ab, ohne sie als dieselbe Option zu behandeln.

Die Java-Version eines bestehenden Eclipse-Projekts ändern

Ändern Sie bei einem bestehenden Projekt die zugeordnete Laufzeit auf das registrierte JDK oder die registrierte JRE, das beziehungsweise die Sie verwenden möchten. Eclipse bietet dafür Projekteinstellungen, deren Bezeichnungen und Anordnung je nach Version variieren. Suchen Sie die Einstellung für die Java-Laufzeit oder die JRE-Systembibliothek des Projekts, ersetzen Sie die bisherige Laufzeitauswahl und übernehmen Sie die Änderung mit den Steuerelementen Ihrer Eclipse-Version. Fehlt die gewünschte Laufzeit in der Auswahl, registrieren Sie zuerst ihre lokale Installation.

Prüfen Sie nach dem Übernehmen der Änderung die Laufzeiteinstellung des Projekts und vergewissern Sie sich, dass dort die gewünschte Installation angegeben ist. Sie können das Projekt auch ausführen und die von der Anwendung gemeldete Java-Version prüfen. Für eine einfache Prüfung innerhalb des Projekts gibt das folgende vollständige Java-Programm die Laufzeitversion der JVM aus, von der es ausgeführt wird. Beim dokumentierten Lauf dieses Beispiels gab das Programm 17.0.20.1 aus. Dieser Wert bezeichnet die bei diesem Lauf verwendete JVM; Ihre Ausgabe hängt von der für Ihr Projekt ausgewählten JVM ab.

Führen Sie dieses Beispiel aus:

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

17.0.20.1

Ein erfolgreicher Start bestätigt, welche JVM das Programm ausgeführt hat. Er sagt jedoch nichts über die Quellcode- oder Kompatibilitätsstufe des Compilers aus. Weicht die gemeldete Laufzeit von der gewünschten Version ab, prüfen Sie erneut die Laufzeitauswahl des Projekts und kontrollieren Sie, welche Startkonfiguration beziehungsweise welches Projekt ausgeführt wird. Prüfen Sie für eine vollständige Umstellung zusätzlich die Compiler-Kompatibilität und vergewissern Sie sich, dass die benötigten Bibliotheken und Build-Werkzeuge die ausgewählte Java-Version unterstützen.