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.