Componentes personalizados do Visual Mobile Designer: Criando um aplicativo gerenciador de informações pessoais

O Visual Mobile Designer (VMD) é uma interface gráfica do NetBeans Mobility que permite criar aplicativos móveis usando componentes de arrastar e soltar. O VMD permite definir o fluxo do aplicativo e criar a GUI usando os componentes fornecidos pelo IDE ou componentes que você mesmo criar. O VMD contém muitos componentes de Interface de usuário (IU) padrão que você pode usar para criar aplicativos 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 aplicativos 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 abertura, Caixa de texto e Alerta.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 6.9 e posterior

Para acompanhar este tutorial, são necessários os recursos e softwares listados abaixo.

Software ou recurso Versão necessária
NetBeans IDE com Java ME Versão 6.9 e posterior
Java Development Kit (JDK) Versão 6 e 7

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:

  1. Baixe PIMBrowserExample.zip
  2. Descompacte o arquivo.
  3. No IDE, escolha Arquivo > Abrir projetoe navegue até a pasta que contém os arquivos descompactados com o projeto PIMBrowserExample.
  4. Clique em Abrir projeto.
    A janela Projetos deve ter uma aparência semelhante a esta:
  5. Projeto com o exemplo do Navegador PIM aberto

  6. 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.
  7. Na janela Emulador, clique no botão abaixo de "Iniciar."
    O emulador exibe um componente Tela de abertura, em seguida, Navegador PIM, como mostrado:
  8. Emulador SDK 3.0 exibindo o aplicativo Navegador PIM de amostra

  9. Clique no botão superior direito do emulador para exibir os itens do menu como indicado abaixo:

    Emulador SDK 3.0 exibindo os ítems do menu

  10. Com o item Detalhes selecionado, clique no botão central no emulador para exibir os detalhes do contato:
  11. Emulador WTK 2.5 exibindo o aplicativo Navegador PIM de amostra

  • 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 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:

  1. Crie o projeto PIMBrowserExample
  2. Adicione pacotes e um MIDlet visual ao projeto
  3. Adicione componentes ao projeto
  4. Adicione comandos ao projeto
  5. Conecte os componentes para criar um fluxo de aplicativo
  6. Adicionar contatos ao banco de dados de contatos do Wireless Toolkit
  7. Executar o projeto

Criando o projeto PIMBrowserExample

  1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Java ME. Em Projetos, selecione Aplicativo móvel e clique em Próximo.
  2. 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.
  3. Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
  4. Selecione o Java (TM) Platform Micro Edition SDK 3.0 como a plataforma do emulador. Clique em Próximo.
  5. Na Seleção de mais configurações, clique em Terminar.
  6. Observação: 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

  1. Escolha o projeto PIMBrowserExample na vista do Projeto e, a seguir, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione Java. Em Tipos de arquivo, selecione Pacote Java. Clique em Próximo.
  2. Indique pimbrowserexample no campo Nome do pacote. Clique em Terminar.
  3. Escolha o pacote pimbrowserexample na vista do Projeto e, a seguir, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione MIDlet visual. Clique em Próximo.
  4. Indique PIMBrowserExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
    O aplicativo é exibida na janela Design de fluxo do Visual Mobile Designer.

Adicionando componentes ao projeto

  1. No Design de fluxo, arraste e solte os seguintes componentes da Paleta de componentes:
    • Tela de abertura
    • Alerta
    • Navegador PIM
  2. Clique em splashScreen e, na janela Propriedades, altere o valor Texto de null (nulo) para o PIM Browser Example.
  3. Clique em alert e, na janela Propriedades, altere o valor da propriedade Sting para Contact selected.

Adicionando comandos ao projeto

  1. No Design de fluxo Escolha o comando Sair na seção comandos da Paleta do componente.
  2. Arraste-o e solte-o no componente pimBrowser.

Conectando os componentes para criar um fluxo de aplicativo

No Design de fluxo, clique em Ponto de início no Dispositivo móvel e arraste-o para o componente splashScreen. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.

Mostra o Designer de fluxo com componentes conectados por linhas de comando

Adicionando contatos ao banco de dados de contatos do Wireless Toolkit

Copie o sample contact para a pasta javame-sdk no diretório do usuário $JAVAME-SDKHOME/3.0/work/0/appdb/PIM/contacts/Contacts/.
Esta pasta contém os três seguintes métodos como padrão:

  • 1.vcf
  • 2.vcf
  • categories.txt
  • Executando o projeto

    Pressione F6 para executar o projeto principal ou selecione Executar > Executar projeto principal.

    início

    Javadoc do componente do 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:

    1. Coloque o cursor no componente PIMBrowser no código-fonte e pressione Ctr-Shift-Espaço (ou selecione Código-fonte > Exibir documentação).
      O Javadoc deste elemento é exibido em uma janela pop-up.
    2. Clique em Exibir documentação no ícone de navegador da Web externo (Exibir documentação no navegador da Web externo) na janela pop-up para obter informações detalhadas sobre o componente PIMBrowser em seu navegador.

    início


    Consulte também

    início

    get support for the NetBeans

    Support


    By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo