Guia de início rápido do Mobility Pack do NetBeans para CDC 5.5.1

Introdução

Um aplicativo CDC é criado para ser executado em um dispositivo portátil ou sem fio que tenha pelo menos 2 MB de memória. Essa configuração suporta uma JVM com mais recursos do que os telefones celulares, que geralmente possuem de 128 a 512 KB de memória e usam Connected Limited Device Configuration (CLDC).

Este documento o orienta através dos fundamentos básicos do uso do Mobility Pack do NetBeans para CDC 5.5 a fim de criar um aplicativo da Plataforma Java, Micro Edition (plataforma Java ME), Connected Device Configuration (CDC). O guia conduz você através das etapas básicas da criação de um novo projeto CDC. Mostraremos quatro maneiras de criar um projeto Java ME CDC que exibe um formulário simples em um emulador do dispositivo; uma forma para cada perfil e uma para os dispositivos Mobile Windows. Este documento destina-se a ajudá-lo a começar o mais rapidamente possível.

As seções deste guia são:

• Requisitos de software
• Adicionando plataformas de emulador
• Criando um aplicativo CDC
  • Perfil Foundation
  • Perfil Personal
  • Perfil AGUI
  • Aplicativo Windows CE (usando a NSIcom CrEme VM)
• Próximas etapas

Requisitos de software

Os requisitos de software e de hardware do Mobility Pack CDC estão listados nas Notas de versão do Mobility Pack do NetBeans para CDC 5.5.1.

Adicionando plataformas de emulador

O Mobility Pack do NetBeans é compatível com as seguintes plataformas do emulador:

• Sun Java Toolkit para CDC 1.0
• Ricoh Embedded Software Architecture Emulator 1.14c
• UIQ SDK 3
• Dispositivos Sony Ericsson M600 e P990
• Plataforma Nokia Series 80 SDK para sistema operacional Symbian, para Java, perfil Personal
• Emulador NSI.com CrEME
• Sistema operacional SavaJe

As instruções para a adição de plataformas do emulador estão listadas no Guia de instalação do Mobility Pack NetBeans para CDC 5.5.1.

Criando um aplicativo CDC

Nesta seção criaremos um projeto de aplicativo CDC para cada perfil disponível e, para as plataformas Personal e AGUI, criaremos uma GUI para o aplicativo usando o Construtor de GUIs do IDE. Finalmente, criaremos um aplicativo para o Windows CE usando a NSIcom CreME VM.

Os Perfis descritos são:

• Perfil Foundation (Ricoh)
• Perfil Personal (Nokia, Sony Ericsson)
• AGUI (Sun Java Toolkit, SavaJe)
• Windows CE (NSIcom CrEme)

Criando um novo aplicativo CDC - Perfil Profile

Aqui iremos criar um applet para o Perfil Personal usando a Plataforma Nokia Series 80 SDK para sistema operacional Symbian, para Java, Perfil Personal. A plataforma Sony Ericsson também loferece suporte ao Perfil Personal.

Construindo arquivos de distribuição

Agora você está pronto para finalizar o seu aplicativo. Clique com o botão direito do mouse no projeto e escolha Construir pacote de destino. O IDE cria o arquivo SIS na pasta PROJECT_HOME/target. Você pode ver esse arquivo na janela Arquivos. Se você especificou parâmetros adicionais, como certificado, chave privada e senha, o IDE também assinará o arquivo SIS para você.

Para construir um projeto Nokia, use também o comando Construir SIS. Embora a criação de uma compilação SIS para Nokia ainda não seja suportada, você pode implantar o aplicativo usando o arquivo JAR criado em PROJECT_HOME/dist.

Criando um novo aplicativo CDC - Perfil AGUI

Aqui iremos criar um aplicativo CDC, ou Xlet, para o Perfil AGUI usando o Sun Java Toolkit para CDC 1.0. O Perfil AGUI também é suportado pela plataforma do sistema operacional SavaJe.

Observação: Para obter mais informações sobre o desenvolvimento para a plataforma SavaJe, consulte "Desenvolvendo para a plataforma SavaJe".

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N) na janela principal.
2. Em Categorias, selecione CDC. Em Projetos, selecione Aplicativo CDC. Clique em Próximo.
3. Na página Selecionar plataforma, use o menu suspenso para escolher DefaultColorPhone como o Dispositivo. Deixe as configurações de Plataforma e Perfil conforme elas estão.
   
   
   
4. No painel Novo aplicativo CDC:
• Nomeie o projeto de newcdc.
• Você deseja criar uma classe Principal, embora ela seja realmente uma classe Xlet e não uma classe Java SE, com main().
• Altere o pacote/nome da classe para Mainxlet.
• O nome do aplicativo é o nome que será mostrado como o título do pacote (no menu Meu aplicativo).

5. Clique em Finalizar. O IDE cria o novo aplicativo e abre o formulário da classe principal no Construtor de GUIs, como mostrado na figura a seguir.
   
   

Criando a interface do aplicativo usando o Construtor de GUIs do Projeto Matisse

Você pode usar o Construtor de GUIs do Projeto Matisse da mesma forma que o usa para o desenvolvimento J2SE comum. No Construtor de GUIs, clique com o botão direito do mouse no formulário Main.java e escolha Layout > Layout livre. Em seguida, arraste e solte os componentes da janela Paleta para a Área de design do Construtor de GUIs. Certifique-se de utilizar somente componentes Swing em seu formulário. Como a plataforma AGUI oferece suporte a Swing, somente elementos Swing estão disponíveis.

Para obter mais informações sobre o uso do Construtor de GUIs da IDE, consulte o Caminho do aprendizado das GUIs Java e do Projeto Matisse.

Ao terminar, clique com o botão direito do mouse no projeto na janela Projetos e escolha Executar projeto. Seu aplicativo deve ser exibido no emulador do dispositivo.

Você também pode depurar o projeto, além de criar e depurar testes usando a estrutura JUnit.

Criando um novo aplicativo CDC para Windows CE (usando a CrEme VM)

A NSIcom CrEme VM permite que você crie e execute aplicativos Java Swing de dispositivos que estejam executando o Windows CE.

Criando um aplicativo

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N) na janela principal.
2. Em Categorias, selecione CDC. Em Projetos, selecione o modelo de aplicativo CDC. Clique em Próximo.
3. Na página Selecionar plataforma, escolha pJSCP V4.10. Clique em Próximo.
   
   
   
4. Nomeie o seu projeto (por exemplo, meuprimeiroaplicativocreme). Clique em Finalizar.
5. Na janela do Explorer, clique com o botão direito do mouse no nó Pacotes de origem do seu projeto e escolha Novo > Formulário JFrame. Clique em Finalizar. O Construtor de GUIs do NetBeans (Matisse) exibe o novo formulário.
   
   
   
   

   Observação: Certifique-se de que o primeiro fragmento de código do método main() seja mostrado conforme ilustrado abaixo quando você for executar o aplicativo no emulador CrEme padrão . Isso garantirá que o Swing está carregado.

   try {
       UIManager.setLookAndFeel(UIManager.getCrossPlatformLookAndFeelClassName());
   } catch(Exception exception) {
       System.out.println("Error loading L&F: " + exception);
   } 

6. Use o construtor de GUIs do Projeto Matisse para criar o seu aplicativo. Você pode usar o Construtor de GUIs do Projeto Matisse da mesma forma que o usa para o desenvolvimento J2SE comum.

   Observe que se houver uma exceção que trave o emulador, o emulador a imprimirá na janela de saída padrão e aguardará até que uma tecla seja pressionada. Entretanto, você não pode enviar o pressionamento de tecla a partir do IDE. Em vez disso, você deve encerrar a VM a partir do Explorador de processos.

Compilando e executando o aplicativo em um dispositivo ou emulador

1. Conecte o seu dispositivo móvel usando um cabo ou Bluetooth.
   Se você possui um dispositivo, vá para a etapa 12.
   Se você não possui um dispositivo, instale o Microsoft Device Emulator e o driver de rede de máquina virtual do Microsoft Device Emulator, conforme descrito no Guia de instalação do Mobility Pack do NetBeans para CDC 5.5.1. Em seguida, siga as etapas 2 a 4.
   Se você possui um dispositivo, vá para a etapa 5.
2. Inicie o Microsoft Device Emulator, escolhendo Iniciar > Programas > Microsoft Windows Mobile 5.0 MSFP Emulator Images > Pocket PC Coldboot. Isso abre o emulador do Pocket PC.
   
   
3. Escolha Iniciar > Programas > Microsoft Windows Mobile 5.0 MSFP Emulator Images > Device Emulator Manager. Isso abre o Device Emulator Manager.
   
   
4. No Device Emulator Manager, escolha Ações > Base.
5. Abra o ActiveSync, clicando no ícone na bandeja do aplicativo.
   Se você não possui o ActiveSync instalado, baixe-o e instale-o conforme descrito no Guia de instalação do Mobility Pack do NetBeans para CDC 5.5.1.
   
   Quando você abre o ActiveSync, ele deve detectar e se conectar ao dispositivo ou ao emulador do dispositivo.
   Caso contrário:
   1. Clique no ícone ActiveSync na bandeja do aplicativo.
   2. Escolha Arquivo > Configurações de conexão.
   3. Adote um ou ambos procedimentos abaixo:
   • Marque a caixa de seleção Permitir conexões a um dos seguintes e selecione DMA para o emulador, USB ou número da porta para um dispositivo real.
   • Escolha Executar conexão, que deve detectar o dispositivo automaticamente.
6. Faça o download e instale a CrEme VM em seu dispositivo (download). Clique duas vezes no arquivo baixado.
   Ele será instalado em seu PC e em seu dispositivo.
7. Faça o download e instale as extensões Swing (CrE-ME410_swing.CAB) para o seu dispositivo em NSIcom (download).
   Para instalar as extensões Swing em seu dispositivo ou emulador de dispositivo:
   1. Na caixa de diálogo ActiveSync, escolha Ferramentas > Explorar dispositivo.
      O dispositivo móvel é aberto em uma janela do Explorer.
   2. Copie CrE-ME410_swing.CAB para a janela do Explorer.
   3. No dispositivo ou emulador do dispositivo, escolha Iniciar > Programas > Explorador de arquivos.
   4. Inicie o CrE-ME410_swing.CAB.

Execute o aplicativo

1. Clique com o botão direito do mouse no projeto e escolha Propriedades.
   A página Propriedades é aberta.
2. Em Categorias, selecione Geral.
3. Selecione a guia NSIcom e marque Executar na VM remota. Clique em OK para fechar a página Propriedades.
   
   
4. Escolha Executar > Executar aplicativo principal.

 

Próximas etapas

Além do sistema de ajuda interno, o Mobility Pack do NetBeans para CDC é documentado através de uma série de tutoriais e artigos. Para obter informações sobre o Java ME, recursos de desenvolvimento de CDC compatíveis com o Mobility Pack para CDC, consulte os documentos a seguir:

• Caminho do aprendizado do Mobility Pack do NetBeans
• Mobility Pack do NetBeans para docs CDC 5.5 e página de suporte