Criando uma aplicação MIDP/CLDC

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Mobility. Em Projetos, selecione Aplicação MIDP e clique em Próximo.
2. Indique MyHello no campo Nome do projeto. Altere o Local do projeto para qualquer diretório no sistema. Neste tutorial, esse diretório é definido como $PROJECTHOME.
3. Marque as caixas de verificação Definir como projeto principal e Criar Hello MIDlet (ambas estão marcadas por padrão). Clique em Próximo.
4. Selecione o Sun Java Wireless Toolkit 2.52 para CLDC como a plataforma de emulador e use os padrões restantes. Clique em Próximo.
5. Expanda as pastas "Modelos de configuração fornecidos por plataformas CLDC instaladas" e "Sun Java Wireless Toolkit 2.52 para CLDC". Marque as caixas ao lado de cada uma das configurações. O IDE cria automaticamente uma nova configuração de projeto para cada modelo listado.

   

6. Clique em Terminar. O IDE cria a pasta do projeto $PROJECTHOME/MyHello. A pasta do projeto contém todos os códigos-fonte e os metadados do projeto, como o script Ant do projeto. A própria aplicação é exibida na janela Design de fluxo do Visual Mobile Designer.

Editando o código-fonte Java

Agora, vamos editar o texto exibido pelo MIDlet.

1. Clique em Tela. Isto abre a janela Editor de tela e exibe a tela Dispositivo, que é a única tela disponível na aplicação.
2. Na janela Propriedades, clique no campo Texto e digite algum texto novo. Neste exemplo, digitamos "Make my day".



3. A visualização Tela exibe o texto inserido no campo Texto.

Compilando e executando o projeto

1. Selecione Executar > Executar projeto principal (F6) no menu Executar. Siga o progresso da compilação do projeto na Janela de saída. Observe que o arquivo HelloMIDlet.java é construído antes de ser executado. Um emulador de dispositivo é aberto para exibir os resultados do MIDlet executado. O emulador de dispositivo padrão é DefaultColorPhone.
2. Na janela do emulador do dispositivo, clique no botão abaixo do comando Iniciar. O emulador de dispositivo inicia o MIDlet e exibe o texto inserido no código-fonte.

   

3. Clique no botão abaixo de Sair para fechar o MIDlet. Em seguida, clique no botão no canto superior direito do dispositivo para fechar a janela do emulador.

Criando um novo projeto Java ME MIDP

1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Mobility. Em Projetos, selecione Aplicação MIDP e clique em Próximo.
2. Digite MyHelloMIDlet no campo Nome do projeto (observe que "MID" é em maiúsculas). Altere o Local do projeto para qualquer diretório no sistema. Fazemos referência a este diretório como $PROJECTHOME neste tutorial.
3. Marque a caixa de verificação Definir como projeto principal e desmarque a caixa Criar Hello MIDlet. Clique em Próximo.
4. Deixe o J2ME Wireless Toolkit como a Plataforma de destino selecionada.
5. Expanda as pastas "Modelos de configuração fornecidos por plataformas CLDC instaladas" e "J2ME Wireless Toolkit 2.2". Marque as caixas ao lado de cada uma das configurações. O IDE cria automaticamente uma nova configuração de projeto para cada modelo listado.
6. Clique em Terminar. O IDE cria a pasta do projeto $PROJECTHOME/MyHelloMIDlet. A pasta do projeto contém todos os códigos-fonte e os metadados do projeto, como o script Ant do projeto.
7. Clique com o botão direito do mouse no nó MyHelloMIDlet na janela do Explorer e escolha Novo > MIDlet.
8. Indique HelloMIDlet como o nome do MIDlet (observe que "MID" está em maiúsculas). Clique em Terminar. O arquivo HelloMIDlet.java é criado.
9. Clique duas vezes no arquivo HelloMIDlet.java para exibir o código-fonte no Editor.
10. Clique no Editor de código-fonte e altere

    public class HelloMIDlet extends MIDlet

    para

    public class HelloMIDlet
                  extends MIDlet implements javax.microedition.lcdui.CommandListener
                  {

11. Adicione o seguinte texto antes do método startApp():

    public HelloMIDlet() {
    }private void initialize() {  javax.microedition.lcdui.Display.getDisplay(this).setCurrent(get_helloTextBox());}
    public void commandAction(javax.microedition.lcdui.Command command, javax.microedition.lcdui.Displayable
      displayable) {   if (displayable == helloTextBox) {      if (command == exitCommand) {         javax.microedition.lcdui.Display.getDisplay(this).setCurrent(null);         destroyApp(true);         notifyDestroyed();      }   }
    }
    private javax.microedition.lcdui.TextBox get_helloTextBox() {   if (helloTextBox == null) {       helloTextBox = new javax.microedition.lcdui.TextBox(null, "Test String",120, 0x0);       helloTextBox.addCommand(get_exitCommand());       helloTextBox.setCommandListener(this);   }   return helloTextBox;}
    private javax.microedition.lcdui.Command get_exitCommand() {   if (exitCommand == null) {       exitCommand = new javax.microedition.lcdui.Command("Exit", javax.microedition.lcdui.Command.EXIT,
      1);   }   return exitCommand;}
    javax.microedition.lcdui.TextBox helloTextBox;javax.microedition.lcdui.Command exitCommand;

12. Adicione uma linha initialize(); ao método startApp() para que tenha a seguinte aparência:

      public void startApp() {
       initialize();
        }

Editando o código-fonte Java

Agora, vamos adicionar texto ao MIDlet para exibição.

1. No método get_helloTextBox(), substitua o código "test string" pelo texto que desejar. Por exemplo, "Make my day".

Compilando e executando o projeto

1. Selecione Executar > Executar projeto principal (F6) no menu Executar. Siga o progresso da compilação do projeto na Janela de saída. Observe que o arquivo HelloMIDlet.java é construído antes de ser executado. Um emulador de dispositivo é aberto para exibir os resultados do MIDlet executado. O emulador de dispositivo padrão é DefaultColorPhone.
2. Na janela do emulador do dispositivo, clique no botão abaixo do comando Iniciar. O emulador de dispositivo inicia o MIDlet e exibe o texto inserido no código-fonte.
3. Clique no botão abaixo de Sair para fechar o MIDlet. Em seguida, clique no botão no canto superior direito do dispositivo para fechar a janela do emulador.

Alterando o dispositivo emulador padrão

1. Clique com o botão direito do mouse no nó do projeto MyHello e escolha Propriedades. Na caixa de diálogo Propriedades, escolha o nó Plataforma. Aqui, você pode alterar o dispositivo da configuração padrão.
2. Clique na lista suspensa Dispositivo e escolha QwertyDevice. Clique em OK.
3. Execute a aplicação novamente e ela será executada no emulador QwertyDevice.

Alterando a configuração do projeto

Você criou várias configurações de projeto usando os modelos no assistente para Novo projeto. Você pode usar o menu suspenso Configuração na barra de ferramentas principal para alterar rapidamente as configurações do projeto.

Adicionando uma nova plataforma de emulador

1. Escolha Ferramentas > Plataformas Java na barra de ferramentas principal.
2. Na caixa de diálogo Gerenciador de plataformas Java, clique no botão Adicionar plataforma.
3. Na página Selecionar tipo de plataforma, escolha Emulador da plataforma Java ME MIDP Edition. Clique em Próximo. Na página Plataformas, o IDE procura todas as plataformas Java ME disponíveis e as lista na janela. As plataformas compatíveis com o padrão Unified Emulator Interface (UEI) são verificadas e aparecem com uma marca na caixa de verificação ao lado do nome da plataforma. As plataformas que não são compatíveis com UEI, ou que não podem ser instaladas por outros motivos, são listadas em vermelho. O assistente também identifica que plataformas já foram instaladas. OBSERVAÇÃO: Para instalar as plataformas que não são compatíveis com a UEI, clique no botão Voltar e escolha Emulador personalizado da plataforma Java Micro Edition.
4. Na página Plataformas, coloque uma marca ao lado de todos os emuladores de plataforma que desejar instalar. Depois que as plataformas forem detectadas, elas são instaladas. Clique em Terminar. Em seguida, clique em Fechar.
5. Escolha Arquivo > Propriedades de "MyHello".
6. Escolha o nó Plataforma e escolha o nome do novo emulador (por exemplo, J2ME Wireless Toolkit 2.2) do menu suspenso Plataforma do emulador. Clique em OK.

Adicionando uma configuração

1. Clique com o botão direito do mouse no nó do projeto MyHello e escolha Propriedades. Na caixa de diálogo Propriedades, escolha Adicionar configuração na lista suspensa Configuração do projeto. Isso abre a caixa de diálogo Adicionar configuração.
2. Indique um nome para a configuração no campo Nome da configuração. O nome deve identificar a plataforma de destino na qual você implantará o JAR/JAD criado para esta configuração. Para este exemplo, indique BlackWhiteDisplay e clique em OK. Você acabou de criar uma nova configuração.
3. Você também pode adicionar as configurações, clicando no botão Gerenciar configurações na caixa de diálogo Propriedades. Isso abre a caixa de diálogo Gerenciador de configuração de projeto que contém opções para adicionar, remover ou duplicar configurações.

Personalizando uma configuração

Você pode adicionar quantas configurações quiser ao seu projeto. Em seguida, você pode modificar as configurações na caixa de diálogo Propriedades do projeto de cada configuração adicionada.

1. Clique com o botão direito do mouse no nó do projeto MyHello e escolha Propriedades. Na caixa de diálogo Propriedades, escolha o nó Plataforma.
2. Escolha a configuração BlackWhiteDisplay na caixa de combinação da configuração na parte superior da caixa de diálogo Propriedades.
3. Todos os componentes da caixa de diálogo Plataforma são desativados. Isso acontece porque essa configuração está no momento usando os valores usados por padrão para este painel. Desmarque Usar valores na opção "DefaultConfiguration" na parte superior do painel. Todos os componentes desse painel agora podem ser editados.
4. Altere a opção Dispositivo para DefaultGrayPhone.
5. Alterne para a caixa de diálogo Configuração do projeto na parte superior da caixa de diálogo e observe se a opção Dispositivo se altera com base em qual configuração está selecionada no momento. Esse método de personalização de configuração funciona para cada painel (menos o painel geral) na caixa de diálogo. Clique em OK para salvar suas alterações de configuração e saia da caixa de diálogo Propriedades.

Criando uma habilidade

Uma habilidade é um atributo específico de uma configuração de projeto. Ela pode ser um atributo físico tal como o tamanho da tela, ou uma API ou JSR suportado pela configuração. Você pode criar uma nova habilidade e associá-la a uma ou mais configurações do projeto. Em seguida, você pode usar blocos de código do pré-processador para associar determinado código a essa habilidade. Se você depois precisar adicionar ou remover configurações, não precisará percorrer todo o código e associar a configuração a cada bloco de código. Em vez disso, você precisa somente adicionar essa habildiade à configuração. A configuração é então associada, automaticamente, a qualquer bloco de código associado à habilidade.

1. Clique com o botão direito do mouse no nó do projeto MyHello e escolha Propriedades.
2. Escolha a página Habilidades da árvore de menu Categoria.
3. Escolha uma configuração do menu suspenso Configuração de projeto. Isto associa a habilidade a esta configuração.
4. Se necessário, desmarque a caixa de verificação Usar valores de "DefaultConfiguration".
5. Clique no botão Adicionar. Isso abre a caixa de diálogo Adicionar habilidade.
6. Na caixa de diálogo Nova habilidade, indique um nome para a habilidade, ou escolha uma habilidade no menu suspenso. Opcionalmente, indique um valor para a habilidade. Clique em Ok para fechar a caixa de diálogo Novo habilidade. A habilidade agora está associada com a configuração de projeto selecionada.

Você pode associar a habilidade a outras configurações, escolhendo uma configuração diferente no menu Configuração do projeto e clicando no botão Adicionar.

Adicionando código do pré-processador específico da configuração.

Os blocos do pré-processador permitem que você crie, gerencie e controle o código específico de uma ou mais configurações ou habilidades do projeto. O código é ativado (ou desativado) somente para as configurações ou habilidades que você identificar.

1. Na janela Editor do HelloMIDlet.java, clique com o botão direito do mouse na linha do código-fonte onde há a instância de TextBox ( helloTextBox = new javax.microedition.lcdui.TextBox(null, "Make my day",120, 0x0);).
2. Clique com o botão direito do mouse na linha e escolha Blocos do pré-processador > Criar bloco If/Else. Na primeira seção, rosa, anexe a palavra "Color" à frase "Hello World". Na segunda seção, cinza, adicione "Gray" à frase "Make my day".
3. O código marcado pela diretiva de pré-processador //#if tem efeito sempre que a configuração ativa corresponde ao valor da diretiva (neste caso, DefaultConfiguration). O código delimitado pela diretiva de pré-processador //#else é usado sempre que a configuração ativa não corresponde ao valor do pré-processador. Em outras palavras, o emulador exibe "Make my day Color" sempre que a plataforma ativa for "DefaultConfiguration" e exibe "Hello World Gray" se a plataforma ativa for qualquer outra plataforma de emulador. A diretiva de pré-processador //#endif completa o bloco do pré-processador.

Você pode testar o código do pré-processador executando o MIDlet usando diferentes dispositivos de emulador, conforme descrito em Alterando a plataforma de emulador.

Executando configurações

As configurações podem ser construídas e executadas individualmente ou simultaneamente.

1. Clique com o botão direito do mouse no nó Projeto MyHelloMIDlet e escolha Executar.
2. Use a caixa de combinação da configuração na Barra de ferramentas para alterar a configuração para BlackWhiteDisplay. Escolha Executar novamente.
3. Dois emuladores aparecem, um colorido e um cinza. O emulador cinza exibe "Make my day Gray" e o emulador colorido exibe "Make my day Color".