Executar o Eclipse

Depois de instalar o Eclipse SDK num directório, pode iniciar a Área de trabalho utilizando o ficheiro executável do Eclipse incluído na edição (necessitará ainda de um JRE SE 5 de Java, não incluído no Eclipse SDK). No Windows, o ficheiro executável é denominado eclipse.exe e está localizado no subdirectório eclipse da instalação. Caso a instalação esteja efectuada em c:\eclipse-SDK-4.1-win32, o ficheiro executável é c:\eclipse-SDK-4.1-win32\eclipse\eclipse.exe. Nota: A configuração na maioria dos restantes ambientes operativos é análoga. As instruções específicas para Mac OS X são apresentadas abaixo.

Atribuir memória suficiente e resolver OutOfMemoryErrors

Por predefinição, o Eclipse irá atribuir até 384 megabytes de memória de pilha de Java. Este procedimento deverá abranger todas as tarefas de desenvolvimento típicas. No entanto, dependendo do JRE que estiver a executar, do número de plug-ins adicionais que estiver a utilizar e do número de ficheiros com que estiver a trabalhar, poderá ter de aumentar este número de forma concebível. O Eclipse permite transferir argumentos directamente para a Java VM utilizando o argumento de linha de comandos -vmargs, que deverá seguir-se a quaisquer outros argumentos específicos do Eclipse. Assim, para aumentar a memória de pilha disponível, deverá utilizar:

eclipse -vmargs -Xmx<memory size>

com o valor de <memory size> definido para superior a "384M" (384 megabytes -- a predefinição).

Ao utilizar um Oracle (Sun) VM, poderá precisar também de aumentar o tamanho da memória de geração permanente. O máximo predefinido é de 64 megabytes, mas poderá ser necessária mais memória dependendo da configuração do plug-in e da sua utilização. Quando a VM fica sem geração permanente de memória, pode falhar ou bloquear durante o carregamento de classes. Esta falha é menos comum quando usa a Sun JRE versão 1.5.0_07 ou superior. O tamanho máximo da geração permanente é aumentado utilizando o argumento -XX:MaxPermSize=<memory size>:

eclipse -vmargs -XX:MaxPermSize=<memory size>

Este argumento poderá não estar disponível para todas as versões e plataformas de VM; consulte a documentação da VM para obter mais informações.

Tenha em conta o facto de que a definição da memória para tamanhos superiores à quantidade de memória física disponível na máquina fará com que Java "vacile" enquanto copia objectos para trás e para a frente para a memória virtual, o que degradará em muito o desempenho.

Seleccionar um espaço de trabalho

Quando a área de trabalho é iniciada, a primeira coisa que apresentada é uma caixa de diálogo que lhe permite seleccionar onde deverá ser colocado o espaço de trabalho. O espaço de trabalho é o directório onde será armazenado o trabalho. Se não especificar o contrário, o Eclipse criará o espaço de trabalho no directório de utilizador. Este directório do espaço de trabalho é utilizado como a área de conteúdo predefinida para os projectos, bem como para manter quaisquer metadados necessários. Para instalações partilhadas ou com múltiplos espaços de trabalho deverá especificar de forma explícita a localização do espaço de trabalho utilizando a caixa de diálogo (ou através do argumento da linha de comandos "-data").

Especificar a máquina virtual Java

Esta é uma linha de comandos típica do Eclipse: 

eclipse -vm c:\jdk5u22\jre\bin\javaw

Sugestão: Recomenda-se que especifique de forma explícita qual a Java VM a utilizar quando executar o Eclipse. Isto é alcançado com o argumento da linha de comandos "-vm", tal como ilustrado acima. Se não utilizar "-vm", o Eclipse utilizará procurará no caminho de O/S. Ao instalar outros produtos baseados em Java, estes poderão alterar o seu caminho, resultando na utilização de uma Java VM diferente da próxima vez que iniciar o Eclipse.

Para criar um atalho no Windows para o Eclipse instalado, proceda da seguinte forma:

  1. Navegue até eclipse.exe no Explorador do Windows (Windows Explorer) e utilize Criar atalho (Create Shortcut) no menu de conteúdo.
  2. Seleccione o atalho e edite as suas propriedades. No campo Destino: acrescente os argumentos da linha de comandos.

Ao abrir o atalho, o Eclipse é iniciado. (É possível arrastar o atalho até ao ambiente de trabalho do Windows caso o pretenda manter num local fácil de alcançar.)

Mac OS X

Em Mac OS X, o Eclipse é iniciado através de um duplo clique na aplicação do Eclipse. Se necessitar de transferir argumentos para o Eclipse, deverá editar o ficheiro eclipse.ini existente no conjunto de programas do Eclipse: seleccione o ícone do conjunto de programas do Eclipse enquanto mantém premida a tecla Control. Será apresentado um menu emergente. Seleccione "Apresentar conteúdo do conjunto de programas" (Show Package Contents) no menu emergente. Localize o ficheiro eclipse.ini na sub-pasta Contents/MacOS e abra-o com o seu editor de texto preferido de forma a editar as opções da linha de comandos.

Em MacOS X, só pode iniciar mais do que uma vez um programa da UI se tiver cópias separadas do programa no disco. A razão deste comportamento prende-se com o facto de todas as aplicações da UI poderem abrir vários documentos, portanto, normalmente não é necessário abrir o programa duas vezes. Como o Eclipse não pode abrir mais do que um espaço de trabalho de cada vez, tem de fazer uma cópia da instalação do Eclipse se quiser abrir mais do que um espaço de trabalho de cada vez (erro 139319).

Caso necessite de iniciar o Eclipse a partir da linha de comandos, é possível utilizar a ligação simbólica "eclipse" existente no nível superior da pasta do Eclipse. Refere-se ao ficheiro executável do Eclipse existente no conjunto de programas da aplicação e utiliza os mesmos argumentos que "eclipse.exe" noutras plataformas.

Em Mac OS X 10.4 e posteriores, poderá notar uma maior lentidão no processamento ao trabalhar com um grande número de recursos caso permita que Spotlight execute a indexação do espaço de trabalho. Para evitar que tal aconteça, inicie Preferências do sistema (System Preferences), seleccione o ícone de Spotlight e, em seguida, o separador Privacidade (Privacy) e, em seguida, faça clique no botão Adicionar (Add) ("+") e localize o directório do espaço de trabalho na caixa de diálogo apresentada.

Instalação partilhada

A rapidez do arranque de uma instalação partilhada pode ser melhorada caso sejam armazenadas as informações de cache adequadas na área da instalação partilhada. Para tal, depois de descompactar a distribuição do Eclipse, execute-o uma vez com a opção "-initialize" a partir da conta que possui acesso de escrita ao directório da instalação.

Tópicos avançados sobre a execução do Eclipse

O executável do Eclipse e a própria plataforma oferecem uma quantidade de opções de execução de interesse para quem programa ou depura partes do Eclipse. Trata-se de uma lista das opções utilizadas de forma comum, para obter uma lista completa consulte a página de opções de tempo de execução do Eclipse no Platform Plug-in Developer Guide. O formato geral de execução do executável do Eclipse é:

eclipse [platform options] [-vmargs [Java VM arguments]]
Parâmetros de início do Eclipse
Comando Descrição Desde
-arch architecture
Define a arquitectura do processador em que a plataforma Eclipse está em execução. A plataforma Eclipse processa normalmente a definição optimizada utilizando o valor que prevalece da propriedade os.arch de Java. Se for aqui especificado, trata-se do valor utilizado pela plataforma Eclipse. O valor aqui especificado está disponível para plug-ins como Platform.getOSArch(). Valores exemplo: "x86", "sparc", "PA-RISC", "ppc". 2.0
-application applicationId
A aplicação a executar. As aplicações são declaradas por extensões fornecedoras de plug-ins para o ponto de extensão org.eclipse.core.runtime.applications. Este argumento normalmente não é necessário. Se for especificado, o valor substitui o valor facultado pela configuração. Se não for especificado, é executada a área de trabalho do Eclipse. 1.0
-clean
Elimina os dados colocados na memória cache utilizados pela estrutura OSGi e pelo ambiente de execução do Eclipse. Tente executar o Eclipse uma vez com esta opção caso observe erros de arranque após a instalação, a actualização ou quando utilizar uma configuração partilhada. 3.0
-configuration configURL
A localização do ficheiro de configuração da Plataforma Eclipse, expressa como um URL. O ficheiro de configuração determina a localização da plataforma Eclipse, o conjunto de plug-ins disponíveis e a função principal. Repare que não são permitidos os URLs relativos. O ficheiro de configuração é escrito nesta localização quando a plataforma Eclipse for instalada ou actualizada. 2.0
-consolelog
Replica o registo de erros da plataforma Eclipse para a consola utilizada para executar o Eclipse. É útil quando é combinado com -debug. 1.0
-data workspacePath
O caminho do espaço de trabalho em que vai executar a plataforma Eclipse. A localização do espaço de trabalho também é a localização predefinida para projectos. Os caminhos relativos são interpretados em relação ao directório onde foi iniciado o Eclipse. 1.0
-debug [optionsFile]
Coloca a plataforma no modo de depuração e carrega as opções de depuração do ficheiro numa determinada localização, caso seja especificado. Este ficheiro indica quais os pontos de depuração que estão disponíveis para um plug-in e se são ou não activados. Se não for facultada uma localização do ficheiro, a plataforma procura no directório em que foi iniciado o eclipse um ficheiro denominado ".options". São permitidos URLs e caminhos do sistema de ficheiros como localizações de ficheiros. 1.0
-dev [classpathEntries]
Coloca a plataforma no modo de programação. As entradas do caminho de classes opcionais (uma lista separada por vírgulas) são adicionadas ao caminho de classes de tempo de execução de cada plug-in. Por exemplo, quando o espaço de trabalho contém plug-ins que estão a ser desenvolvidos, se especificar -dev bin vai adicionar uma entrada de caminho de classes a cada directório do projecto do plug-in denominado bin, permitindo que ficheiros de classes recém-gerados se localizem aqui. São eliminadas as entradas dos caminhos de classes redundantes ou não existentes. 1.0
-initialize
Inicializa a configuração que está a ser executada. Todas as estruturas de dados e memórias cache relacionadas são actualizadas. Útil em instalações partilhadas: ao executar o Eclipse uma vez com esta opção a partir de uma conta com privilégios de escrita melhorará o desempenho do arranque. 3.0
-keyring keyringFilePath
A localização da base de dados de autorização (ou ficheiro do "conjunto de chaves mistas") no disco. Este argumento tem de ser utilizado em conjunto com a opção -password. Os caminhos relativos são interpretados em relação ao directório onde foi iniciado o Eclipse. 1.0
-nl locale
Define o nome do locale em que a plataforma Eclipse está em execução. A plataforma Eclipse processa normalmente a definição optimizada automaticamente. Se for aqui especificado, trata-se do valor utilizado pela plataforma Eclipse. O valor aqui especificado está disponível para plug-ins como Platform.getNL(). Valores exemplo: "en_US" e "fr_FR_EURO". 2.0
-nosplash
Executa a plataforma sem apresentar o ecrã de carregamento. 1.0
-os operatingSystem
Define o sistema operativo em que a plataforma Eclipse está em execução. A plataforma Eclipse processa normalmente a definição optimizada utilizando o valor que prevalece da propriedade os.name de Java. Se for aqui especificado, trata-se do valor utilizado pela plataforma Eclipse. O valor aqui especificado está disponível para plug-ins como Platform.getOS() e é utilizado para resolver ocorrências da variável $os$ nos caminhos mencionados no ficheiro manifest do plug-in. Valores exemplo: "win32", "linux", "hpux", "solaris", "aix". 1.0
-password password
A palavra-passe para a base de dados de autorização. Utilizado juntamente com a opção -keyring. 1.0
-perspective perspectiveId
A perspectiva a abrir na janela activa da área de trabalho no início. Se este parâmetro não for especificado, a perspectiva que estava activa no encerramento será aberta. 1.0
-plugincustomization
	  propertiesFile
A localização de um ficheiro de propriedades que contém predefinições para as preferências de plug-in. Estas predefinições substituem as predefinições especificadas na função principal. Os caminhos relativos são interpretados em relação ao directório onde foi iniciado o eclipse. 2.0
-product productId
O ID do produto a executar. O produto atribui à instância iniciada do Eclipse a respectiva personalidade, determinando as informações de personalização utilizadas. Esta substitui -feature, que ainda é suportada por questões de compatibilidade. 3.0
-refresh 
Opção para executar uma renovação global do espaço de trabalho no início. Esta acção irá reconciliar quaisquer alterações que tenham sido efectuadas no sistema de ficheiros desde a última execução da plataforma. 1.0
-showlocation [workspaceName]
Opção para apresentar a localização do espaço de trabalho na barra de título da janela. Na edição 2.0, esta opção apenas funcionou em conjunto com o argumento da linha de comandos -data. Na edição 3.2, foi adicionado um argumento de nome de espaço de trabalho opcional que apresenta o nome facultado na barra de títulos da janela em detrimento da localização do espaço de trabalho. 2.0
-vm vmPath
A localização do Java Runtime Environment (JRE) a utilizar para executar a plataforma Eclipse. Caso não tenha sido especificado, o lançador fará uma tentativa para localizar um JRE. Primeiro, será efectuada uma procura por um directório designado jre como equivalência do executável do Eclipse e, em seguida, far-se-á uma procura no caminho do sistema operativo. Os caminhos relativos são interpretados em relação ao directório onde foi iniciado o eclipse. 1.0
-vmargs args
Quando transmitida para o Eclipse, esta opção é utilizada para personalizar a operação da Java VM utilizada para executar o Eclipse. Se especificada, esta opção deve encontrar-se no final da linha de comandos. Os argumentos atribuídos dependem da VM que estiver a ser executada. 1.0

Todos os argumentos que se seguem (mas que não incluem) a entrada -vmargs são transmitidos directamente através da Java VM indicada como argumentos da máquina virtual (ou seja, antes da classe a executar). Nota: Se um argumento de início do Eclipse, como -data, for facultado depois dos argumentos da Java vm (-vmargs), o Eclipse não será iniciado e vai receber uma "JVM terminada. Código de saída=1" erro.