Directrizes de instalação de produtos

A plataforma proporciona ferramentas padrão para actualizar e estender produtos.  Para poder participar nos mecanismos da plataforma para actualizar e estender produtos, o pacote do seu produto deve respeitar as seguintes directrizes.  Assim poderá o produto coexistir pacificamente com, ou até aperfeiçoar, outros produtos baseados em Eclipse.

Considere novamente a estrutura de directórios exemplo para o produto acmeweb:

acmeweb/
	acmeweb.exe
	eclipse/	
		.eclipseproduct	
		eclipse.exe	
		startup.jar	
		install.ini	
		.config/	
			platform.cfg
		jre/
		features/	
			com.example.acme.acmefeature_1.0.0/
				feature.xml
			...
		plugins/
			com.example.acme.acmefeature_1.0.0/
				plugin.xml
				about.ini
				about.html
				about.mappings
				about.properties
				acme.png
				plugin_customization.ini
				splash.jpg
				welcome.xml
			com.example.acme.acmewebsupport_1.0.0/
			...
		links/
			...

De onde vêm estes ficheiros?  Vejamos o conteúdo do produto na perspectiva da equipa de desenvolvimento.  Os ficheiros instalados podem ser agrupados em cinco categorias principais:

Um script de instalação correcto produzirá a estrutura de directórios correcta através do seguinte:

Questões multi-utilizador

Quando um produto é instalado com a intenção de partilhar a instalação por vários utilizadores, é preciso cuidado para separar dados de utilizador individual (como, por exemplo, o directório do espaço de trabalho) do directório de instalação do produto partilhado.

Questões de desinstalação

Quando se desinstala um produto, os conceitos que se seguem são importantes.

Reinstalar o produto

Quando o produto já está instalado, o instalador deve permitir uma actualização de serviço se a mesma estiver disponível.  A existência do produto pode confirmar-se vendo o caminho acmeweb/eclipse/.eclipseproduct. As informações neste ficheiro marcador podem ser utilizadas para confirmar junto do utilizador se está a ser actualizado o produto correcto.  A disponibilidade das actualizações pode confirmar-se com correspondências de padrões com nomes de funções.  Por exemplo, a presença de acmeweb/eclipse/plugins/com.example.acmefeature_1.0.1 indica que já foi aplicada a actualização da versão 1.0.1 ao produto.

Uma vez estabelecida a validade da reinstalação, o programa de instalação deve copiar ou substituir ficheiros conforme o necessário.  Se a versão da plataforma Eclipse subjacente não tiver sido alterada, é muito provável que se possam ignorar directórios completos.  Os números de versão anexados às funções e aos plug-ins da plataforma podem ser utilizados para determinar se são necessárias alterações abaixo do directório de um plug-in ou uma função.  

Encontram-se informações adicionais sobre instalação de produtos em Como escrever um instalador de Eclipse.