Componentes personalizados do Visual Mobile Designer: Navegador PIM
Contribuição de Karol Harezlak
O Visual Mobile Designer (VMD) é uma interface gráfica do NetBeans Mobility pack que permite a você criar aplicações móveis usando componentes de arrastar e soltar. O VMD permite que você defina o fluxo da aplicação e crie a sua GUI usando os componentes fornecidos pelo Mobility pack, ou componentes que você mesmo cria. O VMD contém muitos componentes Interface de usuário (IU) padrão
que você pode usar para criar aplicações como Listas, Alertas, Formulários e
Imagens. Ele também inclui componentes personalizados que simplificam a criação de recursos mais complexos, tais como Telas de espera, Telas de abertura, Itens de tabela, etc.
O Navegador PIM é um componente personalizado que fornece acesso fácil a funções de dispositivos móveis padrão como calendário, bloco de endereços ou lista de tarefas. Você pode usar o componente Navegador PIM para ativar aplicações Java móveis para acessar os bancos de dados de informações pessoais armazenados localmente. Este componente utiliza os Pacotes opcionais de PDA da API do PIM (Personal Information Management) que é uma parte da especificação JSR-75s para a Plataforma
Java ME. Como a JSR-75 não é uma parte da especificação MIDP 2.0, ela é por definição um componente personalizado e só pode ser usada com os dispositivos ativados por JSR-75.
Visão geral da aplicação
Este exemplo mostra como usar o componente Navegador PIM em uma aplicação móvel para dispositivos ativados por JSR-75. Ela demonstra os recursos básicos do componente , tal como a navegação de conteúdo de um banco de dados de contados, Calendário ou Lista de tarefas pendentes. Além do Navegador PIM, também precisamos usar três outros componentes: Tela de abertura, Caixa de texto e Alerta.
Requisitos de software
Antes de começar, você deve instalar o seguinte software no seu computador:
- NetBeans IDE 6.0 com Mobility pack (download)
- Java Standard Development Kit (JDK) versão 6.0 (download)
Caso não conheça o NetBeans Mobility Pack, você deve começar
com o Guia de início rápido do NetBeans 6.0
Mobility CLDC/MIDP antes de continuar.
Instalando e executando a aplicação de amostra
Antes de começar, talvez você queira ver o resultado final do
tutorial.
Siga as etapas seguintes para instalar a aplicação PIMBrowserExample:
- Baixe pimbrowserexample.zip
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir
projeto e vá para a pasta que contém o arquivo descompactado.
- Abra as janelas Projeto e Navegador. Ela deve ser parecida com o seguinte:
- Na janela Projetos, clique com o botão direito do mouse no nó do projeto e escolha Executar projeto (ou pressione a tecla F6). Conforme a aplicação é executada, uma janela do emulador se abre e exibe a aplicação que está sendo executada no emulador do dispositivo padrão.
- Na janela Emulador, clique no botão abaixo de
"Iniciar."
O emulador exibe um componente Tela de abertura,
em seguida, Navegador PIM, como mostrado:
- Detalhes do contato
- Mova o cursor para cima e para baixo para
navegar pelas posições disponíveis.
- Clique no botão abaixo de "Voltar" para voltar para a lista de contatos.
- Clique no botão abaixo de "Sair" para fechar a
aplicação.
Criando uma aplicação com o componente personalizado Navegador PIM
Agora que você viu o componente Navegador PIM em ação, vamos
voltar para o início e criar essa aplicação. Para criar a aplicação, faça o seguinte:
- Crie o projeto
PIMBrowserExample
- Adicione pacotes e um
MIDlet visual ao projeto PIMBrowserExample
- Adicione
componentes ao PIMBrowserExample
- Adicione
Comandos aos componentes Navegador PIM
- Conecte os
componentes para criar um fluxo de aplicação
- Adicionando contato ao banco de dados de contatos do
Wireless Toolkit
- Executar o projeto
Criando o projeto
PIMBrowserExample
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Móvel. Em Projetos, selecione Aplicação MIDP e clique em Próximo.
- Indique
PIMBrowserExample
no campo Nome do projeto. Altere a Localização do projeto para um diretório em seu sistema. A partir de agora, vamos chamar esse diretório
de $PROJECTHOME.
- Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
- Deixe o Java ME Wireless Toolkit
como a Plataforma de destino selecionada. Clique em Próximo.
- Clique em Terminar.
A pasta do projeto contém todos os códigos-fonte e os metadados do projeto, como o script Ant do projeto. A
própria aplicação é exibida na janela Design de fluxo do
Visual Mobile Designer.
Adicionando pacotes e um
MIDlet visual ao projeto PIMBrowserExample
- Escolha o projeto
PIMBrowserExample
na janela Projeto, em seguida, escolha Arquivo > Novo arquivo
(Ctrl-N) . Em Categorias, selecione Classes Java. Em Tipos de arquivo,
selecione Pacote Java. Clique em Próximo.
- Indique
pimbrowserexample
no campo Nome do pacote. Clique em Terminar.
- Escolha o pacote
pimbrowserexample
na janela Projeto, em seguida, escolha Arquivo > Novo arquivo
(Ctrl-N) . Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione
Visual MIDlet. Clique em Próximo.
- Indique
PIMBrowserExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
Adicionando componentes ao
PIMBrowserExample
- Alterne seu Visual MIDlet para a janela
Designer de fluxo. Arraste os seguintes componentes da Paleta de componentes e solte-os no Designer de fluxo:
- Tela de abertura
- Alerta
- Navegador IM
- Clique em slashScreen e, na janela Propriedades, altere o
valor da propriedade Texto de "null" para "Exemplo
do Navegador PIM"
- Clique no componente Alerta e, na janela Propriedades, altere o
valor da propriedade String para "Contato selecionado"
Adicionando comandos ao
PIMBrowserExample
- Abra a janela Designer de fluxo.
- Escolha o comando Sair na seção
Comandos da Paleta do componente. Arraste-o e solte na janela
Designer de fluxo (componente pimBrowser).
Conectando componentes
- Na janela Design de fluxo, clique em Ponto de início no
Dispositivo móvel e arraste-o para o componente Tela de abertura. Da mesma
forma, conecte os componentes como mostrado no gráfico seguinte.
Adicionando contatos ao banco de dados de contatos do
Wireless Toolkit
Copie o contato de amostra
para a pasta WTK $WTKHOME/appdb/DefaultColorPhone/pim/contacts/Contacts/. Esta pasta fica vazia por "padrão",
portanto, é necessário copiar pelo menos um arquivo (contato) para testar o exemplo do Navegador PIM.
Mais informações sobre o armazenamento de persistência do WTK estão disponíveis no Sun Java
Wireless Toolkit para CLDC User's Guide (seção: 4.3.2.1 Persistent
Storage) Using
the Emulator
Executando o projeto
- Pressione <F6> para executar o projeto principal ou selecione Executar > Executar projeto principal.
Para saber mais sobre o componente Navegador PIM
O NetBeans IDE oferece Javadocs de API do componente Navegador PIM, assim como outros componentes que você pode usar no VMD. Para
ler os Javadocs do componente Navegador PIM, faça o seguinte:
- Escolha Ajuda > Referências de Javadoc
> org.netbeans.microediton.lcdui.pda. O arquivo é aberto em um navegador da Web.
- Clique em
org.netbeans.microedition.lcdui.pda para ver os links das informações do componente.
Tutoriais relacionados
