Componentes padrão do Visual Mobile Designer: criando um aplicativo SMS Composer
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 Compositor SMS é um componente personalizado que fornece um mecanismo e uma interface de usuário para enviar mensagens curtas usando o SMS (Short Message Service).
Este componente utiliza a Wireless Messaging API JSR-120. Esta API não faz parte da especificação MIDP 2.0, assim, este componente personalizado só pode ser implantado em dispositivos que possuam suporte interno para a JSR-120.
Este tutorial mostra como usar o componente SMS Composer em um aplicativo móvel para dispositivos habilitados para Wireless Messaging API (WMA). Você aprenderá os recursos básicos deste componente e como enviar mensagens usando o SMS.
Além do componente personalizado SMS Composer, precisamos usar também dois outros componentes MIDP: Tela de splash e Alerta.
Nota: se estiver utilizando o NetBeans IDE 6.8, consulte o tutorial Criando um aplicativo SMS Composer no NetBeans IDE 6.8.
Conteúdo
Para levar a cabo este tutorial, são necessários os seguintes recursos e softwares.
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 SMSComposerExample:
- Baixe SMSComposerExample.zip.
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado com o projeto SMSComposerExample.
- 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.
- Na janela Emulador, clique no botão abaixo de
"Iniciar". O emulador exibe um componente Tela de splash, em seguida, SMS Composer, como mostrado:
- Mova o cursor para cima e para baixo para navegar nas opções disponíveis como Número de telefone ou Mensagem.
- Clique no botão central para ativar o campo de texto selecionado.
- Clique no botão "Enviar" abaixo para enviar a mensagem.
- Clique no botão abaixo de "Sair" para fechar o aplicativo.
início
Criando um aplicativo com o componente personalizado Compositor SMS
Agora que você viu o componente Compositor SMS em ação, vamos
voltar para o início e criar essa aplicativo. Para criar o aplicativo, faça o seguinte:
- Crie o projeto SMSComposerExample
- Adicione os pacotes e um MIDlet visual ao projeto
- Adicione componentes ao projeto
- Adicione comandos ao projeto
- Conectar os componentes para criar um fluxo de aplicativo
- Modifique a tarefa da tela de espera
- Executar o projeto
Criando o projeto
SMSComposerExample
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione JavaME. Em Projetos, selecione Aplicativo móvel e clique em Próximo.
- Indique
SMSComposerExample
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
SMSComposerExamplena janela 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
smscomposerexample
no campo Nome do pacote. Clique em Terminar.
- Escolha o pacote
smscomposerexample na janela 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
SMSComposerExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
O aplicativo é exibido na janela Design de fluxo do Visual Mobile Designer.
Adicionando componentes ao projeto
- Na janela Designer de fluxo, arraste e solte os componentes seguintes da Paleta de componentes:
- Tela de splash
- Compositor SMS
- Tela de espera
- Alerta (2x)
- Clique em slashScreen e, na janela Propriedades, altere o valor da propriedade Texto de null (nulo) para SMS Composer Example (Exemplo de compositor de SMS).
- Clique em alert e, na janela Propriedades, altere o valor da propriedade Título de alert para alertSent, da mesma forma, altere a propriedade Título de alert1 para alertError.
-
Clique em alert e, na janela Propriedades, altere o valor da propriedade String para Mensagem enviada, da mesma forma, altere a propriedade String no componente alertError para Erro.
- Clique em smsComposer e, na janela Propriedades, desmarque a propriedade Enviar automaticamente na categoria Propriedades do SMS.
Adicionando comandos ao projeto
- Abra o Designer de fluxo.
- Escolha o comando Sair na seção
Comandos da Paleta do componente. Arraste e solte-o no componente smsComposer no Designer de fluxo.
Conectando componentes para criar um fluxo de aplicativo
No Designer de fluxo, clique em Ponto de início no Dispositivo móvel e arraste-o para o componente Tela de splash. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.
Modificando a tarefa da tela de espera
Na categoria Recursos do Navegador, localize e clique com o botão direito do mouse no componente task, escolha Ir para código-fonte no menu pop-up. Na janela Código-fonte, localize a seção // write task-execution user code here" (escreva aqui o código do usuário para execução da tarefa) e substitua-a por smsComposer.sendSMS();.
Executando o projeto
Pressione <F6> para executar o projeto principal. Como alternativa, você pode selecionar Executar > Executar projeto principal.
início
Javadoc para o componente SMS Composer
O NetBeans IDE oferece Javadocs de API do componente SMSComposer, assim como outros componentes que você pode usar no VMD. Para ler os Javadocs do componente SMS Composer:
- Coloque o cursor no componente SMSComposer 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 SMSComposer no seu navegador.
início
Consulte também
início
