Exemplo - Atualização de Software

Introdução

Este exemplo demonstra como instalar componentes adicionais para a plataforma Eclipse. Ele está contido no plug-in org.eclipse.update.examples .
 

Executando o exemplo

Para executar o exemplo, será necessário ter um servidor HTTP disponível (por exemplo, Servidor Apache ). Copie o diretório de instalação inteiro para o plug-in de exemploorg.eclipse.update.examples na árvore do documento do servidor HTTP (por exemplo, o diretório htdocs para o servidor Apache). Certifique-se de que o servidor esteja funcionando.

Inicie o workbench do Eclipse. Selecione Ajuda, Atualização de Software e Incluir...
Na página de localização informe o URL do servidor (por exemplo, http://my.server/ ... complete com o URL do servidor). O URL precisa   refletir quaisquer elementos do caminho do servidor adicional dirigido para o diretório deinstalação copiado. Por exemplo, se você copiou o diretório de instalação em htdocs/examples (então o caminho será htdocs/examples/install), será preciso digitar o URL como http://my.server/examples.
Pressione Incluir e Avançar>. Uma lista contendo os componentes para instalação será apresentada. O exemplo fornecido contém só um componente chamado Exemplo de Atualização. Selecione-o e complete a instalação. Será necessário iniciar o workbench novamente para ativar as alterações.

Assim que reiniciar, você poderá ver a função do novo exemplo incluindo-o na perspectiva. Selecione Perspectiva, Personalizar... e expanda Outro. Selecione Conjunto de Ações de Amostra (esse é um conjunto de ações implementados pelo plug-in de exemplo que você acabou de fazer o download e de instalar). Um novo menu chamado Menu Amostra deverá aparecer no workbench com uma nova ação. Clicar no menu de ação exibirá uma caixa de informações (para verificar se a instalação realmente funcionou).
 

Detalhes

Esse exemplo ilustra a estrutura necessária no servidor HTTP para fazer o download dos componentes do Eclipse. O exemplo consiste em um plug-in que inclui um menu e uma ação para o workbench. O plug-in é um pacote como um componente jar usando as ferramentas de Desenvolvimento de Plug-in no workbench do Eclipse (PDE). Observe que o diretório base do plug-in para org.eclipse.update.examples não contém o arquivo plugin.xml. Conseqüentemente, o plug-in base não contribui com o workbench. O plug-in base contém um diretório de instalação usado nos passos anteriores.

O diretório de instalação copiado para o servidor HTTP é a saída da construção de um componente jar usando a configuração de Projeto de Componente PDE (com um arquivo extra "servidor-de-reserva" incluso). Ele contém o seguinte:

instalação/
    componentes/
        install.index
        org.eclipse.update.examples.component_1.0.0/
            install.xml
            install.properties
            install_en.properties
            orq.eclipse.update.examples.component_1.0.0.jar

A estrutura do diretório acima é necessária para o servidor. Há uma raiz de instalação comum. Há também um subdiretório de componentes comuns. Ele contém um subdiretório para cada componente disponível para download (no caso do exemplo, somente um, org.eclipse.update.examples.component_1.0.0). O arquivo install.index foi criado manualmente (não foi gerado pelo PDE). É um índice de diretório simples dos diretórios de componentes (uma linha por diretório). Isso permite que o cliente descubra quais diretórios de componentes realmente existem no servidor.

O componente real criado pelo PDE está contido em orq.eclipse.update.examples.component_1.0.0.jar. Seu arquivo install.xml que descreve o componente também é exposto para permitir que o suporte de atualização descubra sobre os componentes sem precisar realmente fazer download do jar. Os arquivos install[_locale].properties contêm cadeias separadas.

Consulte a documentação PDE para obter mais detalhes da criação de componentes jars. Selecione Ajuda, Conteúdo da Ajuda e Guia ISV PDE (na caixa drop). Consulte a documentação da plataforma Eclipse para obter detalhes adicionais das convenções de instalação. Selecione Ajuda, Conteúdo da Ajuda e Guia do Desenvolvedor de Plug-In (na caixa drop). As informações de instalação estão contidas na seção Referência, Outros Artigos de Referência, Atualização e Instalação da Plataforma.
 

Copyright IBM Corp. 2000, 2001.  Todos os direitos reservados.