Guia de início rápido de desenvolvimento de CDC do NetBeans Mobility 6.0

Introdução

As aplicações CDC são projetadas para serem executadas em dispositivos móveis e incorporados com pelo menos 2MB de memória. Essa configuração suporta uma JVM com mais recursos do que os telefones celulares baseados em MIDP, 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 do uso do NetBeans IDE a fim de criar uma aplicação da Plataforma Java, Micro Edition (plataforma Java ME), Connected Device Configuration (CDC). Mostramos quatro formas diferentes de criar um projeto CDC Java ME que exibe um formulário simples em um emulador de dispositivo, um para cada perfil disponível. Também mostramos uma forma adicional de usar o NSICom CrEme VM para Windows CE. Este documento destina-se a ajudá-lo a começar a criar aplicações o mais rapidamente possível.

Conteúdo

• Requisitos
• Adicionando plataformas de emulador
• Criando uma aplicação CDC
• Perfil Foundation
• Perfil Personal
• Perfil AGUI
• Usando NSIcom CrEme VM para Windows CE
• Usando configurações
• Consulte também

Requisitos

Você precisa ter o NetBeans 6.0 Mobility ou Full edition (download) instalado antes de iniciar o desenvolvimento de CDC em Java ME. As seções Cliente/Servidor requerem a Full Edition para dar suporte a Serviços Web. Se você instalou somente a Mobility Edition, será necessário baixar os seguintes plug-ins da Central de atualizações (Ferramentas > Plug-ins):

• Aplicações Web
• Serviços Web
• Sun Java System Application Server
• Sun Java Toolkit para CDC ou outra plataforma de emulador CDC instalada. Consulte Adicionando plataformas de emulador, abaixo, para obter mais informações.

Adicionando plataformas de emulador

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

• Sun Java Toolkit para CDC 1.0. ( consulte as instruções de instalação)
• Ricoh Embedded Software Architecture Emulator 1.14c
• Sony Ericsson CDC Platform para UIQ SDK 3
• Dispositivos Sony Ericsson M600 e P990
• Nokia Series 80 Platform SDK para SO Symbian, Java e perfil Pessoal
• CrEme VM para Windows CE

As instruções para adicionar plataformas de emulador estão listadas no Guia de configuração de plataforma CDC do NetBeans 6.0.

Criando uma aplicação CDC

Nesta seção criaremos um projeto de aplicação CDC para cada perfil disponível e, para as plataformas Personal e AGUI, criaremos uma GUI para a aplicação usando o Construtor de GUIs do IDE.

Os Perfis descritos são:

• Perfil Foundation (Ricoh)
• Perfil Personal (Nokia, Sony Ericsson)
• AGUI (Sun Java Toolkit para CDC)

Criando uma nova aplicação CDC - Perfil Profile

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

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Mobility. Em Projetos, selecione o modelo de aplicação CDC. Clique em Próximo.
2. Nomeie o projeto de S80CdcApplication e especifique um local para o projeto em seu computador. Deixe a caixa de verificação Criar classe principal selecionada. Clique em Próximo.
3. Na página Selecionar plataforma, escolha a Plataforma Nokia S80.

4. Clique em Terminar. O IDE cria a nova aplicação e abre o formulário da classe principal no Construtor de GUIs, como mostrado na figura a seguir. Clique em Código-fonte para ver o código-fonte do applet. Observe que o código gerado é baseado no perfil. Nesse caso, a classe principal é derivada de java.awt.Frame.

   

Criando a interface da aplicação 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 Definir Layout > Design 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 AWT em seu formulário. Como todos os dispositivos Nokia Series 80 oferecem suporte ao Perfil Personal, somente elementos AWT 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. Sua aplicação deve ser exibida no menu Aplicações no emulador do dispositivo. Agora você pode executar o dispositivo no emulador.

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

Criando uma nova aplicação CDC - Perfil AGUI

Aqui iremos criar uma aplicação CDC, ou Xlet, para o Perfil AGUI usando o Sun Java Toolkit para CDC 1.0.

1. Escolha Arquivo > Novo projeto (Ctrl+Shift+N) na janela principal.
2. Em Categorias, selecione Mobility. Em Projetos, selecione Aplicação CDC. Clique em Próximo.
3. Na página Nome e localização:

• Nomeie o projeto de newcdc.
• Altere o nome Classe principal para newcdc.Mainxlet.
• Deixe marcadas as caixas de verificação Definir como projeto principal e Criar classe principal.

1. Na página Selecionar plataforma, use os menus suspensos para escolher Sun Java Toolkit para Connected Device Configuration como a Plataforma Java e DefaultColorPhone como o Dispositivo. Deixe as configurações de perfil como estão.
2. Clique em Terminar. O IDE cria a nova aplicação e abre o formulário da classe principal no Construtor de GUIs.

Criando a interface da aplicação 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 informações sobre a criação de GUIs para aplicações CDC, consulte Design de GUIs com NetBeans Mobility Pack para CDC.

Ao terminar, clique com o botão direito do mouse no projeto na janela Projetos e escolha Executar projeto. Sua aplicação 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 uma nova aplicação CDC para Windows CE (usando a CrEme VM)

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

Criando uma aplicação

1. Escolha Arquivo > Novo projeto (Ctrl+Shift+N) na janela principal.
2. Em Categorias, selecione CDC. Em Projetos, selecione o modelo de aplicação CDC. Clique em Próximo.
3. Na página Nome e localização, nomeie o projeto de cremeapp. Clique em Próximo.
4. Na página Selecionar plataforma, escolha pJSCP V4.10. Clique em Terminar.
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 Terminar. 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 a aplicação no emulador CrEme padrão . Isso garante 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 a sua aplicação. 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 a aplicação 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 da aplicação. 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 da aplicação.
   2. Escolha Arquivo > Configurações de conexão.
   3. Adote um ou ambos os procedimentos abaixo:
   • Marque a caixa de verificaçã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.

Executando a aplicação

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

Usando configurações

Você pode usar as configurações para criar mais de um conjunto de arquivos de distribuição JAR e Java Application Descriptor (JAD) para seu projeto. Isso permite que você crie um conjunto de códigos-fonte e personalize-o para cada dispositivo móvel para o qual está programando.

As instruções abaixo são generalizadas, mas funcionam para cada uma das plataformas descritas anteriormente.