Uruchamianie platformy Eclipse

Po zainstalowaniu pakietu SDK Eclipse w katalogu można uruchomić środowisko robocze, uruchamiając plik wykonywalny Eclipse dołączony do wydania (niezbędne jest też środowisko JRE 1.4.2, niedołączone do pakietu SDK Eclipse). W systemie Windows plik wykonywalny nazywa się eclipse.exe i jest umieszczony w podkatalogu eclipse instalacji. Jeśli więc zainstalowano Eclipse w katalogu c:\eclipse-SDK-3.2-win32, plik wykonywalny to c:\eclipse-SDK-3.2-win32\eclipse\eclipse.exe. Uwaga: konfiguracja w większości innych środowisk operacyjnych jest podobna. W przypadku systemu Mac OS X potrzebne są inne działania, których opis zamieszczono poniżej.

Przydzielanie wystarczającej ilości pamięci i rozwiązywanie problemów z błędami OutOfMemoryError

Środowisku Eclipse domyślnie przydzielane jest maksymalnie 256 megabajtów pamięci sterty Java. Powinno to wystarczyć do przeprowadzania wszystkich typowych działań programistycznych. Jednak w zależności od stosowanego środowiska JRE, liczby wykorzystywanych wtyczek oraz liczby plików, na których prowadzone są prace, może wystąpić sytuacja, w której limit ten należy zwiększyć. Eclipse pozwala przekazywać argumenty bezpośrednio do maszyny VM Java przy użyciu argumentu wiersza komend -vmargs, który musi być umieszczony po wszystkich innych argumentach dla Eclipse. Aby zatem zwiększyć dostępną ilość pamięci sterty, zazwyczaj wystarczy użyć komendy:

eclipse -vmargs -Xmx<ilość pamięci>

przy użyciu wartości <ilość pamięci> większej niż "256M" (256 megabajtów -- wartość domyślna).

Jeśli wykorzystywana jest maszyna VM firmy Sun, może być również konieczne zwiększenie ilości pamięci do stałego generowania. Domyślna wartość maksymalna to 64 megabajty, ale może być potrzeba większej ilości, w zależności od konfiguracji wtyczek i sposobu ich użycia. Maksymalną ilość pamięci do stałego generowania można zwiększyć przy użyciu argumentu XX:MaxPermSize=<ilość pamięci>:

eclipse -vmargs -XX:MaxPermSize=<ilość pamięci>

Ten argument może nie być dostępny we wszystkich wersjach maszyn VM i na wszystkich platformach. Więcej informacji na ten temat można znaleźć w dokumentacji maszyny VM.

Należy zauważyć, że podanie ilości pamięci większej niż ilość dostępnej pamięci fizycznej na komputerze spowoduje, że Java będzie się "krztusić" kopiując obiekty do pamięci wirtualnej i z powrotem, co znacznie ograniczy wydajność systemu.

Wybór obszaru roboczego

Po uruchomieniu środowiska roboczego wyświetlane jest okno dialogowe pozwalające wybrać położenie obszaru roboczego. Obszar roboczy to katalog, w którym będzie zapisywana praca. Jeśli nie zostanie określony katalog, środowisko Eclipse utworzy obszar roboczy w katalogu bieżącego użytkownika. 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 zawierających wiele obszarów roboczych należy jawnie określić położenie obszaru roboczego przy użyciu wspomnianego okna dialogowego (lub stosując argument wiersza komend: "-data").

Oto typowy wiersz komend Eclipse: 

eclipse -vm c:\jdk1.4.2\jre\bin\javaw

Wskazówka: warto jawnie wskazać, która maszyna VM Java powinna być użyta przy uruchamianiu Eclipse. Można to zrobić przy użyciu argumentu wiersza komend "-vm" w sposób pokazany powyżej. Jeśli argument wiersza komend "-vm" nie zostanie użyty, Eclipse użyje maszyny VM znalezionej w ścieżce systemu operacyjnego. Po zainstalowaniu innych produktów opartych na języku Java ścieżka może zostać zmieniona, co spowoduje użycie innej maszyny VM Java przy następnym uruchomieniu środowiska Eclipse.

Aby utworzyć skrót Windows do zainstalowanego środowiska Eclipse, wykonaj następujące czynności:

  1. Przejdź do pliku eclipse.exe w Eksploratorze Windows i użyj opcji Utwórz skrót menu kontekstowego.
  2. Wybierz skrót i zmień jego Właściwości. W polu Cel: dodaj argumenty wiersza komend.

Po otwarciu tego skrótu środowisko Eclipse zostanie uruchomione (skrót można dla wygody przeciągnąć na pulpit Windows).

Mac OS X

W systemie Mac OS X środowisko Eclipse uruchamia się klikając dwukrotnie aplikację Eclipse. Jeśli do aplikacji muszą być przekazane argumenty, należy zmienić plik eclipse.ini w pakunku aplikacji Eclipse: należy wybrać ikonę pakunku aplikacji Eclipse, przytrzymując wciśnięty klawisz Control. Wywołane zostanie menu podręczne. Wybierz z niego opcję "Pokaż treść pakietu". Znajdź plik eclipse.ini w folderze Contents/MacOS, a następnie otwórz plik przy użyciu dowolnego edytora tekstu i zmień opcje wiersza komend.

Jeśli chcesz uruchomić Eclipse z wiersza komend, możesz użyć dowiązania symbolicznego "eclipse" w folderze Eclipse najwyższego poziomiu. Dowiązuje ono do pliku wykonywalnego Eclipse umieszczonego w pakunku aplikacji i pozwala użyć takich samych argumentów, jak "eclipse.exe" na innych platformach.

W systemie Mac OS X 10.4 i późniejszych wersjach można zauważyć, że aplikacja pracuje wolniej przy użyciu dużej ilości zasobów, jeśli obszar roboczy może być indeksowany przy użyciu narzędzia Spotlight. Aby uniknąć tej sytuacji, wybierz preferencje systemowe (System Preferences), następnie ikonę Spotlight, przejdź do zakładki Prywatność (Privacy) i kliknij przycisk Dodaj (Add) ("+"), a następnie wyszukaj w wyświetlonym oknie dialogowym katalog obszaru roboczego.

Instalacje współużytkowane

Szybkość uruchamiania instalacji współużytkowanej można zwiększyć, jeśli w obszarze instalacji współużytkowanej przechowane zostaną odpowiednie informacje w pamięci podręcznej. Aby to zrobić, po rozpakowaniu dystrybucji Eclipse uruchom środowisko Eclipse pierwszy raz z opcją "-initialize", z konta które ma dostęp do zapisu w katalogu instalacyjnym.

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 wtyczek 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 wtyczek 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 wtyczki 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
-clean
Usuwa dane z pamięci podręcznej, używane przez środowisko OSGi oraz środowisko wykonawcze Eclipse. Uruchom Eclipse jeden raz przy użyciu tej opcji, jeśli po zainstalowaniu, aktualizacji lub w konfiguracji współużytkowanej pojawią się błędy przy uruchamianiu. 3.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 wtyczek 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ą dziennika 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 wtyczki, 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 rozdzielona przecinkami) są dodawane do ścieżki klasy środowiska wykonawczego każdej wtyczki. Na przykład jeśli obszar roboczy zawiera wtyczki w trakcie projektowania, podanie parametru -dev bin spowoduje dodanie wpisu ścieżki klasy dla każdego katalogu bin projektu wtyczki, umożliwiając wyszukiwanie w tym katalogu nowo wygenerowanych plików klas. Nadmiarowe lub nieistniejące wpisy ścieżki klasy są usuwane. 1.0
-initialize
Inicjuje uruchamianą konfigurację. W takim przypadku są odświeżane wszystkie struktury danych i pamięci podręczne powiązane ze środowiskiem wykonawczym. Opcja użyteczna przy instalacjach współużytkowanych: uruchomienie platformy Eclipse jeden raz przy użyciu tej opcji, z konta z prawami do zapisu, spowoduje usprawnienie procesu uruchamiania. 3.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 wtyczek 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 wtyczek jako metoda BootLoader.getOS() i służy do interpretowania wystąpień zmiennej $os$ w ścieżkach wymienionych w pliku manifestu wtyczki. 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 wtyczki. 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 [nazwaObszaruRoboczego]
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. W wersji 3.2 dodano opcjonalny argument nazwy obszaru roboczego, który wyświetla podaną nazwę w pasku tytułu okna (zamiast wyświetlać położenie obszaru roboczego). 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".