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.
4. 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.
5. 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.
6. Escolha Arquivo > Propriedades de "MyHello".
7. Escolha o nó Plataforma e escolha o nome do novo emulador (por exemplo, Sun Java Wireless Toolkit 2.5.2) do menu suspenso Plataforma do emulador. Clique em OK.

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.

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.

Alterando a configuração do projeto

Você pode criar tipos diferentes de configurações de projeto usando os modelos no assistente para Novo projeto. Você também pode usar o menu suspenso Configuração na barra de ferramentas principal para alterar rapidamente as configurações do projeto.

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 habilidade à 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 com outras configurações, escolhendo uma configuração diferente do menu Configuração do projeto e clicando no botão Adicionar.

Adicionando código do pré-processador para configurações específicas

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".