Executar o gestor de actualizações a partir da linha de comandos
Além da caixa de diálogo do assistente de instalação e da configuração, é possível executar operações do gestor de actualizações executando o Eclipse no modo de linha de comandos. O utilizador poderá instalar, actualizar, activar e desactivar funções, ou enumerar as funções instaladas ou funções disponíveis num sítio da web de actualizações ou adicionar um sítio da web do produto de extensões à instalação local, etc.
Pode ainda duplicar as funções seleccionadas a partir do sítio da web de actualizações para uma localização local do sítio da web de actualizações.
Lance o Eclipse do modo seguinte, onde [ ] significa argumentos opcionais e os argumentos em itálico devem ser fornecidos pelo utilizador.
Instalar uma função a partir de um sítio da web remoto::
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command install
-featureId feature_id
-version version
-from remote_site_url
[-to target_site_dir]
Exemplo: 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
Actualizar uma função existente ou todas as funções:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command update
[-featureId feature_id ]
[-version version ]
Activar (configurar) uma função especificada:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command enable
-featureId feature_id
-version version
[-to target_site_dir]
Desactivar (anular configuração) uma função especificada:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command disable
-featureId feature_id
-version version
[-to target_site_dir]
Desinstalar uma função especificada:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command uninstall
-featureId feature_id
-version version
[-to target_site_dir]
Em todos os comandos anteriores, onde se especifica -to target_site_dir, será utilizado o sítio da web de destino configurado corresponde num determinado directório. Se não for especificado, então será utilizado o sítio da web do produto local predefinido.
Se apenas tem de verificar se a operação seria bem sucedida, nos comandos anteriores (ou seja, se satisfazem as restrições), mas sem os executar, então adicione -verifyOnly=true à lista de argumentos.
Pesquisar um sítio da web remoto, listando todas as funções disponíveis para instalação:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command search
-from remote_site_url
enumerar as funções instaladas:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command listFeatures
-from local_site_dir
As funções são enumeradas como:
Sítio: url do sítio
Função: id de versão activada (ou desactivada)
Adicionar um sítio da web local com mais funções:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command addSite
-from local_site_dir
Remover um sítio da web local:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command removeSite
-to local_site_dir
Duplicar funções a partir de um sítio da web remoto:
java -cp startup.jar org.eclipse.core.launcher.Main
-application org.eclipse.update.core.standaloneUpdate
-command mirror
-from remote_site_url
-to target_site_dir
[-featureId feature_id]
[-version version]
[-mirrorURL mirror_site_url]
Se for especificado -mirrorURL, será gerada uma política de actualizações no ficheiro <target_site_dir>/policy.xml. O ficheiro policy.xml resultante correlaciona todas as funções a partir do sítio da web de duplicações para o URL especificado.
O ficheiro policy.xml pode ser utilizado como está, ou os seus fragmentos podem ser incluídos no ficheiro de política designada personalizada.
O código de retorno para cada comando é 0 (êxito) ou 1 (falha).
Adicionalmente, pode passar-se a maioria das opções aceites pelo executável do Eclipse. Estas são especialmente úteis durante a depuração e para especificar o ambiente de destino para as funções instaladas. Por exemplo, passar a opção -data some_path
irá definir a área de trabalho para some_path.