Eclipse-Laufzeitoptionen
Version 3.2 - Letzte Überarbeitung: 8. Mai 2006
Die Eclipse-Plattform ist äußerst konfigurierbar. Die Konfigurationseingaben haben das Format von Befehlszeilenargumenten und Einstellungen für Systemeigenschaften. In vielen Fällen sind die Befehlszeilenargumente einfach Direktaufrufe für das Einrichten der entsprechenden Systemeigenschaften. In der Tat gibt es weit mehr Einstellungen für Systemeigenschaften als Befehlszeilenargumente.
Befehlszeilenargumente
Nachstehend werden die Befehlszeilenargumente aufgeführt, die von verschiedenen Teilen der Eclipse-Laufzeit verarbeitet werden. Viele dieser Werte können auch mithilfe der Systemeigenschaften entweder über die Befehlszeile mit VM-Argumenten "-D" angegeben werden, indem ihre Werte in einer Datei "config.ini" angegeben werden, bzw. durch Einsatz einer Datei <launcher>.ini.
Mit den beiden letzteren Techniken ist es möglich, Eclipse ganz ohne die Verwendung von Befehlszeilenargumenten anzupassen.
Für jedes Argument in der Liste wird der entsprechende Systemeigenschaftsschlüssel (in {}) angegeben. Auch die Eclipse-Laufzeitebene ist angegeben, in der das Befehlszeilenargument (in ()) bearbeitet wird. Dies ist für Benutzer nützlich, die Teile der Laufzeit ersetzen, um sie speziellen Anforderungen anzupassen.
- -application <id> (Laufzeit)
- Entspricht der Einstellung eclipse.application
auf <ID>
- -arch <Architektur> (OSGi)
- Entspricht der Einstellung von osgi.arch auf <Architektur>
- -clean (OSGi)
- entspricht der Einstellung von osgi.clean auf "true"
- -configuration <Position> (Main)
- Entspricht der Einstellung von osgi.configuration.area
auf <Position>
- -console [port] (OSGi)
- Entspricht der Einstellung von osgi.console auf [Port]
oder der leeren Zeichenfolge, wenn der Standardport verwendet wird (d. h. wenn der Port nicht angegeben ist).
- -consoleLog (Laufzeit)
- Entspricht der Einstellung eclipse.consoleLog auf
"true"
- -data < Position> (OSGi)
- Entspricht der Einstellung von osgi.instance.area
auf <Position>
- -debug [Optionsdatei] (OSGi)
- Entspricht der Einstellung von osgi.debug auf [Optionsdatei] oder der leeren Zeichenfolge, um auf einfache Weise einen Debug zu aktivieren (d.h., falls die Position der Optionsdatei nicht angegeben ist).
- -dev [Einträge] (OSGi)
- Entspricht der Einstellung von osgi.dev auf [Einträge] oder der leeren Zeichenfolge, um einfach den dev-Modus zu aktivieren (d. h., falls keine Einträge angegeben sind)
- -endSplash <Befehl> (Main)
- Gibt den Befehl an, der für das Schließen der Eingangsanzeige verwendet werden soll. Wird normalerweise von der ausführbaren Eclipse-Datei bereitgestellt.
- -feature <Feature-ID> (Laufzeit)
- Entspricht der Einstellung von eclipse.product
auf <Feature-ID>
- -framework <location> (Main)
- Entspricht der Einstellung von osgi.framework auf
<Position>
- -initialize (Main)
- Initialisiert die ausgeführte Konfiguration. Alle laufzeitbezogenen Datenstrukturen und Caches werden aktualisiert. Benutzer- oder plug-in-definierte Konfigurationsdaten werden nicht freigegeben. Es wird keine Anwendung ausgeführt, Produktspezifikationen werden ignoriert und es wird keine Benutzerschnittstelle dargestellt (z. B. die Eingangsanzeige wird nicht dargestellt).
- -install <Position> (Main)
- Entspricht der Einstellung von osgi.install.area auf
<Position>
- -keyring <Position> (Laufzeit)
- Die Position der Berechtigungsdatenbank auf der Festplatte. Dieses Argument muss zusammen mit dem Argument "-password" verwendet werden.
- -name <string> NEU
- Der Name, der in einer Taskleiste angezeigt wird, wenn die Anwendung gestartet wird. Wird nichts angegeben, so ist der Name der Name der ausführbaren Datei.
- -nl <Ländereinstellung> (OSGi)
- Entspricht der Einstellung von osgi.nl auf <Ländereinstellung>
- -noExit (OSGi)
- Entspricht der Einstellung von osgi.noShutdown auf "true"
- -noLazyRegistryCacheLoading (Laufzeit)
- Entspricht der Einstellung von eclipse.noLazyRegistryCacheLoading
auf "true"
- -noRegistryCache
(Laufzeit)
- Entspricht der Einstellung von eclipse.noRegistryCache
auf "true"
- -noSplash (ausführbar, Main)
- Steuert, ob die Eingangsanzeige angezeigt wird oder nicht.
- -os <Betriebssystem> (OSGi)
- Entspricht der Einstellung von osgi.os auf <Betriebssystem>
- -password <Kennwort> (Laufzeit)
- Das Kennwort für die Berechtigungsdatenbank
- -pluginCustomization <Position> (Laufzeit)
- Entspricht der Einstellung von eclipse.pluginCustomization auf
<Position>
- -product <id> (OSGi)
- Entspricht der Einstellung von eclipse.product auf
<ID>
- -showSplash <Befehl> (Main)
- Gibt den Befehl an, der zur Anzeige der Eingangsanzeige verwendet wird. Wird normalerweise von der ausführbaren Eclipse-Datei bereitgestellt.
- -startup <Position> (Ausführbare Datei) NEU
- Die Position der JAR-Datei wird verwendet, um Eclipse zu starten. Für die JAR-Datei, auf die verwiesen wird, muss das Attribut "Main-Class" festgelegt sein.
Ist dieser Parameter nicht angegeben, wird die Datei "startup.jar" verwendet, die sich im gleichen Ordner befindet wie die ausführbare Datei.
- -user <Position> (OSGi)
- Entspricht der Einstellung von osgi.user.area auf <Position>
- -vm <Pfad zur ausführbaren JAR> (ausführbar, Main)
- Bei der Weitergabe an die ausführbare Eclipse-Datei wird diese Option verwendet, um die Java-VM zu finden, die für die Ausführung von Eclipse verwendet wird. Es muss sich um den vollständigen Dateisystempfad für eine geeignete ausführbare Java-Datei handeln. Falls er nicht angegeben ist, verwendet die ausführbare Eclipse-Datei einen Suchalgorithmus für die Suche nach einer geeigneten VM. In jedem Fall gibt die ausführbare Datei anschließend den Pfad an die tatsächlich von Java Main verwendete VM mithilfe des Arguments "-vm" weiter. Java
Main speichert anschließend diesen Wert in der Datei eclipse.vm.
- -vmargs [vmargs*] (ausführbar,
Main)
- Bei der Weitergabe an Eclipse wird diese Option verwendet, um die Operation der Java VM für die Ausführung von Eclipse anzupassen. Wenn sie angegeben ist, muss diese Option am Ende der Befehlszeile stehen. Selbst wenn sie in der ausführbaren Befehlszeile nicht angegeben ist, fügt die ausführbare Datei automatisch die entsprechenden Argumente (einschließlich der gestarteten Klasse) mithilfe des -vmargs-Arguments der an Java weitergegebenen Befehlszeile hinzu.
Java Main speichert diesen Wert anschließend in eclipse.vmargs.
- -ws <Fenstertechniken> (OSGi)
- Entspricht der Einstellung von osgi.ws auf <Fenstertechniken>
Veraltete Befehlszeilenargumente
Die folgenden Befehlszeilenargumente sind nicht mehr relevant, wurden ersetzt oder werden von der Laufzeit verbraucht und nicht an die Anwendung weitergegeben, die für das Erhalten der Abwärtskompatibilität ausgeführt wird.
- -booten
- siehe -configuration
- -classLoaderProperties
- nicht mehr relevant
- -firstUse
- nicht mehr relevant
- -newUpdates
- nicht mehr relevant
- -noPackagePrefixes
- nicht mehr relevant
- -noUpdate
- nicht mehr relevant
- -plugins
- nicht mehr relevant
- -update
- nicht mehr relevant
Andere
Die folgenden Befehlszeilenargumente werden von verschiedenen Eclipse-Plug-ins definiert und nur unterstützt, wenn das definierende Plug-in installiert, aufgelöst und aktiviert ist.
- -noVersionCheck (Workbench)
- <description>
- -perspective (Workbench)
- <description>
- -refresh (org.eclipse.core.resources)
- <description>
- -showLocation (org.eclipse.ui.ide.workbench)
- <description>
- -allowDeadlock
- <description>
Systemeigenschaften
Die folgenden Systemeigenschaften werden von der Eclipse-Laufzeit verwendet. Beachten Sie, dass diejenigen, die mit "osgi" beginnen, für die OSGi-Gerüstimplementierung spezifisch sind, während diejenigen, die mit "eclipse" beginnen, für die Eclipse-Laufzeit, die sich auf dem OSGi-Gerüst befindet, typisch sind.
Viele dieser Eigenschaften haben Befehlszeilenäquivalente (siehe Abschnitt Befehlszeilenargumente und den Wert in Klammern{}). Die Benutzer können entweder Befehlszeilen- oder Eigenschafteneinstellungen für die Angabe eines Wertes verwenden. Die Eigenschaften können auf eine der folgenden Weisen eingerichtet werden:
- Verwenden Sie -DpropName=propValue als ein VM-Argument für die Java VM.
- Richten Sie die gewünschte Eigenschaft in der Datei "config.ini" in dem entsprechenden Konfigurationsbereich ein.
- eclipse.activateRuntimePlugins
- Diese Eigenschaft steuert die Aktivierung von Laufzeit-Plug-ins. Bei RPC-Anwendungen, für die keine Services von Laufzeit-Plug-ins bereitgestellt werden müssen, kann diese Eigenschaft
auf "false" gesetzt werden, um die Aktivierung von Laufzeit-Plug-ins beim Eclipse-Start zu verhindern.
- eclipse.application {-Anwendung}
- Die Kennung der auszuführenden Anwendung. Der hier angegebene Wert überschreibt jede von dem ausgeführten Produkt definierte Anwendung (siehe eclipse.product).
- eclipse.commands
- Eine durch neue Zeilen getrennte Liste aller Befehlszeilenargumente, die beim Start von Eclipse übergeben werden.
- eclipse.consoleLog
- Bei "true" wird auch jede Protokollausgabe an die Java-Datei System.out gesendet (typischerweise zurück zur Befehlsshell, falls vorhanden). Praktisch in der Kombination mit "-debug".
- eclipse.debug.startupTime
- Die Zeit in Millisekunden, als die Java-VM für diese Sitzung gestartet wurde.
- eclipse.ee.install.verify
- Wenn diese Eigenschaft den Wert "true" hat, überprüft das Gerüst die erforderliche Ausführungsumgebung während der Installation des Pakets. Der Standardwert ist "false".
- eclipse.log.backup.max
- Die maximal zulässige Anzahl von Sicherungsprotokolldateien. Aufgrund der Rotierung der Protokolldatei wird die älteste Sicherungsprotokolldatei gelöscht, nachdem die maximale Anzahl an Sicherungsprotokolldateien erreicht wurde.
Der Standardwert ist "10". Ein negativer Wert oder Null führen dazu, dass der Standardwert verwendet wird.
- eclipse.log.size.max
- Die maximal zulässige Größe, die die Protokolldatei betragen darf. Die Protokolldatei wird rotiert, wenn die Größe die Maximalgröße überschreitet. Der Standardwert ist "1000".
Ein negativer Wert führt dazu, dass der Standardwert verwendet wird. Ein Wert von Null bedeutet, dass es keine maximale Protokollgröße gibt.
- eclipse.noExtensionMunging
- Bei "true" wird die veraltete Registrierungserweiterung nicht verändert. Standardmäßig werden diese Erweiterungen aktualisiert, sodass sie auf die neuen in Eclipse 3.0 zu findenden Erweiterungspunkt-IDs verweisen.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- Bei "true" wird die Ladeoptimierung des Plug-in-Registrierungscaches der Plattform deaktiviert. Standardmäßig werden die Konfigurationselemente aus dem Registrierungscache (wenn verfügbar) nur bei Bedarf geladen, sodass der Speicherbedarf reduziert wird. Diese Option erzwingt das vollständige Laden des Registrierungscaches beim Starten.
- eclipse.noRegistryCache {-noRegistryCache}
- Bei "true" wird der interne Erweiterungsregistrierungscache weder gelesen noch beschrieben.
- eclipse.pluginCustomization {-pluginCustomization}
- Die Dateisystemposition einer Eigenschaftendatei, die die Standardeinstellungen für die Benutzervorgaben eines Plug-ins enthält. Diese Standardeinstellungen überschreiben die im Hauptfeature angegebenen Standardeinstellungen. Relative Pfade werden relativ gegenüber dem aktuellen Arbeitsverzeichnis für Eclipse interpretiert.
- eclipse.product {-Produkt}
- Die Kennung des aufgeführten Produkts. Diese steuert verschiedene Brandinginformationen und welche Anwendung verwendet wird.
- eclipse.service.jobs
- Diese Eigenschaft steuert die Registrierung von OSGi-Services. Wenn sie auf "false" gesetzt ist, wird die Registrierung von OSGi-Services
durch das Plug-in
org.eclipse.core.jobs
unterdrückt.
- eclipse.service.pref
- Diese Eigenschaft steuert die Registrierung von OSGi-Services. Wenn sie auf "false" gesetzt ist, wird die Registrierung von OSGi-Services
durch das Plug-in
org.eclipse.equinox.preferences
unterdrückt.
- eclipse.startTime
- Diese Eigenschaft wird zum Zeitpunkt des Starts von Eclipse eingestellt. Der Wert dieser Eigenschaft ist eine Zeichenfolgedarstellung des Wert, der von System.currentTimeMillis() zurückgegeben wird. Es ist nicht vorgesehen, dass dieser Wert von Benutzern eingestellt wird.
- eclipse.stateSaveDelayInterval
- Diese Eigenschaft gibt das Verzögerungsintervall (in Millisekunden) für die permanente Speicherung von Statusänderungen an. Der Standardwert ist 30.000 Millisekunden (= 30 Sekunden). Anforderungen von Statusänderungen werden verzögert, damit während der Ausführung von Verwaltungsoperationen (z. B. der Installation von Paketen) keine massiven Schreibvorgänge auf dem Datenträger stattfinden.
Das Verzögerungsintervall wird als Inaktivitätszeitraum verwendet, der abgewartet werden muss, bevor die Statusinformationen für das Gerüst als permanent gelten.
- eclipse.vm {-vm}
- Der Pfad der ausführbaren Java-Datei, die für die Ausführung von Eclipse verwendet wird. Diese Information wird für die Erstellung von erneut startenden Befehlszeilen verwendet.
- eclipse.vmargs {-vmargs}
- Listet die VM-Argumente auf, die für die Ausführung von Eclipse verwendet werden. Diese Information wird für die Erstellung von erneut startenden Befehlszeilen verwendet.
- osgi.adaptor
- Der Klassenname des zu verwendenden OSGi-Gerüstadapters.
- osgi.arch {-arch}
- Siehe -arch.
- osgi.baseConfiguration.area
- gibt eine Basiskonfiguration an, die verwendet wird, wenn
osgi.configuration.area nicht angegeben ist.
- osgi.bundlefile.limit
- Diese Eigenschaft gibt einen Grenzwert für die Anzahl der JAR-Dateien an, die das Gerüst geöffnet hält.
Der zulässige Mindestwert ist 10. In der Standardeinstellung ist dieser Wert unbegrenzt.
- osgi.bundles
- Die mit Kommas getrennte Liste der Produktpakete, die automatisch installiert und optional gestartet werden, sobald das System aktiviert und ausgeführt wird. Jeder Eintrag hat das folgende Format:
<URL | simple bundle location>[@ [<start-level>] [":start"]]
Falls die Startebene (>0 ganze Zahl) ausgelassen wird, verwendet das Gerüst die Standardstartebene für das Produktpaket. Falls der Tag "Start" hinzugefügt wird, wird das Produktpaket nach der Installation als gestartet gekennzeichnet.
Einfache Produktpaketpositionen werden als relativ gegenüber dem übergeordneten Verzeichnis des Gerüsts interpretiert.
Die Startebene zeigt die OSGi-Startebene an, auf der das Produktpaket ausgeführt werden soll. Falls dieser Wert nicht eingerichtet ist, berechnet das System einen geeigneten Standardwert.
- osgi.bundles.defaultStartLevel
- Dies ist die Ausgangsebene für alle Pakete, die von der Eclipse-Aktualisierungsfunktion installiert werden.
Pakete, die in der
Liste osgi.bundles angegeben sind, können eine bestimmte Ausgangsebene festlegen.
Falls sie keine Ausgangsebene festlegen, wird standardmäßig der Wert von "osgi.bundles.defaultStartLevel" verwendet. Der Standardwert für "osgi.bundles.defaultStartLevel" ist 4.
- osgi.clean
- Bei Einstellung auf "true", werden vom OSGi-Gerüst und der Eclipse-Laufzeit verwendete, zwischengespeicherte Daten ausgeblendet. Dadurch werden die Cachespeicher bereinigt, in denen die Auflösungsdaten der Produktpaketabhängigkeit und die Registrierungsdaten der Eclipse-Erweiterung gespeichert sind. Durch die Verwendung dieser Option wird Eclipse gezwungen, diese Cachespeicher zu reinitialisieren.
- osgi.configuration.cascaded
- Bei der Einstellung auf "true" wird diese Konfiguration überlappend zu einer übergeordneten Konfiguration angeordnet. Die übergeordnete Konfiguration wird durch osgi.sharedConfiguration.area angegeben.
Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.configuration.area {-Konfiguration}
- Die Konfigurationsposition für diese Ausführung der Plattform. Die Konfiguration legt fest, welche Plug-ins ausgeführt werden, und definiert verschiedene weitere Systemeinstellungen.
Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.configuration.area.default
- Die Standardkonfigurationsposition für diese Ausführung der Plattform. Die Konfiguration legt fest, welche Plug-ins ausgeführt werden, und definiert verschiedene weitere Systemeinstellungen.
Dieser Wert (d.h. die Standardeinstellung) wird nur verwendet, wenn kein Wert für osgi.configuration.area
eingerichtet ist. Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.console {-Konsole}
- Bei Einstellung eines anderen Werts als Null ist die OSGi-Konsole (wenn sie installiert ist) aktiviert.
Falls es sich bei dem Wert um eine passende ganze Zahl handelt, wird dieser als der Port interpretiert, an dem die Konsole empfangsbereit ist, und die Ausgabe wird an diesen Port übertragen. Praktisch für die Prüfung des Zustands des Systems.
- osgi.console.class
- Der Klassenname der bei Anforderung auszuführenden Konsole.
- osgi.console.encoding
- Wenn diese Option festgelegt ist, wird der angegebene Wert als Codierung für die Konsole verwendet
(siehe osgi.console). Ist sie nicht angegeben, wird der Wert der Eigenschaft "file.encoding" verwendet. Falls die Eigenschaft "file.encoding" nicht definiert ist, wird als Standardwert "iso8859-1" verwendet.
- osgi.contextClassLoaderParent
- Der Typ des Klassenladeprogramms, das als übergeordnetes Klassenladeprogramm für das vom Gerüst verwendete Klassenladeprogramm für den Kontext verwendet werden soll. Folgende Typen sind gültig:
- app: Das Klassenladeprogramm der Anwendung.
- boot: Das Boot-Klassenladeprogramm.
- ext: Das Klassenladeprogramm der Erweiterung.
- fwk: Das Klassenladeprogramm des Gerüsts.
- ccl: Das ursprüngliche Klassenladeprogramm für den Kontext, das beim Starten des Gerüsts festgelegt war (Standardwert).
- osgi.debug {-Debug}
- Bei Einrichtung eines anderen Werts als Null befindet sich die Plattform im Debug-Modus. Wenn es sich bei dem Wert um eine Zeichenfolge handelt, wird diese als die Position der Datei .options interpretiert. Diese Datei gibt an, welche Debug-Punkte für ein Plug-in verfügbar sind und ob sie aktiviert sind. Falls keine Position angegeben ist, sucht die Plattform die Datei .options im Installationsverzeichnis.
- osgi.dev {-dev}
- Bei Einstellung einer leeren Zeichenfolge ist der dev-Modus einfach aktiviert. Diese Eigenschaft kann auch als durch Kommas getrennte Klassenpfadeinträge eingerichtet werden, die dem Klassenpfad jedes Plug-ins oder der URL einer Java-Eigenschaftendatei, die angepasste Klassenpfadergänzungen für eine Reihe von Plug-ins enthält, hinzugefügt werden. Für jedes Plug-in, das einen angepassten dev-Zeitklassenpfad benötigt, enthält die Datei einen Eintrag im folgenden Format:
<Plug-in-ID>=<hinzuzufügende, durch Kommas getrennte Liste von Klassenpfadeinträgen>
wobei die Plug-in-ID "*" jedes nicht anderweitig erwähnte Plug-in abgleicht.
- osgi.filepermissions.command
- Gibt einen optionalen betriebssystemspezifischen Befehl für das Festlegen von Dateiberechtigungen für den extrahierten nativen Code an. Bei manchen Betriebssystemen müssen native Bibliotheken als ausführbar festgelegt werden. Mit dieser optionalen Eigenschaft können Sie den Befehl angeben.
Bei einem Betriebssystem mit UNIX-Darstellung könnte beispielsweise der folgende Wert verwendet werden:
osgi.filepermissions.command="chmod +rx [fullpath]"
Mit dem Wert für [fullpath] wird der tatsächliche Dateipfad durch das Gerüst ersetzt.
- osgi.framework
- Die URL-Position des OSGi-Gerüsts. Nützlich, wenn die Eclipse-Installation separat ist. Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.frameworkClassPath
- Eine durch Kommas getrennte Liste von Klassenpfadeinträgen für die OSGi-Gerüstimplementierung.
Relative Positionen werden als relativ gegenüber der Gerüstposition interpretiert
(siehe osgi.framework)
- osgi.framework.extensions
- Eine durch Kommata getrennte Liste von Gerüsterweiterungen. Jeder Eintrag hat das folgende Format:
<einfache Produktpaketposition>
Einfache Produktpaketpositionen werden im übergeordneten Verzeichnis des
Pakets "org.eclipse.osgi" gesucht. Gerüsterweiterungen können verwendet werden, um Eclipse mit einem verschiedenen Gerüstadapter auszuführen. Die Gerüsterweiterung kann eine Datei "eclipse.properties" enthalten, über die Systemeigenschaften eingestellt werden. Eine Gerüsterweiterung, die eine Gerüstadapterimplementierung bereitstellt, kann durch Angabe der Eigenschaft osgi.adaptor beispielsweise angeben, Adapterklasse verwendet werden soll.
- osgi.framework.shape
- Auf die Form der Eclipse OSGi-Gerüstimplementierung eingestellt. Diese Eigenschaft wird beim Start der Eclipse-Plattform eingestellt und ist nicht dafür vorgesehen, vom Benutzer eingestellt zu werden. Der Wert
"jar" gibt an, dass das Eclipse OSGi-Gerüst in einer einzigen JAR-Datei enthalten ist.
Der Wert
"folder" gibt an, dass das Eclipse OSGi-Gerüst in einem einzigen Ordner enthalten ist.
- osgi.framework.library.extensions
- Eine durch Kommata gegliederte Liste von zusätzlichen Bibliotheksdateierweiterungen, nach denen gesucht werden soll. Wenn diese Eigenschaft nicht festgelegt ist, wird nur der Bibliotheksname für die Suche verwendet, der von der Methode
"System.mapLibraryName(String)" zurückgegeben wird. Diese Eigenschaft wird für bestimmte Betriebssysteme benötigt, bei denen mehrere Erweiterungen für Bibliotheksnamen zulässig sind.
Bei AIX sind beispielsweise die Erweiterungen ".a" und ".so" für Bibliotheksnamen zulässig, aber die Methode
"System.mapLibraryName(String)" gibt nur Namen mit der Erweiterung ".a" zurück.
- osgi.framework.useSystemProperties
- Diese Eigenschaft steuert, ob die Gerüsteigenschaften durch die globalen Systemeigenschaften gesichert oder für jedes Exemplar des Gerüsts privat bereitgehalten werden. In der Standardeinstellung werden die Gerüsteigenschaften durch die Systemeigenschaften gesichert ("true"). Diese Eigenschaft ist hilfreich, wenn mehrere Exemplare des OSGi-Gerüsts in derselben VM ausgeführt werden und für jedes Exemplar eine eigene Gruppe von Konfigurationseigenschaften vorhanden ist (z. B. in der Datei "config.ini" definiert).
- osgi.genericAliases
- Eine durch Kommata gegliederte Liste mit generischen Aliasnamen, mit denen vorhandene Manifestheader zu den Manifestheadern "Eclipse-GenericCapability" und "Eclipse-GenericRequire" zugeordnet werden können. Die Eigenschaft
"osgi.genericAliases" verwendet die folgende Syntax:
osgi.genericAliases ::= generic-alias ( ',' generic-alias ) *
generic-alias ::= capability-alias ':' require-alias ':' capability-type
Um beispielsweise die OSGi-Header "Export-Service" und "Import-Service" zu den Headern
"Eclipse-GenericCapability" und "Eclipse-GenericRequire" zuzuordnen, würden Sie die folgenden Werte verwenden:
osgi.genericAliases=Export-Service:Import-Service:osgi.service
- osgi.hook.configurators
- Eine durch Kommata gegliederte Liste von Hook-Konfigurationsprogrammen. Falls diese Eigenschaft festgelegt ist, werden nur die Konfigurationsprogramme verwendet, die in der Liste enthalten sind. Alle Hook-Konfigurationsprogramme, die in
Dateien "hookconfigurators.properties" definiert sind, werden ignoriert.
- osgi.hook.configurators.include
- Eine durch Kommata gegliederte Liste von zusätzlichen Hook-Konfigurationsprogrammen. Dies ist hilfreich, wenn optionale Hook-Konfigurationsprogramme konfiguriert werden müssen. Wenn die Option
osgi.hook.configurators verwendet wird, wird diese Option ignoriert.
- osgi.hook.configurators.exclude
- Eine durch Kommata gegliederte Liste von auszuschließenden Hook-Konfigurationsprogrammen. Dies ist hilfreich, wenn Hook-Konfigurationsprogramme inaktiviert werden müssen, die
in Eigenschaftendateien für Hook-Konfigurationsprogramme angegeben sind. Wenn die Option
osgi.hook.configurators verwendet wird, wird diese Option ignoriert.
- osgi.java.profile
- Eine URL, die auf die zu verwendende JRE-Profildatei verweist. Die angegebene URL wird als Java-Eigenschaftendatei gelesen. Ein JRE-Profil enthält Werte für die Eigenschaften "org.osgi.framework.system.packages",
"org.osgi.framework.bootdelegation" und "org.osgi.framework.executionenvironment". Wenn
"osgi.java.profile" nicht eingestellt ist, so wird ein Profil auf Basis des Werts von
"java.specification.version" der laufenden JRE ausgewählt.
- osgi.java.profile.bootdelegation
-
Ein Java-Profil osgi.java.profile kann eine Eigenschaft
"org.osgi.framework.bootdelegation" enthalten. Dieser Wert kann verwendet werden, um die Systemeigenschaft "org.osgi.framework.bootdelegation" einzustellen. "osgi.java.profile.bootdelegation"
gibt die Richtlinie für die zu verwendende "bootdelegation" an. Die folgenden Werte sind gültig (Standardeinstellung ist "ignore"):
- ignore: Gibt an, dass der Wert"org.osgi.framework.bootdelegation" im Java-Profil ignoriert werden soll.
Die Systemeigenschaft "org.osgi.framework.bootdelegation" wird dann verwendet, um zu bestimmen, welche Pakete an "boot" delegiert werden sollen.
- override: gibt an, dass "org.osgi.framework.bootdelegation" im Java-Profil die Systemeigenschaft "org.osgi.framework.bootdelegation" überschreiben soll.
- none: gibt an, dass "org.osgi.framework.bootdelegation" im Java-Profil UND die Systemeigenschaften ignoriert werden sollen. Dies ist die strengste Option.
Eine Ausführung mit dieser Option führt dazu, dass das Gerüst das Delegationsmodell "OSGi R4 strict boot" verwendet.
- osgi.install.area {-Installation}
- Die Installationsposition der Plattform. Diese Einstellung zeigt die Position des Eclipse Basis-Plug-ins an und ist nützlich, wenn die Eclipse-Installation separat ist.
Weitere Details finden Sie im Abschnitt über Positionen.
- osgi.instance.area {-Daten}
- Die Position der Exemplardaten für diese Sitzung. Die Plug-ins verwenden diese Position zum Speichern ihrer Daten. Beispielsweise verwendet das Ressourcen-Plug-in diese als die Standardposition für Projekte (aka des Arbeitsbereichs). Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.instance.area.default
- Die Standardposition für die Exemplardaten für diese Sitzung. Die Plug-ins verwenden diese Position zum Speichern ihrer Daten. Beispielsweise verwendet das Ressourcen-Plug-in diese als die Standardposition für Projekte (aka des Arbeitsbereichs). Dieser Wert (d.h. die Standardeinstellung) wird nur verwendet, wenn kein Wert für osgi.instance.area
eingerichtet ist. Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.locking
- Der Sperrtyp, der für diese Ausführung der Plattform verwendet werden soll. Die gültigen Sperrtypen sind
"java.io", "java.nio" und "none". Der Standardwert ist
"java.nio" sofern die JRE nicht "java.nio" unterstützt, in welchem Fall der Standardwert "java.io"
ist.
- osgi.manifest.cache
- Die Position, an der erstellte Manifeste festgestellt und generiert werden. Standardmäßig ist dies der Konfigurationsbereich, doch der Manifestcache kann separat gespeichert werden.
- osgi.nl {-nl}
- Der Name der Ländereinstellung, auf der die Eclipse-Plattform ausgeführt wird. NL-Werte sollten den Standardnamenskonventionen für Java-Ländereinstellungen folgen.
- osgi.nl.user
- Der Name der Ländereinstellung, wenn der Benutzer explizit das Argument "-nl" zu den Befehlszeilenargumenten hinzufügt.
- osgi.noShutdown {-noExit}
- Wenn dieser Wert auf "true" eingestellt ist, wird die VM nicht beendet, nachdem die Eclipse-Anwendung beendet ist. Dies ist hilfreich, wenn das OSGi-Gerüst untersucht werden soll, nachdem die Eclipse-Anwendung beendet wurde.
- osgi.os {-os}
- Der Wert des Betriebssystems. Der Wert sollte aus einem der Namen der Eclipse-Prozessorarchitektur bestehen, die Eclipse bekannt sind (z. B. x86, sparc, ...).
- osgi.parentClassloader
- Der Typ des Klassenladeprogramms, das als übergeordnetes Klassenladeprogramm für alle im Gerüst installierten Produktpakete verwendet werden soll. Folgende Typen sind gültig:
- app: Das Klassenladeprogramm der Anwendung.
- boot: Das Boot-Klassenladeprogramm.
- ext: Das Klassenladeprogramm der Erweiterung.
- fwk: Das Klassenladeprogramm des Gerüsts.
- osgi.requiredJavaVersion
- Die minimale für den Start von Eclipse erforderliche Java-Version. Der Standardwert ist "1.4.1".
- osgi.resolverMode
- Der zur Auflösung der im Gerüst installierten Produktpakete verwendete Modus. Ein Wert
"strict" versetzt den Auflöser in den strengen Modus. Der Standardauflösemodus ist nicht streng. Wenn der Auflöser im strengen Modus läuft, setzt das Gerüst beim Laden von Klassen und Ressourcen aus exportierten Paketen Zugriffsbeschränkungsregeln um, die die Steueranweisungen "x-internal" oder "x-friends" angeben.
- osgi.sharedConfiguration.area
- Die gemeinsam genutzte Konfigurationsposition für diese Ausführung der Plattform. Wenn die Eigenschaft
osgi.configuration.cascaded auf "true" eingestellt ist, wird der gemeinsam genutzte Konfigurationsbereich als übergeordnete Konfiguration verwendet.
- osgi.splashLocation
- Die absolute URL-Position der Eingangsanzeige (.bmp-Datei), die angezeigt wird, während Eclipse startet. Diese Eigenschaft überschreibt jeden Wert, der in osgi.splashPath eingerichtet ist.
- osgi.splashPath
- Eine durch Kommas getrennte Liste von URLs zur Suche nach einer Datei mit dem Namen splash.bmp.
Diese Eigenschaft wird von jedem Wert überschrieben, der in osgi.splashLocation eingerichtet ist.
- osgi.startLevel
- Der Wert für die Ausgangsebene, der für das Gerüst beim Start festgelegt wird. Der Standardwert ist 6.
- osgi.support.signature.verify
- Gültige Werte sind "true" und "false"; der Standardwert lautet "false".
Bei Verwendung des
Wertes "true" lädt das Gerüst Zertifikate aus signierten JAR-Dateien und prüft während der Laufzeit, ob der Inhalt beschädigt ist oder nicht.
- osgi.syspath
- Auf den Pfad zur Implementierung des Eclipse-OSGi-Gerüsts (org.eclipse.osgi) eingestellt. Beispielsweise "<eclipse_installationspfad>/eclipse/plugins".
Diese Eigenschaft wird beim Start der Eclipse-Plattform eingestellt und ist nicht dafür vorgesehen, vom Benutzer eingestellt zu werden.
- osgi.user.area {-Benutzer}
- Die Position des Benutzerbereichs. Der Benutzerbereich enthält Daten (z. B. Benutzervorgaben), die für den OS-Benutzer spezifisch und unabhängig von einer Eclipse-Installation, -Konfiguration oder einem Exemplar sind. Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.user.area.default
- Die Standardposition des Benutzerbereichs. Der Benutzerbereich enthält Daten (z. B. Benutzervorgaben), die für den OS-Benutzer spezifisch und unabhängig von einer Eclipse-Installation, -Konfiguration oder einem Exemplar sind. Dieser Wert (d.h. die Standardeinstellung) wird nur verwendet, wenn kein Wert für osgi.user.area
eingerichtet ist. Weitere Informationen finden Sie im Abschnitt Positionen.
- osgi.ws {-ws}
- Der Wert der Fenstertechniken. Der Wert sollte aus einem der Namen der Eclipse-Fenstertechniken bestehen, die Eclipse bekannt sind (z. B. win32, motif, ...).
Positionen
Die Eclipse-Laufzeit definiert eine Reihe von Positionen, die Plug-in-Entwicklern einen Kontext für das Lesen/Speichern von Daten und Eclipse-Benutzern eine Kontrolle über den Umfang der gemeinsamen Nutzung von Daten und die Sichtbarkeit bieten. Eclipse definiert die folgenden Positionskonzepte:
- Benutzer (-benutzer) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir,
filepath, url]
- Benutzerpositionen sind nach der Abbildung spezifisch für Benutzer. Typischerweise basiert die Benutzerposition auf dem Wert der Java-Systemeigenschaft
user.home
, doch kann dies überschrieben werden. Informationen, wie z. B. der Umfang der Benutzervorgaben eines Benutzers und Anmeldeinformationen, finden sich möglicherweise in der Benutzerposition.
- Installation (-installation) {osgi.install.area} [@user.home, @user.dir, filepath,
url]
- Eine Installationsposition ist die Position, an der Eclipse selbst installiert ist. In der Praxis ist diese Position das Verzeichnis (normalerweise "eclipse"), das der ausgeführten Datei startup.jar oder eclipse.exe übergeordnet ist. Für diese Position sollten die normalen Benutzer nur Lesezugriff haben, da eine Installation von vielen Benutzern gemeinsam genutzt werden kann. Es ist möglich, die Installationsposition einzurichten und die Datei startup.jar vom übrigen Teil von Eclipse zu trennen.
- Konfiguration (-konfiguration) {osgi.configuration.area} [@none, @noDefault,
@user.home, @user.dir, filepath, url]
- Die Konfigurationspositionen enthalten Dateien, die die gesamte oder einen Teil der auszuführenden Installation identifizieren und verwalten. Daher können mehrere Konfigurationen je Installation vorhanden sein.
Installationen enthalten möglicherweise einen Standardkonfigurationsbereich, bei typischen Startszenarien versucht die Laufzeit allerdings, eine besser beschreibbare Konfigurationsposition zu finden.
- Exemplar (-Daten) {osgi.instance.area} [@none, @noDefault, @user.home,
@user.dir, filepath, url]
- Exemplarpositionen enthalten benutzerdefinierte Datenartefakte. Das Ressourcen-Plug-in verwendet beispielsweise den Exemplarbereich als die Arbeitsbereichposition und daher als Standardausgangsposition für Projekte. Andere Plug-ins können beschreiben, wenn sich von ihnen bevorzugte Dateien in dieser Position befinden.
Während die Benutzer jede dieser Positionen einrichten können, berechnet Eclipse angemessene Standardwerte, wenn keine Werte angegeben sind. Der häufigste Anwendungsfall für das Einrichten von Positionen ist der Exemplarbereich oder im IDE-Kontext der Arbeitsbereich. Um die Eclipse-Standardkonfiguration auf einer bestimmten Datenreihe auszuführen, können Sie Folgendes angeben:
eclipse -daten c:\mydata
Weitere Informationen
Positionen sind URLs. Zur Vereinfachung werden auch Dateipfade akzeptiert und automatisch in eine Datei umgewandelt: URLs. Für eine bessere Kontrolle und zur Vereinfachung gibt es auch einige vordefinierte symbolische Positionen, die Sie verwenden können. Beachten Sie, dass nicht alle Kombinationen aus Positionstyp und symbolischem Wert gültig sind. In der nachstehenden Tabelle sind Informationen enthalten, welche Kombinationen möglich sind. Da der Standardwert für alle einzurichtenden Positionen gültig und beschreibbar ist, schlagen einige Plug-ins in anderen Konfigurationen möglicherweise fehl, selbst wenn sie in der Liste als möglich aufgeführt sind. Beispielsweise ist nicht davon auszugehen, dass ein Plug-in, das auf Benutzerdaten fokussiert ist (z. B. das Eclipse Ressourcen-Plug-in) funktioniert, wenn der Exemplarbereich nicht definiert ist. Die Plug-in-Entwickler müssen die Konfigurationen wählen, die sie unterstützen, und ihre Funktion entsprechend konzipieren.
- @none
- Gibt an, dass die entsprechende Position nie entweder explizit oder als Standardwert eingerichtet werden sollte. Beispielsweise kann eine RCP-Darstellungsanwendung, die keine Benutzerdaten enthält, osgi.instance.area=@none verwenden, um zu verhindern, dass externe Daten die Festplatte beschreiben. An @none dürfen sich keine weiteren Pfadsegmente anschließen.
- @noDefault
- Erzwingt, dass eine Position nicht definiert oder explizit definiert ist (d. h. Eclipse berechnet nicht automatisch einen Standardwert). Dies ist nützlich, wenn Sie Daten in der entsprechenden Position zulassen möchten, der Eclipse-Standardwert jedoch nicht angemessen ist. An @noDefault dürfen sich keine weiteren Pfadsegmente anschließen.
- @user.home
- Weist Eclipse an, einen Positionswert relativ zum Ausgangsverzeichnis des Benutzers zu berechnen. An @user.home können sich zusätzliche Pfadsegmente anschließen. In allen Fällen wird die Zeichenfolge "@user.home" einfach durch den Wert der Systemeigenschaft "user.home" ersetzt. Beispielsweise führt die Einrichtung von
osgi.instance.area=@user.home/myWorkspace
zu einem Wert von
file:/users/bob/myWorkspace.
- @user.dir
- Weist Eclipse an, einen Positionswert relativ zum aktuellen Arbeitsverzeichnis zu berechnen. An @user.dir können sich zusätzliche Pfadsegmente anschließen. In allen Fällen wird die Zeichenfolge "@user.dir" einfach durch den Wert der Java-Systemeigenschaft "user.dir" ersetzt. Beispielsweise führt die Einrichtung von
osgi.instance.area=@user.dir/myWorkspace
zu einem Wert von
file:/usr/share/eclipse/myWorkspace.
Position/Wert |
Unterstützung des Standardwerts |
Datei/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
Exemplar
|
Ja |
Ja
|
Ja
|
Ja
|
Ja
|
Ja (Standard)
|
Konfiguration
|
Ja
|
Ja
|
Ja*
|
Ja*
|
Ja
|
Ja
|
Installation
|
Nein
|
Ja
|
Nein
|
Nein
|
Ja
|
Ja
|
Benutzer
|
Ja
|
Ja
|
Ja
|
Ja
|
Ja
|
Ja
|
* Weist darauf hin, dass diese Konfiguration technisch möglich, in der Praxis jedoch schwer zu verwalten ist. Insbesondere kann die Eclipse-Laufzeit ohne eine Konfigurationsposition nur das OSGi-Gerüst starten.
Schreibgeschützte Positionen
Eine Position kann als schreibgeschützte Position angegeben werden, indem ".readOnly"
an die Positionseigenschaft angehängt wird und der Wert auf "true" gesetzt wird. Die folgenden Eigenschaften können verwendet werden, um die jeweiligen Positionen als schreibgeschützt anzugeben:
Datei "Launcher.ini"
Die Datei "eclipse.exe" und allgemeinere ausführbare Dateien für RCP-Anwendungen können ihre Parameter jetzt aus einer zugeordneten INI-Datei lesen. Diese Datei bietet eine plattformunabhängige Möglichkeit, Argumente zu übergeben, die zuvor direkt in der Befehlszeile mit Argumenten wie z.B. vm oder vm angegeben werden mussten. Obwohl alle Parameter in dieser Datei angegeben werden können, wird aus Gründen der Wartungsfreundlichkeit und Konsistenz über verschiedene Installationen hinweg empfohlen, nur die VM-Position und die VM-Argumente in dieser INI-Datei anzugeben und die Datei "config.ini" für andere zu verwenden.
Dateiformat
Diese Datei muss nach der ausführbaren Datei benannt werden (für "eclipse.exe" heißt sie "eclipse.ini", während sie für "launcher.exe" "launcher.ini" heißt) und jeder Parameter muss in einer neuen Zeile der Datei angegeben werden. Im Folgenden ist ein Beispiel einer solchen Datei dargestellt, in der die VM-Position und einige Parameter angegeben sind:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M