Gentoo Java Anleitung

1.  Was ist Java?

Überblick

Java ist eine Programmiersprache, die von den Ingenieuren von Sun Microsystems entwickelt wurde. Die Sprache ist objektorientert und dafür entwickelt worden auf mehreren Plattformen ausführbar zu sein, ohne dass Code erneut kompiliert werden muss. Auch wenn Java als ein natives Programm kompiliert werden kann, verdankt es einen großen Teil seiner Beliebheit, neben anderen Funktionen wie Garbage-Collection, der Portabilität. Um die Plattformunabhängigkeit zu erreichen übersetzt der Java-Compiler den Java-Quelltext in ein Zwischenprodukt, den "Java-Bytecode". Dieser Bytecode wird dann von der JRE (Java Runtime Environment) ausgeführt, also nicht vom Betriebssystem direkt.

Um Java-Bytecode ausführen zu können, muss man eine JRE (Java Runtime Environment) installiert haben. Eine JRE liefert unter anderem die Kernbibliotheken, eine plattformabhängige virtuelle Maschine und Plugins für Browser. Ein JDK (Java Development Kit) fügt Programmiertools, wie z.B. einen Bytecode Compiler und einen Debugger hinzu.

2.  Bevor Sie anfangen

Bestehende Installation

Für bestehende Installationen, egal was Sie an Java vorher installiert hatten, folgen Sie bitte dem Java Upgrade Guide.

Neue Installation

Neue Installationen sollten keine weiteren Vorbereitungen benötigen.

3.  Installation einer Virtual Machine

Die Auswahlmöglichkeiten

Gentoo stellt eine Vielzahl von Laufzeitumgebungen (JREs) und Entwicklungsbaukästen (JDKs) bereit. Unter den momentanen Alternativen gibt es:

Installation einer/s JRE/JDK

Um das in Ihrem Profil definierte Standard-JDK zu installieren, reicht ein emerge virtual/jdk. Oder für die Standard-JRE des Profils: emerge virtual/jre.

Kürzlich hat Sun sein JDK und JRE unter eine andere Lizenz gestellt, die freundlicher für Linux-Distributionen ist. Dadurch kann Suns Java ab Version 1.5 ohne weiteres Getue installiert werden.

Installation von nicht frei ladbaren VMs

Einige JDKs und JREs verlangen zusätzliche Anstrengungen bevor man sie installieren kann. Nutzen Sie einfach emerge um diese Pakete wie gewohnt zu installieren. Die Ebuilds werden Ihnen dann mitteilen, wo und was Sie herunterladen müssen.

Sie müssen die notwendigen Dateien in das Verzeichnis /usr/portage/distfiles herunterladen. Sobald dies erledigt ist, müssen Sie erneut den emerge-Befehl ausführen, damit das JRE/JDK installiert wird.

4.  Konfiguration der Virtual Machine

Überblick

Gentoo Linux bietet die Möglichkeit verschiedene JDKs und JREs parallel zu installieren, ohne dass sie Konflikte verursachen.

Mit Hilfe von java-config können sie als root die systemweiten Java-Vorgaben festlegen. Außerdem hat jeder Nutzer die Möglichkeit durch java-config seine eigenen Vorgaben einzustellen.

Eine Standard Virtual Machine festlegen

Durch den Befehl java-config --list-available-vms wird eine Liste aller auf Ihrem System verfügbaren JREs und JDKs ausgegeben. Hier ist ein Beispiel einer solchen Ausgabe:

# java-config --list-available-vms
The following VMs are available for generation-2:
1)      IcedTea6-bin 1.4.1 [icedtea6-bin]
2)      Sun JDK 1.5.0.20 [sun-jdk-1.5] (Nur bauen)
*)      Sun JDK 1.6.0.16 [sun-jdk-1.6]

Das * zeigt die momentan aktive VM an (System-VM oder User-VM, wenn gesetzt). Der Text in eckigen Klammern [] ist der Name oder die ID für die jeweilige VM. Sie müssen diese Angaben (Name oder Nummer) mit java-config --set-system-vm wie folgt verwenden, um zum Beispiel die VM des Systems zu setzen:

(Über den Namen (die bessere Methode))
# java-config --set-system-vm sun-jdk-1.6
Now using sun-jdk-1.6 as your generation-2 system JVM
(Über die Nummer)
# java-config --set-system-vm 3
Now using sun-jdk-1.6 as your generation-2 system JVM

Als einfacher Benutzer können Sie java-config --set-user-vm ausführen.

Nur bauen-VM

Einige virtuelle Maschinen sind als Nur bauen gekennzeichnet, da sie Sicherheitsverwundbarkeiten enthalten und/oder das Ende ihres Lebenszyklus erreicht haben. Diese virtuellen Maschinen werden von Gentoo nicht automatisch zum Ausführen von Anwendungen via Gentoo-Launchers verwendet, aber sind weiterhin für Gentoos Bauumgebung verfügbar, da einige Pakete sie zum Bauen benötigen. Wir raten dringend davon ab, diese VMs als virtuelle Maschinen für Ihr System oder für Ihren Benutzer zu setzen, da sie ansonsten auch für das Ausführen der Dateien /usr/bin/{java,javac,...} verwendet würden und daher auch von Paketen genutzt würden, die nicht Gentoos Launcher-Skripte verwenden.

Bevorzugte VM

Während der Installation von Java-Paketen kann und wird die VM je nach Notwendigkeit umgeschaltet.

Aufgrund der Vielzahl der zur Verfügung stehenden VMs haben wir nicht die Ressourcen jedes Paket mit jeder VM zu testen und zu verifizieren. Um dennoch sicherzustellen, dass jedes Paket sauber installiert werden kann, haben wir eine Liste von standardmäßigen/unterstützten VMs je Architektur definiert. Sie finden diese Liste in /usr/share/java-config-2/config/jdk-defaults.conf. Wenn Sie also ein Java-Paket installieren und dieses feststellt, dass eine der VMs aus dieser Datei installiert ist, dann wird automatisch diese VM anstatt der System-VM verwendet.

Das Umschalten der VM zum Installationszeitpunkt wird auch dann benötigt, wenn Ihre System-VM zum Beispiel auf eine 1.4 VM eingestellt ist, die Installation aber eine 1.5 VM benötigt. Während des Mergens wird dann die bevorzugte 1.5 VM verwendet, die Einstellung der System-VM bleibt intakt.

Gentoo wäre nicht Gentoo wenn man diese Vorgabeeinstellungen nicht ändern könnte. Über die Datei /etc/java-config-2/build/jdk.conf haben Sie die volle Kontrolle darüber, welche VM verwendet wird. Einige Beispiele:

(Es soll immer ein sun-jdk verwendet werden, also sun-jdk-1.4 für 1.4,
sun-jdk-1.5 für 1.5 usw.)
*=sun-jdk

(Verwende wann immer möglich sun-jdk-1.5, außer wenn eine 1.4 oder 1.3
VM explizit verlangt wird)
*=sun-jdk-1.5

# Für 1.3 bevorzuge ich sun-jdk 1.4, aber wenn diese nicht vorhanden ist, benutze ibm-jdk-bin,
# Für 1.5 verwende sun-jdk
1.3=sun-jdk-1.4 ibm-jdk-bin
1.5=sun-jdk

5.  Compiler

Der Standard Java-Compiler zum Erstellen der Anwendungen ist javac, welcher in jedem JDK enthalten ist. Zusätzlich zu der Konfigurationsmöglichkeit, welche VM verwendet werden soll, kann man auch den Compiler festlegen. Im Wesentlichen legt man einfach eine Liste der bevorzugten Einstellungen in der Datei /etc/java-config-2/build/compilers.conf an.

# Falls das ebuild es unterstützt
# wird die Variable COMPILERS von vorne nach hinten durchgegangen
# und der erste Compiler, der installiert ist, verwendet

COMPILERS="ecj-X.Y jikes javac"

Nicht alle Compiler unterstützen alle möglichen -target und -source Argumente. Daher wird jeder Compiler in der Liste überprüft, ob er das gewünschte -source/-target unterstützt. Javac wird in jedem Fall funktionieren, daher wird dieser verwendet, falls kein anderer passender Compiler gefunden wird.

Nachfolgend einige weitere Informationen zu den Compilern:

6.  Einen Vorgabe-CLASSPATH einrichten

Einen systemweiten als auch einen Benutzer-spezifischen CLASSPATH kann man auch mit java-config setzen.

Zunächst sollten Sie sich alle vorhandenen Java-Bibliotheken, die auf Ihrem System installiert sind und die man in den CLASSPATH aufnehmen könnte, anzeigen lassen. Hier ist ein Beispiel der Ausgabe:

# java-config --list-available-packages
[xerces-2] The next generation of high performance, fully compliant XML parsers in the Apache Xerces family (/usr/share/xerces-2/package.env)
[junit] Simple framework to write repeatable tests (/usr/share/junit/package.env)
[bsh] BeanShell: A small embeddable Java source interpreter (/usr/share/bsh/package.env)
[bcel] The Byte Code Engineering Library: analyze, create, manipulate Java class files (/usr/share/bcel/package.env)
[log4j] A low-overhead robust logging package for Java (/usr/share/log4j/package.env)
...

Auch hier sind die Namen in eckigen Klammer ([]) die IDs, die man dem Befehl java-config --set-system-classpath übergeben muss. Hier ist ein Beispiel:

# java-config --set-system-classpath log4j,xerces-2

Sie müssen Ihre Umgebung aktualisieren, indem Sie sich aus- und wieder einloggen oder indem Sie /etc/profile sourcen.

Für Anwender richtet der Befehl java-config --set-user-classpath die Datei ~/.gentoo/java-env-classpath ein, die dann vom Shellprofil geladen werden sollte.

if [[ -f "${HOME}/.gentoo/java-env-classpath" ]]; then
    source ${HOME}/.gentoo/java-env-classpath
fi

Falls Sie wirklich einen systemweiten Classpath oder eine Vorgabe für alle Anwender einrichten wollen, dann können Sie so etwas wie das folgende Beispiel zum Shellprofil hinzufügen. Aber wie gesagt, wir raten davon ab.

# export CLASSPATH="${CLASSPATH}:$(java-config --classpath log4j,xerces-2)"

7.  Java Browser Plugins

Ein Plugin installieren

Sie können ein Java-Plugin für Ihren Browser installieren, indem Sie eine Java-VM emergen, wobei das nsplugin Use-Flag gesetzt ist.

Portage erlaubt es mehrere Versionen von Java-Plugins zu installieren, allerdings wird nur eines davon von Ihrem Browser verwendet. Sie können die Liste aller zur Verfügung stehenden Plugins mit dem folgenden Befehl überprüfen:

# eselect java-nsplugin list
  [1]   sun-jre-bin-1.6
  [2]   icedtea6-bin

Im folgenden Beispiel wird sun-jre-bin als Browser-Plugin ausgewählt.

# eselect java-nsplugin set sun-jre-bin-1.6

Überprüfen Sie, dass das richtige Plugin ausgewählt wurde.

# eselect java-nsplugin list
  [1]   sun-jre-bin-1.6  current
  [2]   icedtea6-bin

Auf java.com wird ein Link angeboten, um das installierte Plugin herauszufinden. Darüberhinaus können Sie mit einem Mozilla-basierenden Browser über die Eingabe von about:plugins in der Adresszeile die installierten Plugins überprüfen.

Plugins auf Multilib-Systemen

Falls Sie eine gemischte 64-Bit- und 32-Bit-Multilib-Umgebung verwenden (zum Beispiel auf einem AMD64) können Sie sowohl 64-Bit- als auch 32-Bit-Java-Plugins verwenden. Sofern Sie nicht unbedingt 32-Bit-Java-Anwendungen starten müssen, empfehlen wir Ihnen, 64-Bit-Plugins in 64-Bit-Webbrowsern zu verwenden.

Es sind einige native 64-Bit-Browser-Plugins verfügbar. Das standardmäßige JDK/JRE-Paar, sun-jdk und sun-jre-bin, beinhaltet Browser-Plugins. Installieren Sie einfach eines dieser mit aktiviertem nsplugin USE-Flag.

# echo "dev-java/sun-jre-bin nsplugin" >> /etc/portage/package.use
# emerge sun-jre-bin

Um ein 32-Bit-Plugin in einem 32-Bit-Browser zu verwenden, müssen Sie emul-linux-x86-java mit aktiviertem nsplugin USE-Flag emergen.

# echo "app-emulation/emul-linux-x86-java nsplugin" >> /etc/portage/package.use
# emerge emul-linux-x86-java

Überprüfen Sie als nächstes welche Plugins zur Verfügung stehen:

# eselect java-nsplugin list
Available 32-bit Java browser plugins
  [1]   emul-linux-x86-java-1.5
  [2]   emul-linux-x86-java-1.6
Available 64-bit Java browser plugins
  [1]   icedtea6-bin
  [2]   sun-jre-bin-1.6

Wählen Sie nun das richtige Plugin für Ihre Browser:

(Wählen Sie die Plugins für 32-Bit- und 64-Bit-Browser)
# eselect java-nsplugin set 32bit emul-linux-x86-java-1.6
# eselect java-nsplugin set 64bit sun-jre-bin-1.6

Überprüfen Sie, ob das richtige Plugin ausgewählt wurde:

# eselect java-nsplugin list
Available 32-bit Java browser plugins
  [1]   emul-linux-x86-java-1.5
  [2]   emul-linux-x86-java-1.6  current
Available 64-bit Java browser plugins
  [1]   icedtea6-bin
  [2]   sun-jre-bin-1.6  current

8.  USE-Flags in Verwendung mit Java

USE-Flags setzen

Für weitere Informationen zu USE-Flags, lesen Sie bitte das USE-Flags Kapitel des Gentoo Handbuchs.

Die Flags

• Das Flag java fügt Java-Unterstützung zu einer Vielzahl von Programmen hinzu.
• Das Flag nsplugin aktiviert die Unterstützung für Mozilla-basierende Browser (inklusive Firefox). Sie benötigen dieses Flag, um Java-Applets in Ihrem Mozilla-basierenden Browser auszuführen.
• Das Flag source bewirkt, dass eine Zip-Datei des Quellcodes eines Paketes installiert wird. Dies wird üblicherweise von IDEs verwendet, um den Quellcode an eine verwendete Bibliothek anzuhängen.
• Das Flag jce fügt Unterstützung für die Java Cryptography Engine hinzu.
• Das Flag doc bewirkt, dass für Javapakete mit Hilfe von javadoc eine API-Dokumentation installiert wird.

9.  Weiterführende Quellen

Offline-Quellen

• java-config man page
• java-config --help

Online-Quellen

• Die Gentoo Java Projektseite
• Die gentoo-java, gentoo-user und gentoo-dev Mailinglisten-Archive
• #gentoo und #gentoo-java im IRC
• Wikipedias Eintrag zu Java
• Falls Sie Vorschläge oder Fragen bezüglich dieses Dokumentes haben, schreiben Sie bitte eine Email an das Gentoo Java Team: java@gentoo.org

Die Inhalte dieses Dokuments sind, sofern nicht explizit anders genannt, unter der Creative Commons - Namensnennung / Weitergabe Lizenz lizenziert. Die Gentoo Name and Logo Usage Guidelines treffen zu.