Componentes padrão do Visual Mobile Designer: criando um aplicativo de gerenciador de informações pessoais
O Visual Mobile Designer (VMD) é uma interface gráfica do NetBeans Mobility que permite criar aplicações móveis usando componentes de arrastar e soltar. O VMD permite definir o fluxo da aplicação e criar a GUI usando os componentes fornecidos pelo IDE ou os componentes criados por você. 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 splash, Itens de tabela, etc.
O Navegador PIM é um componente personalizado que oferece acesso fácil a funções padrão dos dispositivos móveis como calendário, catálogo 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.
Este tutorial mostra como usar o componente Navegador PIM em um aplicativo 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 splash, Caixa de texto e Alerta.
Nota: se estiver utilizando o NetBeans IDE 6.8, consulte o tutorial Criando um aplicativo gerenciador de informações pessoais no NetBeans IDE 6.8.
Conteúdo
Para levar a cabo este tutorial, são necessários os seguintes recursos e softwares.
Se ainda não estiver familiarizado com o NetBeans Mobility, antes de continuar seria recomendável ler o Guia de início rápido do NetBeans Java ME MIDP.
Instalando e executando o aplicativo de amostra
Antes de começar, talvez você queira ver o resultado final do
tutorial.
Siga as etapas seguintes para instalar o aplicativo PIMBrowserExample:
- Baixe PIMBrowserExample.zip.
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado com o projeto PIMBrowserExample.
- Clique em Abrir projeto.
A janela Projetos deve ter uma aparência semelhante a esta:
- Na janela Projetos, clique com o botão direito do mouse no nó do projeto e escolha Executar projeto (ou pressione F6). Conforme o aplicativo é executado, uma janela do emulador se abre e exibe o aplicativo que está sendo executado no emulador do dispositivo padrão.
Nota: a lista de contatos está vazia por padrão. Consulte Adicionando contatos ao banco de dados de contatos do Wireless Toolkit para obter informações sobre como preencher a lista de contatos.
- Na janela Emulador, clique no botão abaixo de
"Iniciar."
O emulador exibe um componente Tela de splash,
em seguida, Navegador PIM, como mostrado:
- Clique no botão central para exibir os detalhes de contato:
- Mova o cursor para cima e para baixo para
navegar pelas posições disponíveis.
- Clique no botão "Voltar" abaixo para voltar para a lista de contatos.
- Clique no botão abaixo de "Sair" para fechar o aplicativo.
início
Criando um aplicativo 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 aplicativo. Para criar o aplicativo, faça o seguinte:
- Crie o projeto PIMBrowserExample
- Adicione os pacotes e um MIDlet visual ao projeto
- Adicione componentes ao projeto
- Adicione comandos ao projeto
- Conecte componentes para criar um fluxo de aplicativo
- Adicione contatos 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 Java ME. Em Projetos, selecione Aplicativo móvel 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 Sun Java Wireless Toolkit como a plataforma do emulador selecionada. Clique em Próximo.
- Clique em Terminar.
Nota: a pasta do projeto contém todos os códigos-fonte e metadados do projeto, como o script Ant do projeto.
Adicionando pacotes e um
MIDlet visual ao projeto
- Escolha o projeto
PIMBrowserExample na visualização Projeto, em seguida, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione 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 visualização Projeto, em seguida, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione
MIDlet visual. Clique em Próximo.
- Indique
PIMBrowserExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
O aplicativo é exibido na visualização Fluxo do Visual Mobile Designer.
Adicionando componentes ao projeto
- No Designer de fluxo, arraste e solte os componentes seguintes da Paleta de componentes:
- Tela inicial
- Alerta
- Navegador PIM
- Clique em splashScreen e, na janela Propriedades, mude o valor Text (Texto) de null (nulo) para Exemplo do navegador PIM.
- Clique em alert (alerta) e, na janela Propriedades, mude o valor da propriedade String para Contato selecionado.
Adicionando comandos ao projeto
- No Designer de fluxo, escolha o comando Sair na seção Comandos da Paleta de componentes.
- Arraste e solte-o na janela no componente pimBrowser.
Conectando componentes para criar um fluxo de aplicativo
No Designer de fluxo, clique em Iniciado no dispositivo móvel e arraste-o para o componente splashScreen. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.
Adicionando contatos ao banco de dados de contatos do Wireless Toolkit
Copiar o contato de amostra na pasta j2mewtk no diretório $J2MEWTKHOME/2.5.2/appdb/DefaultColorPhone/pim/contacts/Contacts/. Este pasta está vazia por padrão, de modo que é necessário copiar no mínimo um arquivo (contato) para testar o projeto PIMBrowserExample.
Executando o projeto
Pressione F6 para executar o projeto principal ou selecione Executar > Executar projeto principal.
início
Javadoc para o componente Navegador PIM
O NetBeans IDE oferece Javadocs de API do componente PIMBrowser, assim como outros componentes que você pode usar no VMD. Para ler os Javadocs do componente PIMBrowser, faça o seguinte:
- Coloque o cursor no componente PIMBrowser e pressione Ctrl-Shift-Barra de espaço (ou escolha Código-fonte > Mostrar documentação).
O Javadoc para este elemento é exibido em uma janela suspensa.
- Clique em Mostrar documentação no ícone do navegador da Web externo (
) na janela pop-up para visualizar informações detalhadas sobre o componente PIMBrowser no seu navegador.
início
Consulte também
início
