Opcje środowiska wykonawczego platformy Eclipse
Wersja 3.1 - ostatnia aktualizacja: 15 czerwca 2005
Platformę Eclipse można konfigurować w bardzo szerokim zakresie. Dane wejściowe konfiguracji są wprowadzane w postaci argumentów wiersza komend i ustawień właściwości systemowych. W wielu przypadkach argumenty wiersza komend pełnią rolę skrótów umożliwiających ustawianie odpowiednich właściwości systemowych. Jednak w rzeczywistości właściwości systemowych jest znacznie więcej niż dostępnych argumentów wiersza komend.
Argumenty wiersza komend
Poniżej przedstawiono argumenty wiersza komend przetwarzane przez różne części środowiska wykonawczego platformy Eclipse. Wiele z tych wartości można także określić za pomocą właściwości systemowych. W tym celu należy w wierszu komend użyć argumentu -D maszyny VM, określić odpowiednie wartości w pliku config.ini lub użyć pliku <launcher>.ini. Użycie dwóch ostatnich metod pozwala konfigurować platformę Eclipse bez konieczności używania argumentów wiersza komend.
Dla każdego argumentu uwzględnionego na liście podano odpowiadający mu klucz właściwości systemowej (w nawiasach klamrowych). Podano także warstwę środowiska wykonawczego platformy Eclipse, w której dany argument wiersza komend jest przetwarzany (w nawiasach okrągłych). Informacja ta jest użyteczna w przypadku osób, które zastępują części środowiska wykonawczego platformy Eclipse w celu dopasowania jej do specjalnych wymagań.
- -application <id> (środowisko wykonawcze)
- Równoważne ustawieniu właściwości eclipse.application
na wartość <id>.
- -arch <architektura> (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.arch na wartość <architektura>.
- -clean (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.clean na wartość "true".
- -configuration <położenie> (metoda Main)
- Równoważne ustawieniu właściwości osgi.configuration.area
na wartość <położenie>.
- -console [port] (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.console na wartość [port]
lub na łańcuch pusty, jeśli ma być używany port domyślny (tzn. jeśli nie określono numeru portu).
- -consoleLog (środowisko wykonawcze)
- Równoważne ustawieniu właściwości eclipse.consoleLog
na wartość "true".
- -data <położenie> (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.instance.area
na wartość <położenie>.
- -debug [plik opcji] (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.debug na wartość [plik opcji] lub na łańcuch pusty, jeśli po prostu ma zostać włączone debugowanie (tzn. jeśli nie określono położenia pliku opcji).
- -dev [wpisy] (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.dev na wartość [wpisy] lub na łańcuch pusty, jeśli po prostu ma zostać włączony tryb programowania (tzn. jeśli nie określono wpisów).
- -endSplash <komenda> (metoda Main)
- Określa komendę, która ma być używana do wyłączania ekranu startowego. Zazwyczaj jest ona dostępna w pliku wykonywalnym platformy Eclipse.
- -feature <id składnika> (środowisko wykonawcze)
- Równoważne ustawieniu właściwości eclipse.product
na wartość <id składnika>.
- -framework <położenie> (metoda Main)
- Równoważne ustawieniu właściwości osgi.framework na wartość <położenie>.
- -initialize (metoda Main)
- Inicjuje uruchamianą konfigurację. W takim przypadku są odświeżane wszystkie struktury danych i pamięci podręczne powiązane ze środowiskiem wykonawczym. Nie są usuwane żadne dane konfiguracyjne zdefiniowane przez użytkownika/moduł dodatkowy. Nie jest uruchamiana żadna aplikacja, wszystkie specyfikacje produktów są ignorowane i nie jest wyświetlany interfejs użytkownika (np. nie jest prezentowany ekran startowy).
- -install <położenie> (metoda Main)
- Równoważne ustawieniu właściwości osgi.install.area na wartość <położenie>.
- -keyring <położenie> (środowisko wykonawcze)
- Położenie bazy danych autoryzacji na dysku. Tego argumentu należy używać w połączeniu z argumentem -password.
- -name <łańcuch> NOWE
- Nazwa wyświetlana w elemencie paska zadań w czasie uruchamiania aplikacji. Jeśli nazwa nie zostanie ustawiona, będzie to nazwa pliku wykonywalnego.
- -nl <ustawienia narodowe> (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.nl na wartość <ustawienia narodowe>.
- -noExit (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.noShutdown na wartość "true".
- -noLazyRegistryCacheLoading (środowisko wykonawcze)
- Równoważne ustawieniu właściwości eclipse.noLazyRegistryCacheLoading
na wartość "true".
- -noRegistryCache (środowisko wykonawcze)
- Równoważne ustawieniu właściwości eclipse.noRegistryCache
na wartość "true".
- -noSplash (plik wykonywalny, metoda Main)
- Decyduje o tym, czy jest wyświetlany ekran startowy.
- -os <system operacyjny> (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.os na wartość <system operacyjny>.
- -password <hasło> (środowisko wykonawcze)
- Hasło do bazy danych autoryzacji.
- -pluginCustomization <położenie> (środowisko wykonawcze)
- Równoważne ustawieniu właściwości eclipse.pluginCustomization na wartość <położenie>.
- -product <identyfikator> (środowisko OSGi)
- Równoważne ustawieniu właściwości eclipse.product na wartość <id>.
- -showSplash <komenda> (metoda Main)
- Określa komendę, która ma być używana do wyświetlania ekranu startowego. Zazwyczaj jest ona dostępna w pliku wykonywalnym platformy Eclipse.
- -startup <położenie> (plik wykonywalny) NOWE
- Położenie pliku JAR używanego do uruchamiania platformy Eclipse. Przywoływany plik JAR musi mieć ustawiony atrybut Main-Class.
Jeśli parametr ten nie jest ustawiony, użyty zostanie plik startup.jar znajdujący się w tym samym folderze co plik wykonywalny.
- -user <położenie> (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.user.area
na wartość <położenie>.
- -vm <ścieżka do pliku wykonywalnego Java> (plik wykonywalny, metoda Main)
- Ta opcja, po przekazaniu jej do pliku wykonywalnego platformy Eclipse, pozwala znaleźć maszynę VM Java, która jest potrzeba do uruchomienia platformy Eclipse. Musi to być pełna ścieżka systemu plików do odpowiedniego pliku wykonywalnego Java. Jeśli nie określono tej opcji, plik wykonywalny platformy Eclipse używa algorytmu wyszukiwania w celu znalezienia odpowiedniej maszyny VM. Potem plik wykonywalny przekazuje tę ścieżkę do metody Java Main przy użyciu argumentu -vm. Metoda Java Main zapisuje przekazaną wartość w pliku eclipse.vm.
- -vmargs [vmargs*] (plik wykonywalny, metoda Main)
- Ta opcja, po przekazaniu jej do platformy Eclipse, jest używana do dostosowywania maszyny VM Java, która ma być stosowana przy uruchamianiu platformy Eclipse. Jeśli określono tę opcję, musi ona znajdować się na końcu wiersza komend. Nawet jeśli ta opcja nie będzie określona w wierszu komend pliku wykonywalnego, odpowiednie argumenty zostaną automatycznie dodane (z uwzględnieniem uruchamianej klasy) do wiersza komend, który jest przekazywany do metody Java Main przy użyciu argumentu -vmargs. Metoda Java Main zapisuje przekazaną wartość w pliku eclipse.vmargs.
- -ws <system okienkowy> (środowisko OSGi)
- Równoważne ustawieniu właściwości osgi.ws na wartość <system okienkowy>.
Przestarzałe argumenty wiersza komend
Poniższe argumenty wiersza komend nie są już stosowane albo zostały zastąpione, w związku z czym środowisko wykonawcze przyjmuje je, ale nie przekazuje ich do uruchamianej aplikacji (pozwala to zachować kompatybilność wsteczną).
- -boot
- Patrz: -configuration.
- -classLoaderProperties
- Już nie jest stosowany.
- -firstUse
- Już nie jest stosowany.
- -newUpdates
- Już nie jest stosowany.
- -noPackagePrefixes
- Już nie jest stosowany.
- -noUpdate
- Już nie jest stosowany.
- -plugins
- Już nie jest stosowany.
- -update
- Już nie jest stosowany.
Inne
Poniższe argumenty wiersza komend są definiowane przez różne moduły dodatkowe platformy Eclipse i są obsługiwane tylko wtedy, gdy zainstalowano, rozpoznano i aktywowano odpowiedni moduł dodatkowy.
- -noVersionCheck (środowisko robocze)
- <description>
- -perspective (środowisko robocze)
- <description>
- -refresh (org.eclipse.core.resources)
- <description>
- -showLocation (org.eclipse.ui.ide.workbench)
- <description>
- -allowDeadlock
- <description>
Właściwości systemowe
Poniższe właściwości systemowe są używane przez środowisko wykonawcze platformy Eclipse. Należy pamiętać o tym, że właściwości o nazwach zaczynających się od "osgi" są specyficzne dla implementacji środowiska OSGi, natomiast właściwości o nazwach zaczynających się od "eclipse" są specyficzne dla środowiska wykonawczego platformy Eclipse działającego w oparciu o środowisko OSGi.
Wiele z tych właściwości ma odpowiedniki w postaci argumentów wiersza komend (patrz sekcja Argumenty wiersza komend i wartości w nawiasach klamrowych). Użytkownik może ustawić takie wartości przy użyciu wiersza komend lub ustawień właściwości. Właściwości można ustawiać przy użyciu następujących sposobów:
- Użycie argumentu -DpropName=propValue w wywołaniu maszyny VM Java.
- Ustawienie żądanej właściwości w pliku config.ini w odpowiednim obszarze konfiguracji.
- eclipse.application {-application}
- Identyfikator aplikacji do uruchomienia. Podana tu wartość ma wyższy priorytet niż aplikacja zdefiniowana przez uruchamiany produkt (patrz eclipse.product).
- eclipse.commands
- Lista rozdzielonych znakami nowego wiersza wszystkich argumentów wiersza komend przekazywanych w czasie uruchamiania platformy Eclipse.
- eclipse.consoleLog
- Wartość "true" oznacza, że dane wyjściowe protokołu są wysyłane także do strumienia wyjściowego System.out środowiska Java (zwykle z powrotem do powłoki komend, jeśli działa taka powłoka). Ta opcja jest użyteczna w połączeniu z argumentem -debug.
- eclipse.debug.startupTime
- Czas uruchomienia maszyny VM Java w ramach danej sesji (w milisekundach).
- eclipse.exitcode
- <description>
- eclipse.exitdata
- <description>
- eclipse.log.backup.max
- Maksymalna liczba plików kopii zapasowej protokołu. Najstarszy plik kopii zapasowej protokołu zostanie
usunięty po osiągnięciu maksymalnej liczby plików kopii zapasowej protokołu w wyniku rotacji pliku protokołu.
Wartość domyślna to "10". Wartość ujemna lub zerowa powoduje użycie wartości domyślnej.
- eclipse.log.size.max
- Maksymalna wielkość (w kB), do jakiej może urosnąć plik protokołu. Kiedy wielkość pliku przekracza
maksymalną wielkość, następuje rotacja pliku protokołu. Wartość domyślna to "1000".
Wartość ujemna powoduje użycie wartości domyślnej. Wartość zerowa oznacza brak limitu wielkości protokołu.
- eclipse.noExtensionMunging
- Wartość "true" oznacza, że wcześniejsze rozszerzenia rejestru są pozostawiane bez zmian. Domyślnie te rozszerzenia są aktualizowane tak, aby były używane nowe identyfikatory punktów rozszerzeń znalezione w ramach platformy Eclipse 3.0.
- eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
- Wartość "true" oznacza, że jest dezaktywowana optymalizacja ładowania pamięci podręcznej rejestru modułów dodatkowych platformy. Domyślnie elementy konfiguracji są ładowane z pamięci podręcznej rejestru (jeśli jest ona dostępna) tylko na żądanie, co zmniejsza ilość zajmowanej pamięci. Ta opcja wymusza pełne ładowanie pamięci podręcznej rejestru przy uruchamianiu.
- eclipse.noRegistryCache {-noRegistryCache}
- Wartość "true" oznacza, że wewnętrzna pamięć podręczna rejestru rozszerzeń nie jest odczytywana ani zapisywana.
- eclipse.pluginCustomization {-pluginCustomization}
- Położenie w systemie plików pliku właściwości zawierającego domyślne ustawienia preferencji modułów dodatkowych. Te ustawienia zastępują ustawienia domyślne określone w składniku podstawowym. Ścieżki względne są interpretowane względem bieżącego katalogu roboczego platformy Eclipse.
- eclipse.product {-product}
- Identyfikator uruchamianego produktu. Od tego ustawienia zależą różne informacje o oznakowaniu marką oraz to, jaka aplikacja jest używana.
- eclipse.startTime
- Ta właściwość jest ustawiana w momencie uruchomienia platformy Eclipse. Wartość tej właściwości to
łańcuchowa reprezentacja wartości zwróconej przez metodę System.currentTimeMillis(). Wartość ta nie
powinna być ustawiana przez użytkowników.
- eclipse.vm {-vm}
- Ścieżka do pliku wykonywalnego Java służącego do uruchamiania platformy Eclipse. Ta informacja jest używana do budowania wierszy komend ponownego uruchamiania.
- eclipse.vmargs {-vmargs}
- Lista argumentów maszyny VM służącej do uruchamiania platformy Eclipse. Ta informacja jest używana do budowania wierszy komend ponownego uruchamiania.
- osgi.adaptor
- Nazwa klasy adaptera środowiska OSGi.
- osgi.arch {-arch}
- Patrz -arch.
- osgi.baseConfiguration.area
- Określa konfigurację podstawową, która jest używana w przypadku, gdy nie określono
właściwości osgi.configuration.area.
- osgi.bundles
- Lista rozdzielonych przecinkami pakunków, które są automatycznie instalowane i opcjonalnie uruchamiane, gdy system jest już zainstalowany i skonfigurowany. Każda pozycja listy ma następującą formę:
<URL | Położenie prostego pakunku>[@ [<Poziom uruchamiania>] [":start"]]
Jeśli parametr Poziom uruchamiania (liczba całkowita > 0) zostanie pominięty, środowisko użyje domyślnego poziomu uruchamiania dla pakunku. Jeśli dodano znacznik "start", oznacza to, że pakunek będzie uruchamiany po zainstalowaniu. Położenia prostych pakunków są interpretowane jako położenia określone względem katalogu macierzystego środowiska. Parametr Poziom uruchamiania wskazuje poziom środowiska OSGi, na którym pakunek ma być uruchamiany. Jeśli nie ustawiono tej wartości, odpowiednie ustawienie domyślne jest określane automatycznie.
- osgi.clean
- Wartość "true" oznacza, że zostaną usunięte wszystkie dane przechowywane w pamięci podręcznej środowiska OSGi i środowiska wykonawczego platformy Eclipse. Spowoduje to wyczyszczenie pamięci podręcznych używanych do przechowywania danych związanych z rozstrzyganiem zależności pakunków i z rejestrem rozszerzeń platformy Eclipse. Użycie tej opcji wymusza reinicjowanie tych pamięci podręcznych.
- osgi.configuration.cascaded
- Wartość "true" oznacza, że ta konfiguracja jest przekazywana do konfiguracji nadrzędnej. Konfiguracja nadrzędna jest określona przez właściwość osgi.sharedConfiguration.area. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.configuration.area {-configuration}
- Położenie konfiguracji używanej przy tym uruchomieniu platformy. Konfiguracja ta określa, które moduły dodatkowe zostaną uruchomione, oraz różne inne ustawienia systemowe.
Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.configuration.area.default
- Domyślne położenie konfiguracji używanej przy tym uruchomieniu platformy. Konfiguracja ta określa, które moduły dodatkowe zostaną uruchomione, oraz różne inne ustawienia systemowe.
Ta wartość (tj. ustawienie domyślne) jest używana tylko w sytuacji, gdy nie ustawiono wartości dla ustawienia osgi.configuration.area. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.console {-console}
- Jeśli ustawiono wartość inną niż NULL, konsola OSGi jest włączona (jeśli ją zainstalowano). Jeśli ustawioną wartością jest odpowiednia liczba całkowita, jest ona interpretowana jako numer portu, na którym konsola nasłuchuje i na który przekazuje swoje dane wyjściowe. Ta opcja jest użyteczna do badania stanu systemu.
- osgi.console.class
- Nazwa klasy konsoli, która ma być uruchamiana po wystąpieniu odpowiedniego żądania.
- osgi.debug {-debug}
- Jeśli ustawiono wartość inną niż NULL, platforma przechodzi w tryb debugowania. Wartość typu łańcuchowego jest interpretowana jako położenie pliku .options. Plik ten definiuje dostępne punkty debugowania dla modułu dodatkowego oraz określa, czy są one włączone. Jeśli nie określono położenia, platforma poszukuje pliku .options w katalogu instalacyjnym.
- osgi.dev {-dev}
- Jeśli ustawiono wartość będącą pustym łańcuchem, włączany jest po prostu tryb programowania. Jako tę właściwość można także ustawić listę rozdzielonych przecinkami wpisów ścieżek klas, które są dodawane do ścieżki klasy każdego modułu dodatkowego, lub adres URL pliku właściwości Java, który zawiera niestandardowe dodatki do ścieżek klas dla zestawu modułów dodatkowych. Dla każdego modułu dodatkowego, który wymaga niestandardowej ścieżki klasy dla trybu programowania, plik będzie zawierać wpis w formie:
<identyfikator modułu dodatkowego>=<lista rozdzielonych przecinkami wpisów ścieżek klas do dodania>
gdzie identyfikator modułu dodatkowego podany w postaci gwiazdki "*" oznacza wszystkie niewymienione moduły dodatkowe.
- osgi.framework
- Adres URL środowiska OSGi. Ta opcja jest użyteczna w przypadku rozłącznej instalacji platformy Eclipse. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.frameworkClassPath
- Lista rozdzielonych przecinkami wpisów ścieżek klas na potrzeby implementacji środowiska OSGi. Ścieżki względne są interpretowane jako ścieżki określone względem położenia tego środowiska (patrz osgi.framework).
- osgi.framework.extensions
- Lista rozdzielonych przecinkami rozszerzeń środowiska. Każda pozycja listy ma następującą formę:
<adres URL | położenie prostego pakunku>
Jeśli określono położenie prostego pakunku (a nie adres URL), wyszukiwanie jest wykonywane w katalogu
macierzystym pakunku org.eclipse.osgi. Rozszerzenia środowiska mogą być używane do uruchomienia platformy
Eclipse z innym adapterem środowiska. Rozszerzenia środowiska mogą zawierać plik eclipse.properties w celu
ustawienia właściwości systemowych. Na przykład rozszerzenie środowiska, które udostępnia implementację
adaptera środowiska, może określać klasę adaptera poprzez ustawienie właściwości osgi.adaptor.
- osgi.framework.shape
- Właściwość ustawiona na kształt implementacji środowiska Eclipse OSGi. Właściwość ta jest ustawiana
w czasie uruchamiania platformy Eclipse i nie powinna być ustawiana przez użytkownika. Wartość
"jar" wskazuje, że środowisko Eclipse OSGi jest zawarte w pojedynczym pliku JAR. Wartość
"folder" wskazuje, że środowisko Eclipse OSGi jest zawarte w katalogu.
- osgi.java.profile
- Adres URL pliku profilu JRE, który ma być używany. Profil JRE zawiera wartości dla właściwości
org.osgi.framework.system.packages i org.osgi.framework.bootdelegation. Jeśli nie ustawiono właściwości
osgi.java.profile, profil zostanie wybrany na podstawie wartości java.specification.version uruchomionego
środowiska JRE.
- osgi.java.profile.bootdelegation
-
Profil Java osgi.java.profile może zawierać właściwość
"org.osgi.framework.bootdelegation". Wartość ta może być używana do ustawienia właściwości
systemowej "org.osgi.framework.bootdelegation". Właściwość osgi.java.profile.bootdelegation
wskazuje strategię dla właściwości bootdelegation, która ma być używana. Poniżej przedstawiono poprawne
wartości (wartość domyślna to ignore):
- ignore - wskazuje, że wartość
"org.osgi.framework.bootdelegation" w profilu Java powinna zostać zignorowana.
Właściwość systemowa "org.osgi.framework.bootdelegation" zostanie użyta do określenia
pakietów, które powinny zostać delegowane do uruchomienia.
- override - wskazuje, że właściwość
"org.osgi.framework.bootdelegation" w profilu Java powinna przesłonić właściwość
systemową "org.osgi.framework.bootdelegation".
- none - wskazuje, że właściwość
"org.osgi.framework.bootdelegation" w profilu Java ORAZ właściwości systemowe
powinny zostać zignorowane. Jest to najbardziej restrykcyjna opcja. Uruchomienie
środowiska z tą opcją powoduje użycie ścisłego modelu delegacji startowej środowiska OSGi R4.
- osgi.install.area {-install}
- Położenie instalacji platformy. To ustawienie określa położenie podstawowych modułów dodatkowych Eclipse i jest użyteczne w przypadku rozłącznej instalacji platformy Eclipse. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.instance.area {-data}
- Położenie danych instancji dla danej sesji. Moduły dodatkowe używają tego położenia do przechowywania własnych danych. Na przykład moduł dodatkowy obsługi zasobów używa go jako domyślnego położenia dla projektów (tj. obszaru roboczego). Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.instance.area.default
- Domyślne położenie danych instancji dla danej sesji. Moduły dodatkowe używają tego położenia do przechowywania własnych danych. Na przykład moduł dodatkowy obsługi zasobów używa go jako domyślnego położenia dla projektów (tj. obszaru roboczego). Ta wartość (tj. ustawienie domyślne) jest używana tylko w sytuacji, gdy nie ustawiono wartości dla ustawienia osgi.instance.area. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.locking
- Typ blokady używanej przy tym uruchomieniu platformy. Poprawne typy blokad to
"java.io", "java.nio" i "none". Wartość domyślna to
"java.nio", chyba że środowisko JRE nie obsługuje wartości "java.nio".
W takim przypadku wartością domyślną jest "java.io".
- osgi.manifest.cache
- Położenie, w którym mają być generowane i wykrywane manifesty. Domyślnie jest nim obszar konfiguracji, ale pamięć podręczna manifestów może być przechowywana oddzielnie.
- osgi.nl {-nl}
- Nazwa ustawień narodowych, z użyciem których ma działać platforma Eclipse. Wartości ustawień narodowych powinny być zgodne ze standardowymi konwencjami nazewnictwa Java dotyczącymi ustawień narodowych.
- osgi.noShutdown {-noExit}
- Jeśli ta właściwość ma wartość "true", maszyna wirtualna nie zostanie zamknięta po zakończeniu aplikacji Eclipse. Jest to przydatne w celu sprawdzania środowiska OSGi po zakończeniu aplikacji Eclipse.
- osgi.os {-os}
- Wartość oznaczająca system operacyjny. Wartość ta powinna być jedną z rozpoznawanych przez platformę Eclipse nazw architektur procesora (np. x86, sparc itp.).
- osgi.parentClassLoader
- Typ programu ładującego klasy, który ma zostać użyty jako nadrzędny program ładujący klasy dla wszystkich pakunków zainstalowanych w środowisku. Poniżej przedstawiono poprawne typy:
- app - program ładujący klasy aplikacji.
- boot - program ładujący klasy startowe.
- ext - program ładujący klasy rozszerzenia.
- fwk - program ładujący klasy środowiska.
- osgi.requiredJavaVersion
- Minimalna wersja języka Java wymagana do uruchomienia platformy Eclipse. Wartość domyślna to "1.4.1".
- osgi.resolverMode
- Tryb używany do rozpoznawania pakunków zainstalowanych w środowisku. Wartość "strict" powoduje
przejście obiektu tłumaczącego w tryb ścisły. Domyślnym trybem obiektu tłumaczącego nie jest tryb ścisły.
Kiedy obiekt tłumaczący znajduje się w trybie ścisłym, środowisko będzie wymuszało reguły ograniczenia dostępu
w czasie ładowania klas i zasobów z wyeksportowanych zasobów, które określają dyrektywy x-internal lub x-friends.
- osgi.sharedConfiguration.area
- Położenie wspólnej konfiguracji używanej przy tym uruchomieniu platformy. Jeśli właściwość
osgi.configuration.cascaded ustawiono na wartość
"true", obszar wspólnej konfiguracji będzie używany jako konfiguracja nadrzędna.
- osgi.splashLocation
- Bezwzględny adres URL ekranu startowego (pliku .bmp), który ma być wyświetlany podczas uruchamiania platformy Eclipse. Ta właściwość ma wyższy priorytet niż każda wartość ustawiona za pomocą właściwości osgi.splashPath.
- osgi.splashPath
- Lista rozdzielonych przecinkami adresów URL, pod którymi należy szukać pliku o nazwie splash.bmp. Ta właściwość ma niższy priorytet niż właściwość osgi.splashLocation.
- osgi.syspath
- Właściwość ustawiona na ścieżkę, w której znajduje się implementacja środowiska Eclipse OSGi (org.eclipse.osgi).
Na przykład: "<ścieżka instalacji platformy Eclipse>/eclipse/plugins". Właściwość ta jest ustawiana
w czasie uruchamiania platformy Eclipse i nie powinna być ustawiana przez użytkownika.
- osgi.user.area {-user}
- Położenie obszaru użytkownika. Obszar użytkownika zawiera dane (np. preferencje) specyficzne dla danego użytkownika systemu operacyjnego i niezależne od instalacji, konfiguracji oraz instancji platformy Eclipse. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.user.area.default
- Domyślne położenie obszaru użytkownika. Obszar użytkownika zawiera dane (np. preferencje) specyficzne dla danego użytkownika systemu operacyjnego i niezależne od instalacji, konfiguracji oraz instancji platformy Eclipse. Ta wartość (tj. ustawienie domyślne) jest używana tylko w sytuacji, gdy nie ustawiono wartości dla ustawienia osgi.user.area. Więcej informacji na ten temat zawiera sekcja Położenia.
- osgi.ws {-ws}
- Wartość oznaczająca system okienkowy. Wartość ta powinna być jedną z rozpoznawanych przez platformę Eclipse nazw systemów okienkowych (np. win32, motif itp.).
Położenia
Środowisko wykonawcze platformy Eclipse definiuje wiele położeń, które programistom modułów dodatkowych zapewniają kontekst na potrzeby odczytywania/przechowywania danych, a użytkownikom Eclipse pozwalają sterować zakresem współużytkowania i widoczności danych. Platforma Eclipse definiuje następujące rodzaje położeń:
- Użytkownik (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, ścieżka do pliku, URL]
- Położenia należące do kategorii Użytkownik są specyficzne dla użytkowników. Zwykle są określane na podstawie właściwości systemowej Java
user.home
, ale można wymusić także inne ustawienia. W położeniu należącym do kategorii Użytkownik można znaleźć informacje, takie jak preferencje danego użytkownika oraz informacje logowania.
- Instalacja (-install) {osgi.install.area} [@user.home, @user.dir, ścieżka do pliku,
URL]
- Jest to położenie, w którym zainstalowano platformę Eclipse. W praktyce jest to katalog (zwykle katalog "eclipse"), w którym znajdują się uruchamiane pliki startup.jar lub eclipse.exe. W przypadku zwykłych użytkowników ten katalog powinien być katalogiem tylko do odczytu, ponieważ instalacja może być współużytkowana przez wielu użytkowników. Istnieje możliwość ustawienia tego położenia i odłączenia pliku startup.jar od reszty platformy Eclipse.
- Konfiguracja (-configuration) {osgi.configuration.area} [@none, @noDefault,
@user.home, @user.dir, ścieżka do pliku, URL]
- Położenia należące do kategorii Konfiguracja zawierają pliki, które pozwalają identyfikować uruchamiany podzbiór instalacji i umożliwiają zarządzanie nim. Oznacza to, że pojedynczej instalacji może odpowiadać wiele konfiguracji. Instalacje mogą często mieć domyślny obszar konfiguracji. Jednak zwykle przy uruchamianiu środowisko wykonawcze próbuje znaleźć inne położenia konfiguracji, w których można swobodniej przeprowadzać zapis.
- Instancja (-data) {osgi.instance.area} [@none, @noDefault, @user.home,
@user.dir, ścieżka do pliku, URL]
- Położenia należące do kategorii Instancja zawierają artefakty danych definiowane przez użytkownika. Na przykład moduł dodatkowy obsługi zasobów używa obszaru instancji jako położenia obszaru roboczego, czyli domyślnego miejsca dla projektów. Także inne moduły dodatkowe mogą w tym położeniu zapisywać dowolne pliki.
Użytkownik może ustawić każde z tych położeń, a jeśli tego nie zrobi, platforma Eclipse automatycznie określi odpowiednie ustawienia domyślne. Położeniem najczęściej ustawianym przez użytkowników jest obszar instancji lub obszar roboczy (w kontekście środowiska IDE). Aby uruchomić domyślną konfigurację platformy Eclipse z użyciem określonego zestawu danych, można użyć komendy:
eclipse -data c:\mojedane
Dodatkowe informacje
Położenia są określane przy użyciu adresów URL. Dla ułatwienia akceptowane są także ścieżki do plików, które automatycznie są przekształcane w adresy z przedrostkiem file:. Użytkownicy mogą także używać wielu predefiniowanych zapisów symbolicznych. Należy przy tym zauważyć, że nie wszystkie kombinacje typu położenia i wartości symbolicznej są poprawne. Poniższa tabela zawiera dozwolone kombinacje. Ponieważ w przypadku wszystkich położeń domyślnie założono, że są one ustawione, poprawne i dostępne do zapisu, inne konfiguracje mogą spowodować wystąpienie błędów w niektórych modułach dodatkowych (nawet jeśli opisano je w tabeli jako możliwe). Na przykład nie należy oczekiwać, że moduł dodatkowy operujący na danych użytkownika (np. moduł dodatkowy obsługi zasobów) będzie działał poprawnie, jeśli nie zdefiniowano obszaru instancji. Programista modułu dodatkowego jest odpowiedzialny za określenie obsługiwanych konfiguracji i za odpowiednie zaprojektowanie ich funkcji.
- @none
- Oznacza, że odpowiednie położenie nie powinno być nigdy ustawione jawnie ani przez wartość domyślną. Na przykład aplikacja typu RCP, która jest pozbawiona danych użytkownika, może mieć ustawienie osgi.instance.area=@none uniemożliwiające zapisywanie zbędnych plików na dysku. Po symbolu @none nie powinny występować żadne dodatkowe segmenty ścieżki.
- @noDefault
- Oznacza, że dane położenie będzie niezdefiniowane lub zdefiniowane jawnie (tzn. platforma Eclipse nie będzie automatycznie wyznaczać wartości domyślnej). Takie ustawienie jest użyteczne, jeśli w odpowiednim położeniu mają być zapisywane dane, ale wartość domyślna platformy Eclipse nie jest do tego celu odpowiednia. Po symbolu @noDefault nie powinny występować żadne dodatkowe segmenty ścieżki.
- @user.home
- Wymusza na platformie Eclipse określanie położenia względem głównego katalogu użytkownika. Po symbolu @user.home mogą występować dodatkowe segmenty ścieżki. We wszystkich przypadkach łańcuch "@user.home" jest po prostu zastępowany wartością właściwości systemowej Java "user.home". Na przykład ustawienie
osgi.instance.area=@user.home/myWorkspace
pozwala uzyskać wartość
file:/users/bob/myWorkspace
- @user.dir
- Wymusza na platformie Eclipse określanie położenia względem bieżącego katalogu roboczego. Po symbolu @user.dir mogą występować dodatkowe segmenty ścieżki. We wszystkich przypadkach łańcuch "@user.dir" jest po prostu zastępowany wartością właściwości systemowej Java "user.dir". Na przykład ustawienie
osgi.instance.area=@user.dir/myWorkspace
pozwala uzyskać wartość
file:/usr/share/eclipse/myWorkspace
Położenie/wartość |
Obsługa wartości domyślnej |
Plik/URL
|
@none
|
@noDefault
|
@user.home
|
@user.dir
|
Instancja
|
tak |
tak
|
tak
|
tak
|
tak
|
tak (domyślnie)
|
Konfiguracja
|
tak
|
tak
|
tak*
|
tak*
|
tak
|
tak
|
Instalacja
|
nie
|
tak
|
nie
|
nie
|
tak
|
tak
|
Użytkownik
|
tak
|
tak
|
tak
|
tak
|
tak
|
tak
|
* Taka konfiguracja jest technicznie możliwa, ale w praktyce byłaby trudna w użyciu. Jeśli na przykład nie ustawiono położenia konfiguracji, środowisko wykonawcze platformy Eclipse może uruchomić tylko środowisko OSGi.
Położenia tylko do odczytu
Położenie może być określone jako dostępne tylko do odczytu poprzez dodanie atrybutu ".readOnly"
do właściwości położenia i ustawienie go na wartość "true". Następujące właściwości mogą być
używane do określania odpowiednich położeń jako dostępnych tylko do odczytu:
Plik INI programu uruchamiającego
Plik eclipse.exe oraz pliki wykonywalne dla aplikacji RCP mogą teraz odczytywać parametry z powiązanego
pliku INI. Plik ten zapewnia niezależny od platformy sposób przekazywania argumentów, które wcześniej były
określane bezpośrednio w wierszu komend, takie jak maszyna VM lub jej argumenty. W pliku INI można określić
wszystkie parametry, ale w celu usprawnienia obsługi i zachowania spójności w różnych instalacjach zaleca się,
aby w pliku INI określać tylko położenie maszyny VM i jej argumenty, natomiast dla innych parametrów używać
pliku config.ini.
Format pliku
Nazwa tego pliku musi odpowiadać nazwie pliku wykonywalnego (na przykład plik eclipse.exe odczyta plik
eclipse.ini, natomiast plik launcher.exe odczyta plik launcher.ini), a każdy parametr musi znajdować się
w nowym wierszu pliku. Poniżej przedstawiono przykład takiego pliku określającego położenie maszyny VM
oraz kilka parametrów:
-vm
c:/myVm/java.exe
-vmargs
-Dms40M