Uruchamianie menedżera aktualizacji z wiersza komend

Operacje menedżera aktualizacji można wykonywać nie tylko przy użyciu kreatora instalacji i okna dialogowego konfiguracji, ale także przez uruchomienie platformy Eclipse w trybie wiersza komend. Możliwe jest instalowanie, aktualizowanie, włączanie i wyłączanie składników, wyświetlanie listy zainstalowanych składników lub składników dostępnych na serwerze aktualizacji, a także dodawanie serwisu rozszerzenia do lokalnej instalacji.
W lokalnym serwisie aktualizacji można również tworzyć kopie lustrzane wybranych składników z serwisu aktualizacji.

Należy uruchomić platformę Eclipse we wskazany poniżej sposób. Fragmenty w nawiasach kwadratowych [ ] to argumenty opcjonalne, a argumenty wyróżnione kursywą musi podać użytkownik.

Instalowanie składnika z serwisu zdalnego:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command install
    -featureId identyfikator_składnika
    -version wersja
    -from adres_URL_serwisu_zdalnego
    [-to katalog_serwisu_docelowego]

Przykład: java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.update.core.standaloneUpdate -command install -from http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-update-home/optionalSite/ -featureId com.example.root -version 1.0.0


Aktualizowanie istniejącego składnika lub wszystkich składników:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command update
    [-featureId identyfikator_składnika]
    [-version wersja]

Włączanie (konfigurowanie) określonego składnika:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command enable
    -featureId identyfikator_składnika
    -version wersja
    [-to katalog_serwisu_docelowego]

Wyłączanie (dekonfigurowanie) określonego składnika:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command disable
    -featureId identyfikator_składnika
    -version wersja
    [-to katalog_serwisu_docelowego]

Deinstalowanie określonego składnika:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command uninstall
    -featureId identyfikator_składnika
    -version wersja
    [-to katalog_serwisu_docelowego]

W przypadku wszystkich powyższych komend w miejscach, w których użyto opcji -to katalog_serwisu_docelowego, zostanie użyty odpowiedni skonfigurowany serwis docelowy z podanego katalogu. W razie pominięcia tej opcji zostanie użyty domyślny lokalny serwis produktu.

Aby bez przeprowadzania operacji sprawdzić, czy może ona zakończyć się pomyślnie w przypadku zastosowania powyższych komend (tzn. spełnia odpowiednie wymogi), do listy argumentów należy dodać pozycję -verifyOnly=true.

Wyszukiwanie w serwisie zdalnym i wyświetlanie listy dostępnych składników do zainstalowania:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command search
    -from adres_URL_serwisu_zdalnego

Wyświetlanie listy zainstalowanych składników:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command listFeatures
    -from katalog_serwisu_lokalnego

Składniki są wyświetlane w następujący sposób:
Site: adres URL serwisu
  Feature: identyfikator wersji enabled (lub disabled)


Dodawanie do serwisu lokalnego kolejnych składników:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command addSite
    -from katalog_serwisu_lokalnego

Usuwanie serwisu lokalnego:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command removeSite
    -to katalog_serwisu_lokalnego

Tworzenie kopii lustrzanych składników z serwisu zdalnego:
java -cp startup.jar org.eclipse.core.launcher.Main
    -application  org.eclipse.update.core.standaloneUpdate
    -command mirror
    -from adres_URL_serwisu_zdalnego
    -to katalog_serwisu_docelowego
    [-featureId identyfikator_składnika]
    [-version wersja]
    [-mirrorURL adres_URL_serwisu_kopii_lustrzanej]

Jeśli użyto opcji -mirrorURL, w pliku <katalog_serwisu_docelowego>/policy.xml zostanie wygenerowana strategia aktualizacji. Wynikowy plik policy.xml będzie odwzorowywał wszystkie składniki z serwisu kopii lustrzanej na określony adres URL. Plik policy.xml może być używany w całości lub jego fragmenty można uwzględnić w pliku niestandardowej strategii.

Kod powrotu dla każdej komendy może wynosić 0 (powodzenie) albo 1 (niepowodzenie).

Dodatkowo można przekazywać większość opcji akceptowanych przez plik wykonywalny Eclipse. Są one przydatne zwłaszcza podczas debugowania oraz przy określaniu środowiska docelowego dla instalowanych składników. Na przykład użycie opcji -data dowolna_ścieżka spowoduje umieszczenie obszaru roboczego w katalogu dowolna_ścieżka.