Po zainstalowaniu pakietu Eclipse SDK w katalogu można uruchomić środowisko robocze, uruchamiając plik wykonywalny Eclipse dołączony do wydania (niezbędny jest też pakiet JDK6 lub środowisko JRE 6, niedołączone do pakietu SDK Eclipse). W systemie Windows plik wykonywalny nazywa się eclipse.exe i jest
umieszczony w podkatalogu eclipse katalogu instalacji. Jeśli pakiet
zainstalowano w katalogu c:\eclipse-SDK-4.4-win32, ścieżka dostępu do pliku wykonywalnego będzie mieć postać c:\eclipse-SDK-4.4-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.
Środowisku Eclipse domyślnie przydzielane są maksymalnie 384 megabajty
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ż
"384M" (384 megabajty - wartość domyślna).
Jeśli używane jest środowisko JRE firmy Oracle, konieczne może być również zwiększenie ilości pamięci generowanej w sposób stały. 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. Gdy maszynie VM zabraknie pamięci do stałego generowania, może nastąpić jej awaria lub zawieszenie w momencie ładowania klas. 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.
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:\jdk7u45\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:
eclipse.exe w Eksploratorze Windows i użyj opcji Utwórz skrót menu kontekstowego.Po otwarciu tego skrótu środowisko Eclipse zostanie uruchomione (skrót można dla wygody przeciągnąć na pulpit Windows).
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 podfolderze Contents/MacOS, a
następnie otwórz plik przy użyciu dowolnego edytora tekstu i zmień opcje
wiersza komend.
W systemie MacOS X można uruchomić program interfejsu użytkownika więcej niż raz, tylko jeśli na dysku istnieją oddzielne kopie tego programu. Jest to spowodowane tym, że każda aplikacja interfejsu użytkownika w tym systemie może otwierać wiele dokumentów, więc nie ma potrzeby dwukrotnego uruchamiania tego programu. Z tego powodu środowisko Eclipse nie może otworzyć więcej niż jednego obszaru roboczego. Dlatego też aby jednocześnie otworzyć więcej niż jeden obszar roboczy, należy wykonać kopię instalacji Eclipse (błąd programu 139319).
Jeśli chcesz uruchomić Eclipse z wiersza komend, możesz użyć dowiązania symbolicznego "eclipse" w folderze Eclipse najwyższego poziomu. 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 będzie 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.
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.
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]]
| 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 jest dostępna dla wtyczek jako metoda Platform.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_konfiguracji |
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_klas] |
Przełącza platformę w tryb projektowania. Opcjonalne wpisy ścieżki klas (lista rozdzielona przecinkami) są dodawane do ścieżki klas ś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 klas 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 klas 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 jest dostępna dla wtyczek jako metoda Platform.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 Platform.getOS() i służy do rozstrzygania 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 położenie to nie zostanie określone, program uruchamiający spróbuje znaleźć środowisko JRE. Najpierw będzie szukał katalogu o nazwie jre jako elementu równorzędnego pliku wykonywalnego środowiska, a następnie zacznie wyszukiwanie w ścieżce systemu operacyjnego.
Ś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".