Automatizando o processo de construção de um projeto J2ME � Parte 02

Natal DevMedia: Assine hoje e ganhe 3 meses gr�tis

Automatizando o processo de constru��o de um projeto J2ME � Parte 02

por Paulo Silveira

A Aplica��o de teste

Para este artigo usaremos um MIDlet bem simples apenas para demonstrar as capacidades do Antenna. O c�digo do nosso HelloWebMobile se encontra na Listagem 1.

package br.com.portalwebmobile.edicao1;

import javax.microedition.lcdui.Canvas;

import javax.microedition.lcdui.Display;

import javax.microedition.lcdui.Graphics;

import javax.microedition.midlet.MIDlet;

import javax.microedition.midlet.MIDletStateChangeException;

public class HelloWebMobile extends MIDlet {

protected void startApp() throws MIDletStateChangeException {

Display display = Display.getDisplay(this);

display.setCurrent(new WebMobileCanvas());

}

protected void pauseApp() {

}

protected void destroyApp(boolean arg0) throws MIDletStateChangeException {

}

class WebMobileCanvas extends Canvas {

protected void paint(Graphics g) {

g.setColor(0, 0, 0);

g.fillRect(0, 0, this.getWidth(), this.getHeight());

g.setColor(255, 255, 255);

g.drawString("Web Mobile #1", 0, 0, Graphics.TOP | Graphics.LEFT);

}

Listagem 1. Hello WebMobile.

Um c�digo t�o pequeno pode dar bastante trabalho at� chegar no seu dispositvo. Agora vamos ver como o Antenna pode nos ajudar.

O build.xml

Vamos inicialmente definir algumas vari�veis (ver Listagem 2).

Listagem 2.

Perceba que o diret�rio de build � diferente do Eclipse para n�o entrar em conflito com as classes geradas pelo Eclipse. Precisamos tamb�m definir as tasks que vamos utilizar, al�m de configurar onde o Antenna poder� achar os execut�veis do Wireless Toolkit, j� que ele se baseia nesses programas (ver Listagem 3).

Listagem 3.

O arquivo antenna.properties n�o precisa estar em lugar algum, j� que ele se encontra no jar do Antenna, e ser� encontrado pois o colocamos no classpath.

Vamos tamb�m definir uma task b�sica de limpeza do diret�rio de build (ver Listagem 4).

</target>

Listagem 4.

Compilando

A task wtkbuild � uma extens�o da task javac, que d� mais op��es para voc� poder trabalhar diretamente com as possibilidades do WTK.

<wtkbuild srcdir="${src}"

destdir="${build}"/>

</target>

Ao rodar o target compile, o resultado deve ser algo como o apresentado na Listagem 5.

Buildfile: D:\javaprograms\j2meworkspace\hello-webmobile\build.xml

clean:

[delete] Deleting directory D:\javaprograms\j2meworkspace\hello-webmobile\temp\bin

[mkdir] Created dir: D:\javaprograms\j2meworkspace\hello-webmobile\temp\bin

compile:

[wtkbuild] **************************************************************

[wtkbuild] * Antenna 0.9.13 initialized for project "HelloWebMobile" *

[wtkbuild] * Using Sun Wireless Toolkit 2.1 (CLDC-1.0; MIDP-1.0) *

[wtkbuild] **************************************************************

[wtkbuild] Compiling 1 source file to D:\javaprograms\j2meworkspace\hello-webmobile\8b21d6ad.tmp\tmpclasses

[wtkbuild] Preverifying D:\javaprograms\j2meworkspace\hello-webmobile\8b21d6ad.tmp\tmpclasses

BUILD SUCCESSFUL

Total time: 3 seconds

Listagem 5.

Assim como na task javac, voc� pode definir o classpath e outros atributos.

Criando o JAD

O descritor da sua aplica��o J2ME pode ser facilmente criado atrav�s da task wtkjad:

<wtkjad jadfile="${build}/${jar.name}.jad"

jarfile="${build}/${jar.name}.jar"

name="${midlet.name}"

vendor="PortalWebMobile.com.br"

version="0.9">

</wtkjad>

</target>

Empacotando e pr�-verificando

Podemos criar o jar da sua aplica��o usando a task wtkpackage. Ela � uma extens�o do jar:

<wtkpackage jarfile="${build}/${jar.name}.jar"

jadfile="${build}/${midlet.name}.jad" preverify="true">

</fileset>

</wtkpackage>

</target>

wtkpackage precisa que o .jar j� exista, e ele vai atualizar os dados do .jad, tal como o tamanho do jar.

A pr�-verifica��o ocorre aqui, mas poderia ter ocorrido durante o wtkbuild com a mesma op��o (preverify).

Rodando o emulador

Vamos criar agora um target para rodar o emulador.

<wtkrun jadfile="${build}/${jar.name}.jad"

device="DefaultColorPhone" wait="true"/>

</target>

A op��o wait indica se o Ant deve esperar ou n�o pelo t�rmino do emulador. Device indica qual tipo de aparelho deve ser usado, tais como DefaultGreyPhone e MinimumPhone. Rodando a aplica��o o emulador dever� abrir, e selecionando a aplica��o voc� ter� a figura 5.

Figura 5.

Obfuscador

O obfuscador n�o serve apenas para dificultar o trabalho de engenharia reversa, mas � tamb�m essencial para diminuir, em muito, o tamanho das classes geradas. O Antenna detecta automaticamente a presen�a de alguns obfuscadores (ProGuard e Retroguard). Basta voc� colocar um deles no classpath do Ant (Figura 4), e quando for gerar o jar, coloque a op��o de obfusca��o para true:

<wtkpackage jarfile="${jar.name}.jar"

jadfile="${build}/${jar.name}.jad" preverify="true" obfuscate="true">

</fileset>

</wtkpackage>

</target>

Conclus�es

O Antenna facilita muito o processo de build de aplica��es J2ME e pode ser facilmente integrado a qualquer IDE que tenha suporte ao Apache Ant, ou mesmo para usar via linha de comando. Todas as tasks aqui apresentadas ainda possuem uma s�rie de outras op��es, consulte a p�gina do Antenna para uma listagem completa.

As pr�ximas vers�es do Antenna ter�o suporte a outros emuladores, como da Nokia, Siemens, etc. Espera-se tamb�m por tasks que auxiliem no processo de signing de MIDlets.

Paulo Silveira (paulo.silveira@caelum.com.br) � formado em Ci�ncia da Computa��o pela Universidade de S�o Paulo, onde realiza seu mestrado. Trabalhou no Brasil e na Alemanha em empresas e consultorias, e � um dos fundadores do GUJ (http://www.guj.com.br). Atualmente � consultor e instrutor pela Caelum (http://www.caelum.com.br). Paulo Silveira � um dos colaboradores do c�digo do Antenna.

Instala��o do Antenna?

Como voc� viu no artigo, n�o h� instala��o do Antenna, basta voc� colocar o jar no path de runtime do Ant da sua IDE. Apesar disso o Antenna necessita que voc� tenha configurado a variavel PATH do seu sistema operacional corretamente, pois ele realiza chamadas ao �jar� quando vai empacotar sua aplica��o. Se o jar n�o estiver no caminho do seu sistema, o Antenna gera mensagens de erro muito estranhas, dizendo que a pr�-verifica��o falhou, quando o erro esta em outro lugar.

Outros recursos do Antenna

Palm - Se voc� quiser fazer o deploy da sua aplica��o para a palm, o Antenna ainda conta com a task WtkMakePrc para que voc� crie o seu PRC.

WTK 2.2 - O Wireless Toolkit 2.2 da Sun est� em beta, mas o Antenna 0.9.13 j� possui suporte a ele. O WTK2.2 traz suporte a novas APIs, como a Mobile 3D Graphics (JSR 184).

Pr�-processador � Programando em J2ME, muitas vezes voc� encontra situa��es onde quer que o jar resultante seja um pouco diferente para cada dispositivo. Um conjunto de abstra��es (como factories e utiliza��o de interfaces) podem resolver o problema, mas gasta um preciso espa�o do JAR resultante. Outra solu��o � usar um pr�-processamento � maneira antiga, com #defines e #ifdefs, e o Antenna vem com um sistema simples para isso. Eu particularmente n�o gosto deste tipo de sa�da.

Verbose � Muitas das tasks do Antenna possuem a op��o verbose, que voc� pode deixar em true para que o Antenna diga exatamente o que est� fazendo e chamando.

Plugin para o Maven - se a sua ferramenta de build � o Apache Maven, voc� pode utilizar um plugin que � o wrapper das tasks do Antenna, veja o quadro de links.

Milestones do Eclipse 3.1

O Eclipse 3.1 ainda est� em seus primeiros meses de desenvolvimento, mas tem ganho muitos adeptos devido aos recursos do java 5.0. Cuidado com alguns milestones (como o M1) que n�o trabalham corretamente com user libraries, fazendo com que a substitui��o do rt.jar pelos jars do cldc e midp n�o funcionem corretamente (o Eclipse reclama que java.lang.Object n�o existe).

Links

Apache Ant

http://ant.apache.org/

Antenna

http://antenna.sf.net/

Eclipse

http://www.eclipse.org/

Netbeans

http://www.netbeans.org/

Wireless ToolKit

http://java.sun.com/products/j2mewtoolkit/

Proguard