Uruchamianie platformy Eclipse

Po zainstalowaniu (rozpakowaniu) sterownika platformy Eclipse w katalogu (na przykład c:\eclipse) można uruchomić środowisko robocze za pomocą pliku wykonywalnego Eclipse znajdującego się na najwyższym poziomie katalogu instalacyjnego. Plik wykonywalny nosi nazwę eclipse.exe w systemach Windows i eclipse w systemach Linux. Uwaga: Poniżej opisano ustawienia dla systemów Windows. Konfigurowanie w systemach Linux przebiega w podobny sposób.

Jeśli nie zostanie określony katalog, środowisko Eclipse wyświetli zapytanie o katalog obszaru roboczego. Domyślnym położeniem tego katalogu jest katalog potomny o nazwie "workspace" głównego katalogu użytkownika (na przykład c:\Documents and Settings\Nazwa użytkownika\workspace). Ten katalog obszaru roboczego służy jako domyślny obszar treści projektów, a także jest używany do przechowywania wszystkich wymaganych metadanych. W przypadku instalacji współużytkowanych lub obejmujących wiele obszarów roboczych należy jawnie określić położenie obszaru roboczego, który będzie używany zamiast obszaru domyślnego. Zamiast wpisywać inną lokalizację po wyświetleniu pytania, można użyć argumentu wiersza komend -data.

Ustawianie określonego położenia dla obszaru roboczego przy użyciu argumentu -data

Aby użyć argumentu wiersza komend -data, należy dodać łańcuch -data położenie_obszaru_roboczego (na przykład -data c:\users\robert\mój_obszar_roboczy) do pola Element docelowy w oknie dialogowym właściwości skrótu bądź podać go w wierszu komend.

Ustawianie maszyny wirtualnej języka Java przy użyciu argumentu -vm

Zaleca się, aby przy uruchamianiu platformy Eclipse jawnie określić maszynę VM Java, która ma być używana. Aby to zrobić, należy podać argument wiersza komend -vm (na przykład -vm c:\jre\bin\javaw.exe). Jeśli argument -vm nie zostanie podany, platforma Eclipse użyje pierwszej maszyny VM znalezionej w ścieżce systemu operacyjnego. Podczas instalacji innych produktów ścieżka może zostać zmieniona, co spowoduje użycie innej maszyny VM Java przy następnym uruchomieniu platformy Eclipse.

Zaawansowane informacje dotyczące uruchamiania platformy Eclipse

Plik wykonywalny platformy Eclipse oraz sama platforma udostępniają wiele opcji uruchomienia, które będą przydatne osobom tworzącym i debugującym elementy platformy Eclipse. Poniżej znajduje się lista najczęściej używanych opcji. Pełna lista opcji znajduje się na stronie opcji środowiska wykonawczego Eclipse w Podręczniku programisty modułów dodatkowych platformy Eclipse. Ogólna składnia uruchamiania pliku wykonywalnego Eclipse jest następująca:

eclipse [opcje platformy] [-vmargs [argumenty maszyny VM Java]]
Parametry uruchamiania platformy Eclipse
Komenda Opis Dostępne od wersji
-arch architektura
Definiuje architekturę procesora, na której jest uruchamiana platforma Eclipse. Platforma Eclipse określa zazwyczaj optymalne ustawienia, używając podstawowej wartości właściwości os.arch Java. Platforma Eclipse będzie stosowała tę wartość, jeśli zostanie podana w tym miejscu. Wartość ta będzie dostępna także dla modułów dodatkowych jako metoda BootLoader.getOSArch(). Przykładowe wartości: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application ID_aplikacji
Aplikacja do uruchomienia. Aplikacje są deklarowane przez moduły dodatkowe dostarczające rozszerzenia dla punktu rozszerzenia org.eclipse.core.runtime.applications. Zwykle ten argument nie jest konieczny. Jeśli zostanie określony, jego wartość zastąpi wartość dostarczaną przez konfigurację. Jeśli wartość atrybutu nie zostanie określona, uruchamiane jest środowisko robocze Eclipse. 1.0
-configuration adres_URL_pliku_konfiguracyjnego
Położenie pliku konfiguracyjnego platformy Eclipse, wyrażone w postaci adresu URL. Plik konfiguracyjny określa położenie platformy Eclipse, zestaw dostępnych modułów dodatkowych oraz składnik podstawowy. Względne adresy URL nie są dozwolone. Plik konfiguracyjny jest zapisywany w tym położeniu podczas instalowania lub aktualizacji platformy Eclipse. 2.0
-consolelog
Tworzy kopię lustrzaną protokołu błędów platformy Eclipse na konsoli używanej do uruchamiania platformy Eclipse. Ten parametr jest przydatny w połączeniu z parametrem -debug. 1.0
-data ścieżka_obszaru_roboczego
Ścieżka obszaru roboczego, dla którego ma zostać uruchomiona platforma Eclipse. Położenie obszaru roboczego jest także domyślnym położeniem projektów. Ścieżki względne są interpretowane w odniesieniu do katalogu, w którym uruchomiono platformę Eclipse. 1.0
-debug [plik_opcji]
Włącza tryb debugowania platformy i ładuje opcje debugowania z pliku w określonym położeniu, jeśli zostało podane. Plik ten wskazuje, które punkty debugowania są dostępne dla modułu dodatkowego, a także czy są one aktywne. Jeśli położenie pliku nie zostało określone, platforma Eclipse sprawdza katalog, w którym została uruchomiona, szukając pliku o nazwie .options. Jako położenie pliku można podawać adresy URL i ścieżki systemu plików. 1.0
-dev [wpisy_ścieżki_klasy]
Przełącza platformę w tryb projektowania. Opcjonalne wpisy ścieżki klasy (lista oddzielona przecinkami) są dodawane do ścieżki klasy środowiska wykonawczego każdego modułu dodatkowego. Na przykład jeśli obszar roboczy zawiera moduły dodatkowe w trakcie projektowania, podanie parametru -dev bin spowoduje dodanie wpisu ścieżki klasy dla każdego katalogu bin projektu modułu dodatkowego, umożliwiając wyszukiwanie w tym katalogu nowo wygenerowanych plików klas. Nadmiarowe lub nieistniejące wpisy ścieżki klasy są usuwane. 1.0
-keyring ścieżka_pliku_kluczy
Położenie bazy danych autoryzacji (lub "pliku kluczy") na dysku. Tego argumentu należy używać w połączeniu z opcją -password. Ścieżki względne są interpretowane w odniesieniu do katalogu, w którym uruchomiono platformę Eclipse. 1.0
-nl ustawienia_narodowe
Definiuje nazwę ustawień narodowych, z którymi platforma Eclipse została uruchomiona. Platforma Eclipse zazwyczaj określa automatycznie optymalne ustawienia. Platforma Eclipse będzie stosowała tę wartość, jeśli zostanie podana w tym miejscu. Wartość ta będzie dostępna także dla modułów dodatkowych jako metoda BootLoader.getNL(). Przykładowe wartości: "pl_PL" i "fr_FR_EURO". 2.0
-nosplash
Uruchamia platformę bez wyświetlania ekranu startowego. 1.0
-os system_operacyjny
Definiuje system operacyjny, na którym jest uruchamiana platforma Eclipse. Platforma Eclipse określa zazwyczaj optymalne ustawienia, używając podstawowej wartości właściwości os.name Java. Platforma Eclipse będzie stosowała tę wartość, jeśli zostanie podana w tym miejscu. Podana wartość jest dostępna dla modułów dodatkowych jako metoda BootLoader.getOS() i służy do rozwiązywania wystąpień zmiennej $os$ w ścieżkach wymienionych w pliku manifestu modułu dodatkowego. Przykładowe wartości: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password hasło
Hasło dla bazy danych autoryzacji. Należy używać w połączeniu z opcją -keyring. 1.0
-perspective ID_perspektywy
Perspektywa, która zostanie otwarta w aktywnym oknie środowiska roboczego po uruchomieniu platformy. Jeśli ten parametr nie został podany, zostanie otwarta perspektywa, która była aktywna przed zamknięciem środowiska roboczego. 1.0
-plugincustomization
	  plik_właściwości
Położenie pliku właściwości zawierającego ustawienia domyślne dla preferencji modułu dodatkowego. Te ustawienia zastępują ustawienia domyślne określone w składniku podstawowym. Ścieżki względne są interpretowane w odniesieniu do katalogu, w którym uruchomiono platformę Eclipse. 2.0
-product ID_produktu
Identyfikator produktu do uruchomienia. Produkt nadaje tożsamość uruchomionej instancji platformy Eclipse oraz określa używane informacje o konfiguracji produktu. Ten parametr zastępuje parametr -feature, który nadal jest obsługiwany w celu zachowania zgodności. 3.0
-refresh 
Opcja pozwalająca wykonać globalne odświeżenie obszaru roboczego podczas uruchamiania. Powoduje rozliczenie wszystkich zmian wprowadzonych w systemie plików od ostatniego uruchomienia platformy. 1.0
-showlocation 
Opcja służąca do wyświetlania położenia obszaru roboczego na pasku tytułu okna. W wersji 2.0 ta opcja działała tylko w połączeniu z argumentem wiersza komend -data. 2.0
-vm ścieżka_maszyny_vm
Położenie środowiska wykonawczego programów Java (JRE), które zostanie użyte do uruchomienia platformy Eclipse. Jeśli ten parametr nie zostanie podany, używane będzie środowisko JRE w katalogu jre znajdującym się na tym samym poziomie co plik wykonywalny platformy Eclipse. Ścieżki względne są interpretowane w odniesieniu do katalogu, w którym uruchomiono platformę Eclipse. 1.0
-vmargs argumenty
Opcja służąca do dostosowania działania maszyny VM Java używanej do uruchomienia platformy Eclipse. Jeśli określono tę opcję, musi ona znajdować się na końcu wiersza komend. Podane argumenty zależą od uruchamianej maszyny VM. 1.0

Wszystkie argumenty znajdujące się za wpisem -vmargs (ale bez tego wpisu) są przekazywane bezpośrednio do wskazanej maszyny VM jako argumenty maszyny wirtualnej (czyli przed klasą do wykonania). Uwaga: Jeśli argument uruchamiania platformy Eclipse (na przykład -data) zostanie określony po argumentach maszyny VM Java (-vmargs), platforma Eclipse nie zostanie uruchomiona i pojawi się komunikat o błędzie "Zakończono pracę wirtualnej maszyny języka Java. Kod wyjścia=1".

Uruchamianie na różnych maszynach VM 

Uruchamianie platformy Eclipse na maszynie VM J9

W czasie uruchamiania platformy Eclipse na maszynie VM J9 w wersji 1.5 zaleca się użycie następujących opcji maszyny VM:

eclipse.exe [argumenty eclipse] -vm ścieżka_do_pliku_j9w.exe
            -vmargs -ms:32 -mm:2048 -mo:32768 -moi:32768 -mca:32 -mco:128 -mx:2000000

Jeśli platforma Eclipse jest uruchamiana na maszynie VM J9 w wersji 2.0, domyślne argumenty wybrane przez maszynę VM J9W powinny być odpowiednie. Aby zastąpić parametry, które są automatycznie ustawiane wewnętrznie przez plik wykonywalny platformy Eclipse, należy określić opcję -vmargs, nie podając za nią żadnych innych argumentów:

eclipse.exe [argumenty eclipse] -vm ścieżka_do_pliku_j9w.exe -vmargs

Więcej informacji znajduje się w dokumentacji maszyny VM J9.

Uruchamianie platformy Eclipse na maszynie VM produktu IBM Developer Kit, Java(TM) Technology Edition

Domyślne ustawienia maszyny VM dla produktu IBM Developer Kit, Java(TM) Technology Edition 1.3 Linux są odpowiednie do zapoznania się z produktem, ale nie są wystarczające do programowania na szeroką skalę. W przypadku tworzenia dużych projektów należy zmodyfikować argumenty maszyny VM tak, aby dostępna była większa sterta. Poniższe ustawienie umożliwia powiększenie sterty Java do 256 MB: 

-vmargs -Xmx256M