Tutorial J2ME Parte 3

Introduo
Como pudemos aprender nos tutoriais anteriores, os dispositivos celulares podem
implementar em seu sistema o KVM, a mquina virtual que roda aplicaes J2ME. A API de
programao para aparelhos celulares est baseada em CLDC e MIDP. Para maiores
detalhes veja o tutorial parte 1
(http://sites.uol.com. br/helyrosa/rodrigo_garcia_j2me/rodrigo_garcia_j2me.html)
Tambm pudemos ver um exemplo de aplicao em J2ME que escreve na tela do celular a
frase "Hello World!, conforme a figura abaixo:

O exemplo da aplicao Hello World! e as estruturas de programao utilizadas podem ser

encontrados no tutorial parte 2
(http://sites.uol.com.br/helyrosa/r_martins_j2me/r_martins_j2me.html)
Neste captulo 3 do tutorial vamos abordar como compilar e testar a aplicao Hello
World! utilizando o Wireless ToolKit que a Sun Microsystems disponibiliza em seu site (para
maiores detalhes de como obter as ferramentas, veja o tutorial parte 1).
Suponhamos que o Toolkit foi instalado no diret rio C:\ J2MEwtk. Dentro desse diretrio
t ere mos a seguinte estrutura de arquivos e diretrios referente ao prprio Toolkit:

Arquivo: BinaryLicense.html contem o contrato da licena de uso do Toolkit.

Arquivo: BinaryReleaseNotes.html contem notas sobre a verso instalada do Toolkit.

Arquivo: index.html pgina HTML que aponta para a documenta o do Toolkit.

Diretrio appdb\ contem arquivos de dados tais como informaes RMS de cada
Midlet.

Diretrio apps\ contem as aplica es demonstrao e novas aplicaes/projeto que so

criados adicionalmente no KToolbar. aqui que ser criada a estrutura para nossa
aplicao Hello World!.

Diretrio bin\ contem arquivos Batch e outros executveis usados pelo Toolkit.

Diretrio docs \ contem documentao e guias de uso do Toolkit e das APIs do J2ME.

Arquivo lib \midpapi.zip contem as classes com as APIs CLDC e MIDP. Esses arquivos
so usados durante a compila o dos arquivos fonte (*.java) e na pr- verificao do
byte-code das classes geradas por esse fontes (*.class).

Diretrio sessions\ contem dados de monitorao da execu o das aplicaes no

simulador. Com esses dados possvel monitorar o uso da memria, rede e outros
durante a execuo de um Midlet.

Para uso neste tutorial necessrio que o cdigo a seguir seja copiado para um arquivo
texto sem formatao (do tipo gerado com NotePad) e salvo com o nome HelloJ2ME.java.
Note que a linguagem JAVA faz distino entre minsculas e maisculas e portanto deve- se
tomar especial ateno ao nome do arquivo que tem que ser obrigatoriamente igual ao
nome da classe que nele definida.
O cdigo do programa que ser utilizado em este tutorial segue abaixo:

import javax.microedition.midlet.*;
import javax.microedition.lcdui.*;
public class
{
private
private
private
private

HelloJ2ME extends MIDlet implements CommandListener

Display display;
TextField t;
Command comandoDeSaida;
Form formularioPrincipal;

public HelloJ2ME() {
display = Display.getDisplay(this);
formularioPrincipal = new Form("HelloJ2ME");
comandoDeSaida = new Command("Exit", Command.SCREEN,1);
t = new TextField("Text","Hello World!",15,TextField.ANY);
formularioPrincipal.addCommand(comandoDeSaida);
formularioPrincipal.append(t);
formularioPrincipal.setCommandListener(this);
}
public void startApp() {
display.setCurrent(formularioPrincipal);
}
public void pauseApp() {
}
public void destroyApp(boolean incondicional) {
}
public void commandAction(Command comando, Displayable s) {
if (comando == comandoDeSaida) {
destroyApp(false);
notifyDestroyed();
}
}
}

Como usar o Wireless Toolkit?

Uma vez instalado conforme as instrues descritas no site da SUN, podemos iniciar o
desenvolvimento de aplicaes baseadas em J2ME. No nosso tutorial vamos demonstrar o
uso do Wireless Toolkit atravs do programa "Hello World!.
O primeiro passo iniciar o KToolbar que onde criaremos um projeto. A figura abaixo
ilustra onde pode ser localizada a aplicao em ambientes Windows.

Uma vez iniciado o aplicativo KToolbar, o mesmo se apresentar como a seguir.

Aps iniciar o KToobar devemos abrir um novo projeto. Na tela da aplicao KToolbar existe
o boto New Project . Aperte esse bot o para que seja aberto um formulrio que
solicitar que seja dado um nome de projeto (qualquer) e o nome da classe MIDlet que
rodar o programa J2ME. No nosso exemplo, o nome do projeto Hello World! e conforme
descrito no cdigo fonte do programa, a classe chamada HelloJ2ME .

Ao apertar o boto Create Project o sistema automaticamente criar uma estrutura de

diretrios referentes ao projeto dentro do diretrio de instala o do J2ME Wireless Toolkit.
Essa estrutura estar abaixo do diretrio Apps\ <Nome do Projeto> que fica dentro da
estrutura de diret rios do Toolkit (por exemplo C:\J 2MEwtk\Apps\ Hello World!\ ). Nela
termos os seguintes diretrios:

\ Src nele colocaremos o cdigo fonte de nossa aplicao, ou seja, o arquivo

HelloJ2ME.java.

\Bin nele o Toolkit criar os arquivos .JAR e .JAD que so necessrios para poder
executar a aplicao em um celular ou mesmo no simulador.

\Res nele so colocados todos os arquivos adicionais que so necessrios para que a
aplicao seja executada. Um exemplo tpico uma imagem no formato PNG com o
cone da aplicao. Todos os arquivos que forem colocados nesse diret rio sero
empacotados dentro do .JAR e sero acessveis pela aplicao J2ME. No nosso exemplo
no colocaremos nada l.

Ao pressionar o boto Create Project, o KToolbar criar os diret rios acima descritos e
tambm o prprio diretrio do projeto Hello World!. Porm antes o Toolkit pedir para que
seja m confirmadas as informaes do descritivo do Projeto/aplicao. Essas informaes ou
atributos sero o contedo do arquivo .JAD (Java Descriptor) a ser criado. No nosso caso
no nos preocuparemos com esses dados e simplesmente apertaremos o boto OK. O
resultado aparece a seguir.

Aps apertar o OK, o Toolkit indicar no seu console que os diretrios do projeto foram
criados conforme a figura abaixo.

Nesse momento o Toolkit nos sugere que os arquivos fonte sejam colocados no diretrio
\apps\ Hello World!\src \. Nesse momento devemos copiar o arquivo HelloJ2ME.java
para esse diretrio.
A partir de agora estamos prontos para construir a aplicao!
Basta apenas apertar o boto Build no KToolbar que o Toolkit compilar os arquivos fonte
e criar os arquivos .class que sero usados para rodar o simulador. Abaixo segue a
ilustrao da construo do aplicativo Hello World!.

Caso no ocorra nenhum problema de compila o teremos a mensagem Build Complete,

ao final das mensagens, indicando que est tudo pronto para executar a aplicao Hello
World! no simulador. Caso ocorram erros de compilao os mesmos sero apresentados no
console do Toolkit.

No nosso caso, o programa est depurado e o cdigo fonte est correto. Portanto no h
nenhum problema de compilao. Neste caso estamos prontos para executar a aplica o.
Para isso basta apertar o boto Run no KToolbar. Ao fazer isso ser aberta uma nova
janela com o simulador escolhido. No nosso exemplo o simulador genrico colorido,
conforme a figura abaixo.

A figura acima mostra o estgio inicial do simulador que permite que seja escolhido qual
Midlet executar. Nosso caso s h um Midlet especificado no arquivo .JAD, portanto temos
apenas que pressionar o SoftKey para lanar a aplicao Hello World! (boto em destaque
logo abaixo da palavra Launch). O resultado da execuo do Hello World! segue abaixo.

Uma vez que a aplicao tenha executado a contento no simulador, possvel criar o
arquivo .JAR (Java Archive) que , na verdade, um arquivo compactado no formato PkZip
com todas as classes e arquivos do diret rio \res (resources).
Para criar- se o .JAR basta selecionar Project Package no menu do KToolbar. Esse
arquivo somente necessrio para executar o programa no prprio aparelho celular.
Com este tutorial, o estudante ser capaz de compilar e simular seus programas
desenvolvidos com a linguagem J2ME para aparelhos celulares. No prximo e ltimo
captulo do tutorial, apresentare i uma verso mais sofisticada do programa Hello World!,
onde mostrarei como fazer animaes simples usando caracteres de texto, o que pode ser
melhorado, futuramente pelo prprio estudante, para fazer anima es com imagens.
At l!

Sobre o Autor:
Rodrigo P. Garcia Corbera tem 10 anos de experincia em arquitetura e projetos de
tecnologia em telecomunicaes. Mais recentemente, trabalhou na Lucent Brasil, onde
atuou como gerente comercial de solues de Messaging no mercado de operadores mveis,
gerente da rea de consultoria de redes de dados e ticas liderando um time com 25
consultores espalhados pela Amrica do Sul e tambm, foi por dois anos, responsvel por
gerenciar a rea tcnico-comercial de integrao de tecnologia para ofertas de redes de
dados da Lucent. Antes disso, trabalhou no projeto Pay- Per- View da Globo Cabo como
consultor contrat ado atravs da AL&CA e como Executivo de Vendas da Hughes Network
Systems . Rodrigo tem formao em engenharia da computao pela UNICAMP e fluente
em portugus, espanhol e ingls.
Contato via e- mail: rgarcia@cy.com.br