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.