Eclipse-Laufzeitoptionen
Version 3.1 - Letzte Überarbeitung am 15. Juni 2005
Die Eclipse-Plattform ist äußerst konfigurierbar. Die Konfigurationseingaben haben das Format von Befehlszeilenargumenten und Systemmerkmalseinstellungen. In vielen Fällen sind die Befehlszeilenargumente einfach Direktaufrufe für das Einrichten der entsprechenden Systemmerkmale. In der Tat gibt es weit mehr Systemmerkmaleinstellungen 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 Systemmerkmale entweder über die Befehlszeile mit -D VM-Argumenten 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 Systemmerkmalsschlü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"
- -Konfiguration <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"
- -Daten < 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>
- -initialisieren (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).
- -installieren <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 -Kennwortargument 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>
- -Kennwort <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 <location> (Executable) NEU
- Die Position der Jar-Datei wird verwendet, um Eclipse zu starten. Für die Jar-Datei, auf die verwiesen wird, muss das Hauptklassenattribut eingestellt sein.
Ist dieser Parameter nicht eingestellt, so wird die Datei 'startup.jar' verwendet, die sich im gleichen Ordner befindet wie die ausführbare Datei.
- -user <location> (OSGi)
- Entspricht der Einstellung von osgi.user.area auf <Position>
- -vm <path to java executable> (ausführbar, Main)
- Bei der Weitergabe an die ausführbare Eclipse-Datei wird diese Option verwendet, um das Java VM zu finden, das 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 zum Finden 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 -vm-Arguments 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 -Konfiguration
- -classLoaderProperties
- nicht mehr relevant
- -firstUse
- nicht mehr relevant
- -newUpdates
- nicht mehr relevant
- -noPackagePrefixes
- nicht mehr relevant
- -noUpdate
- nicht mehr relevant
- -Plug-ins
- 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)
- <Beschreibung>
- -Perspective (Workbench)
- <Beschreibung>
- -refresh (org.eclipse.core.resources)
- <Beschreibung>
- -showLocation (org.eclipse.ui.ide.workbench)
- <Beschreibung>
- -allowDeadlock
- <Beschreibung>
Systemmerkmale
Die folgenden Systemmerkmale werden von der Eclipse-Laufzeit verwendet. Beachten Sie, dass diejenigen, die mit "osgi" starten für die OSGi-Gerüstimplementierung spezifisch sind, während diejenigen, die mit "eclipse" starten, für die Eclipse-Laufzeit, die sich auf dem OSGi-Gerüst befindet, typisch sind.
Viele dieser Merkmale haben Befehlszeilenäquivalente (siehe Abschnitt Befehlszeilenargumente und den Wert in Klammern{}). Die Benutzer können entweder die Befehlszeile oder die Merkmalseinstellungen für die Angabe eines Wertes verwenden. Die Merkmale können auf eine der folgenden Weisen eingerichtet werden:
- Verwenden Sie -DpropName=propValue als ein VM-Argument für die Java VM.
- Richten Sie das gewünschte Merkmal in der config.ini-Datei in dem entsprechenden Konfigurationsbereich ein.
- 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, wenn die Java VM für diese Sitzung gestartet wurde.
- eclipse.exitcode
- <Beschreibung>
- eclipse.exitdata
- <Beschreibung>
- eclipse.log.backup.max
- die maximal zugelassene 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 Merkmalsdatei, 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.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.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}
- see -arch
- osgi.baseConfiguration.area
- gibt eine Basiskonfiguration an, die verwendet wird, wenn
osgi.configuration.area nicht angegeben ist.
- 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.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.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. Dieses Merkmal kann auch als durch Kommas getrennte Klassenpfadeinträge eingerichtet werden, die dem Klassenpfad jedes Plug-ins oder der URL einer Java-Merkmalsdatei, 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.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:
<URL | einfache Produktpaketposition>
Wenn eine Produktpaketposition angegeben ist (und keine URL,) so wird eine Suche im übergeordneten Verzeichnis des Produktpakets org.eclipse.osgi durchgeführt. 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.java.profile
- Eine URL, die auf die zu verwendende JRE-Profildatei verweist. Ein JRE-Profil enthält Wert für die Eigenschaften
'org.osgi.framework.system.packages' und 'org.osgi.framework.bootdelegation'. 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 Informationen finden Sie im Abschnitt 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.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. Dieses Merkmal ü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.
Dieses Merkmal wird von jedem Wert überschrieben, der in osgi.splashLocation eingerichtet ist.
- 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 des Java-Systemmerkmals
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 des Java-Systemmerkmals "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 des Java-Systemmerkmals "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
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 diese 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