É possível criar um projeto de plug-in a partir de um arquivo JAR
binário existente. Esse método é útil em situações em que haja restrições de licenciamento
ou o arquivo binário não possa ser extraído. Entretanto,
um pacote configurável OSGi que contenha um arquivo JAR não é suportado em um
ambiente de JVM compartilhado.
Sobre Esta Tarefa
Esta tarefa cria um novo projeto de plug-in OSGi a partir de um arquivo JAR
binário existente. O arquivo JAR precisa estar no sistema de arquivos local.
Procedimento
- Na barra de menus do Eclipse, clique em Arquivo > Novo > Projeto para
abrir o assistente Novo.
- Expanda a pasta Desenvolvimento de Plug-in
e clique em Plug-in a Partir de Arquivos JAR Existentes.
Clique em Avançar. O diálogo de seleção de JAR
é aberto.
- Localize o arquivo JAR a ser convertido. Se o arquivo estiver em sua
área de trabalho do Eclipse, clique em Incluir. Se o arquivo estiver em uma
pasta em seu computador, clique em Incluir Externo e
navegue até o arquivo JAR. Selecione o arquivo necessário e clique em Abrir para
incluí-lo no diálogo de seleção de JAR. Clique em Avançar. O diálogo Propriedades do Projeto de Plug-in é aberto.
- No campo Nome do projeto, insira
o nome do projeto que você deseja criar. Um nome de projeto
é obrigatório.
- Preencha os seguintes campos na seção Propriedades do Plug-in
conforme necessário:
- ID do Plug-in
- O ID do plug-in é gerado automaticamente a partir do nome do projeto,
porém é possível alterar o ID se você desejar.
- Nome do Plug-in
- O nome do plug-in é gerado automaticamente a partir do nome do projeto,
porém é possível alterar o nome se você desejar.
- Ambiente de Execução
- Esse campo especifica o nível mínimo de JRE necessário para a execução
do plug-in. Selecione o nível de Java™
que corresponde ao ambiente de execução em sua plataforma de destino de tempo de execução do CICS.
- Na seção Plataforma de Destino, selecione uma estrutura
OSGi e selecione padrão no
menu.
- Certifique-se de que Descompactar os arquivos JAR para o
projeto não esteja selecionado e clique em Concluir. O Eclipse cria o projeto de plug-in na área de trabalho. O projeto
contém o arquivo JAR binário mas o projeto não é suportado em um
ambiente de JVM compartilhado.
- Necessário: Requisito: Você deve
agora editar o arquivo de manifesto do plug-in e incluir as dependências da API JCICS.
Se você não executar essas etapas, será capaz de exportar e instalar o
pacote configurável, mas ele não poderá ser executado.
- Na visualização do Package Explorer, clique com o botão direito do mouse no nome do
projeto e clique em Ferramentas PDE > Abrir Manifesto. O arquivo de manifesto é aberto no editor de manifesto.
- Selecione a guia Dependências e, na seção
Pacotes Importados, clique em Incluir. O diálogo Seleção de Pacote é aberto.
- Selecione o pacote com.ibm.cics.server e
clique em OK. O pacote é exibido na lista
de Pacotes Importados.
- Opcional: Opcional: Repita a etapa anterior para instalar o seguinte pacote, se necessário, para o seu aplicativo:
Tabela 1. Pacote |
Descrição |
com.ibm.record |
A API Java para programas legados que usam IByteBuffer da
Estrutura de Registro Java que era fornecida com o VisualAge. Anteriormente
no arquivo dfjcics.jar. |
- Pressione Ctrl +S para salvar o arquivo de manifesto.
Resultados
Você criou com êxito o projeto de plug-in na
área de trabalho. Entretanto, você deve agora atualizar o arquivo de manifesto para incluir uma
declaração CICS-MainClass. Para obter informações adicionais, consulte os links relacionados.