blob: 0e09235086c0bfd86e54ab101dfc6aba472bc5b6 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.
-->
<html>
<head>`
<title>Guia de Início Rápido do Desenvolvimento de MIDP em Java ME - Tutorial do NetBeans IDE</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" >
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<meta name="author" content="">
</head>
<body>
<h1>Guia de Início Rápido de Desenvolvimento Java ME MIDP</h1>
<p>Este tutorial orienta você pelas etapas básicas de utilização do NetBeans IDE para criar uma Plataforma Java(tm), Micro Edition (Plataforma Java(tm) ME), aplicação Perfil do Dispositivo de Informações Móvel (MIDP) e foi projetado para iniciar o desenvolvimento da aplicação móvel o mais rápido possível. O tutorial orienta você por meio de algumas etapas básicas do trabalho com o sistema de projeto. Nós mostramos duas maneiras de criar um projeto Java ME MIDP chamado "MyHello" que exibe o texto "Make My Day" em um emulador de dispositivo. Este tutorial prepara você para usar outras funcionalidades do IDE para o desenvolvimento de aplicações CLDC/MIDP.</p>
<p class="notes"><b>Observação:</b> Se você estiver usando o NetBeans IDE 7.3 ou 7.3.1, consulte o <a href="../../73/javame/quickstart.html">Guia de Início Rápido ao Desenvolvimento em NetBeans IDE 7.3 do Java ME MIDP</a>.</p>
<h3>Conteúdo</h3>
<img alt="O conteúdo desta página se aplica ao NetBeans IDE 7.4" class="stamp" src="../../../images_www/articles/74/netbeans-stamp.png" title="O conteúdo desta página aplica-se ao NetBeans 7.4">
<ul>
<li><a href="#reqs" title="Requisitos do Tutorial">Requisitos do Tutorial</a></li>
<li><a href="#install" title="Instalando o Oracle Java ME SDK">Configurando o IDE com Oracle Java ME SDK (somente Windows)</a></li>
<li><a href="#source" title="Criando Aplicações no Editor do Código-fonte">Criando uma Aplicação no Editor do Código-fonte</a></li>
<li><a href="#vmd" title="Criando Aplicações no VMD">Criando uma Aplicação no Visual Mobile Designer </a></li>
<li><a href="#nextsteps" title="Próximas Etapas">Próximas Etapas</a></li>
</ul>
<h2><a name="reqs"></a>Requisitos</h2>
<p><b>Para concluir este tutorial, são necessários os seguintes recursos e softwares:</b></p>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">Software ou Recurso</th>
<th class="tblheader" scope="col">Versão Necessária</th>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.netbeans.org/downloads/index.html" target="_blank">NetBeans IDE com Java ME</a></td>
<td class="tbltd1">Versão 7.4</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html" target="_blank">Java Development Kit</a> (JDK)</td>
<td class="tbltd1">Versão 7 </td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Oracle Java ME SDK</a></td>
<td class="tbltd1">Depende do sistema operacional</td>
</tr>
</tbody>
</table>
<p class="alert"><b>Importante:</b> a tabela abaixo lista as versões do Oracle Java ME SDK necessário para as plataformas específicas.</p>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">Plataforma</th>
<th class="tblheader" scope="col">Versão SDK Necessária</th>
</tr>
<tr>
<td class="tbltd1">Microsoft Windows</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Oracle Java ME SDK 3.4</a></td>
</tr>
<tr>
<td class="tbltd1"> Mac OS X</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/downloads/sdk30-mac-jsp-137878.html">Oracle Java ME SDK 3.0</a></td>
</tr>
<tr>
<td class="tbltd1">Linux</td>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/download-135801.html">Sun Java Wireless Toolkit 2.5.2</a></td>
</tr>
</tbody>
</table>
<h2><a name="install"></a>Configurando o IDE com Oracle Java ME SDK (somente Windows)</h2>
<p class="alert"><b>Importante:</b> Esta seção se aplica somente às plataformas Windows.</p>
<p>Para configurar o NetBeans IDE com o Oracle Java ME SDK para plataforma Windows, é necessário: </p>
<ul>
<li>Instalar o Oracle Java ME SDK </li>
<li>ativar a funcionalidade Java ME no NetBeans IDE</li>
<li>instalar a plataforma Oracle Java ME Platform SDK no NetBeans IDE </li>
</ul>
<p><b>Para instalar o Oracle Java ME SDK </b></p>
<ol>
<li>Vá para a página de <a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">download do Java ME SDK</a>.</li>
<li>Clique na opção Aceitar Contrato de Licença.</li>
<li>Faça download do arquivo instalador <a href="http://download.oracle.com/otn/java/javame/3.4/oracle-jmesdk-3-4-rr-win32-bin.exe">oracle-jmesdk-3-4-rr-win32-bin.exe</a> e salve-o em qualquer local no seu computador.</li>
<li>Clique duas vezes no arquivo instalador para executá-lo, e siga as instruções.<br> Quando a instalação for concluída, o ícone do Gerenciador de Dispositivo do Java (TM) ME Platform SDK 3.4 ( <img alt="Ícone do Gerenciador de Dispositivo do Java (TM) ME Platform SDK 3.2" src="../../../images_www/articles/73/javame/quickstart/icon.png">) será exibido na bandeja de sistema do Windows.</li>
</ol>
<p><b>Para ativar a funcionalidade Java ME: </b> </p>
<ol>
<li>Selecione Ferramentas > Plug-ins na barra de ferramentas principal do IDE.</li>
<li>Na caixa de diálogo Plug-ins, clique na guia Instalado e selecione Java ME na lista de funcionalidades disponíveis.
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/plugins.png" rel="lytebox" title="Caixa de diálogo Plug-ins"> <img alt="Caixa de diálogo Plug-ins" border="1" src="../../../images_www/articles/74/javame/quickstart/plugins-small.png"></a></p></li>
<li>Clique em Ativar.</li>
<li>No painel de Boas-vindas da caixa de diálogo do Instalador, clique em Ativar.
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/installer.png" rel="lytebox" title="Caixa de diálogo Instalador"> <img alt="Caixa de diálogo Instalador" border="1" src="../../../images_www/articles/74/javame/quickstart/installer-small.png"></a></p></li>
<li>Quando a ativação foi concluída com êxito, clique em Finalizar.</li>
<li>Clique em Fechar para fechar a caixa de diálogo Plug-ins.</li>
</ol>
<p><b>Para instalar a plataforma Oracle Java ME:</b></p>
<ol>
<li>Selecione Ferramentas > Plataformas Java.<br> A caixa de diálogo Gerenciador da Plataforma Java será exibida.
<p class="align-center">
<a href="../../../images_www/articles/74/javame/quickstart/jpmanager.png" rel="lytebox" title="Painel Nome e Local"> <img alt="Painel Nome e Local" border="1" src="../../../images_www/articles/74/javame/quickstart/jpmanager-small.png"></a></p></li>
<li>Clique em Adicionar Plataforma.</li>
<li>Em Selecionar Tipo de Plataforma do assistente Adicionar Plataforma Java, selecione Emulador de Plataforma Java ME CLDC e clique em Próximo.<br>O IDE exibirá o diretório Escolher para a pesquisa da caixa de diálogo das plataformas.</li>
<li>Selecione o diretório em que você instalou a Plataforma Java ME SDK (por exemplo, <tt>C:\Java_ME_Platform_SDK_3.4</tt>) e clique em Abrir.</li>
<li>No painel Pastas da Plataforma do assistente Adicionar Plataforma Java, verifique se a plataforma selecionada na etapa anterior foi escolhida e clique em Próximo.</li>
<li>Assim que o IDE detectar a plataforma, clique em Finalizar no painel Plataformas Detectadas do assistente Adicionar Plataforma Java.
<p class="align-center">
<a href="../../../images_www/articles/74/javame/quickstart/jpdetected.png" rel="lytebox" title="Plataforma J2ME detectada"> <img alt="Plataforma J2ME detectada" border="1" src="../../../images_www/articles/74/javame/quickstart/jpdetected-small.png"></a></p>
O Oracle Java ME Platform agora está registrado no NetBeans IDE.
<p class="align-center">
<a href="../../../images_www/articles/74/javame/quickstart/jpregistered.png" rel="lytebox" title="Plataforma J2ME registrada"> <img alt="Plataforma J2ME registrada" border="1" src="../../../images_www/articles/74/javame/quickstart/jpregistered-small.png"></a></p></li>
<li>Na caixa de diálogo Gerenciador de Plataformas Java, clique em Fechar.</li>
</ol>
<p>Agora, seu NetBeans IDE está configurado para o desenvolvimento móvel.</p>
<h2><a name="source"></a>Criando uma Aplicação MIDP Usando o Editor de Código-fonte</h2>
<div class="indent">
<p>Usando o Editor de Código-fonte, crie manualmente o código para os MIDlets. Ao criar o código no Editor de Código-fonte, você tem mais flexibilidade ao editar o código e pode inserir blocos do código do pré-processador. Você irá criar a aplicação <code>MyHello</code> usando os assistentes de Novo Projeto e Novo Arquivo e completar o código usando o Editor de Código-fonte. </p>
<h3 class="tutorial">Criando um Novo Projeto Java ME MIDP </h3>
<ol>
<li>Escolha <tt>Arquivo</tt> > <tt>Novo Projeto</tt>. Em Categorias, selecione <tt>Java ME</tt>. Em Projetos, selecione <tt>Aplicação Móvel</tt> e clique em Próximo.</li>
<li>Digite <code>MyHelloMIDlet</code> no campo Nome do Projeto (observe que <code>MID</code> está em maiúsculas). Especifique o Local do Projeto Nomeamos este diretório como <code>$PROJECTHOME</code> neste tutorial. </li>
<li>Desmarque a caixa de seleção Criar Pacote Padrão e Principal Classe Executável e clique em Próximo. </li>
<li>Selecione a plataforma do emulador default e utilize os defaults restantes. Clique em Finalizar. <br> O IDE cria a pasta do projeto <code>$PROJECTHOME/MyHelloMIDlet</code>. A pasta do projeto contém todos os códigos-fonte e os metadados do projeto, como o script Ant do projeto. </li>
<li>Clique com o botão direito do mouse no nó <code>MyHelloMIDlet</code> na janela Projetos e escolha <tt>Novo</tt> > <tt>MIDlet</tt>.</li>
<li>Insira <code>HelloMIDlet</code> como o nome do MIDlet (observe que "MID" não está em maiúsculas por default). Clique em Finalizar.<br> O arquivo <code>HelloMIDlet.java</code> será criado. </li>
<li>Clique duas vezes no arquivo <code>HelloMIDlet.java</code> para exibir o código-fonte na janela Editor do IDE.</li>
<li>Clique no Editor de Código-fonte e altere <code>classe pública HelloMIDlet se estende para MIDlet</code> para
<pre class="examplecode">public class HelloMIDlet
extends MIDlet implements javax.microedition.lcdui.CommandListener
{</pre>
</li>
<li>Adicione o seguinte texto antes do método <code>startApp()</code>:
<pre class="examplecode">
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, &quot;Hello Test Code&quot;, 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(&quot;Exit&quot;, javax.microedition.lcdui.Command.EXIT,
1);
}
return exitCommand;
}
javax.microedition.lcdui.TextBox helloTextBox;
javax.microedition.lcdui.Command exitCommand;
</pre>
</li>
<li>Adicione uma linha <code>initialize();</code> ao método <code>startApp()</code> para que tenha a seguinte aparência:
<pre class="examplecode"> public void startApp() {
initialize();
}
</pre></li>
</ol>
<h3 class="tutorial">Editando o Código-fonte Java</h3>
<p>Agora, vamos adicionar texto ao MIDlet para exibição.</p>
<p>No método <code>get_hellotextbox()</code>, substitua o exemplo <code>Hello Test Code</code> com o texto de sua escolha (por exemplo, <code>Make My Day</code>).</p>
<p class="notes"><b>Observação:</b> para obter um guia completo para usar as funcionalidades de assistência de código, opções de personalização e recursos de navegação do Editor Java do NetBeans IDE consulte a <a href="../java/editor-codereference.html">Assistência ao Código no Editor Java do NetBeans IDE</a>.</p>
<h3 class="tutorial">Compilando e Executando o Projeto</h3>
<p>Selecione <tt>Executar</tt> > <tt>Executar Projeto (MyHelloMIDlet)</tt> na barra de ferramentas principal do IDE. Siga o progresso da compilação do projeto na janela de Saída. Note que o arquivo <code>HelloMIDlet.java</code> é construído antes de ser executado. Um emulador de dispositivo abre para exibir os resultados do MIDlet executado e exibe o texto inserido no código fonte.</p>
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/emulator.png" rel="lytebox" title="Mensagem "Make My Day" no emulador default Java ME SDK"> <img alt="Mensagem "Make My Day" no emulador default Java ME SDK" border="1" src="../../../images_www/articles/74/javame/quickstart/emulator-small.png"></a></p>
<p>Para fechar o MIDlet e a janela do emulador, selecione Aplicação > Sair na janela emulador.</p>
</div>
<h2><a name="vmd"></a>Criando uma Aplicação MIDP Utilizando o Visual Mobile Designer</h2>
<p>O NetBeans IDE fornece um assistente que permite que você crie rapidamente um projeto MIDP. Ao criar o projeto, você pode optar por desenvolver a aplicação no Visual Mobile Designer (VMD) ou no Editor de Código-fonte. Utilizar o VMD fornece a habilidade de planejar visualmente o fluxo da aplicação e o design da tela nas utilizações da aplicação. O designer cria automaticamente o código para a aplicação conforme as alterações são salvas na tela de design. </p>
<p class="alert"><b>Importante:</b> para executar o Visual Mobile Designer no IDE você precisará instalar o plug-in do Visual Mobile Designer da Central de Atualização da seguinte forma:</p>
<ol>
<li>Selecione Ferramentas > Plug-ins do menu principal.</li>
<li>Na aba Plug-ins Disponíveis da caixa de diálogo Plug-ins, selecione Visual Mobile Designer e clique em Instalar. </li>
<li>Pelo a página de Boas-vindas da caixa de diálogo do Instalador, clique em Próximo. </li>
<li>Na página Contrato de Licença, leias os contratos associados ao plug-in. Se você concordar com os todos os termos da licença do contrato, clique na opção apropriada e, em seguida, clique em Instalar.</li>
<li>(Opcional) Selecione Executar na opção do Segundo Plano para executar a instalação no segundo plano.</li>
<li>Quando o processo de instalação for concluído, clique em Finalizar. </li>
<li>Na caixa de diálogo Plug-ins, clique em Fechar.</li>
</ol>
<h3 class="tutorial">Criando uma Aplicação MIDP/CLDC </h3>
<ol>
<li>Selecione <tt>Arquivo</tt> > <tt>Novo Projeto (Ctrl+Shift+N)</tt>. Em Categorias, selecione <tt>Java ME</tt>. Em Projetos, selecione <tt>Aplicação Móvel</tt> e clique em Próximo.</li>
<li>Insira <code>MyHello</code> no campo Nome do Projeto. Use o Local de Projeto default ou altere-a para o diretório de sua preferência no sistema. Neste tutorial, esse diretório é definido como <code>$PROJECTHOME</code>. </li>
<li>Marque a caixa de seleção <tt>Criar Pacote Default e Classe Executável Principal</tt>. Clique em Próximo. </li>
<li>Selecione o default como a plataforma do emulador e utilize os defaults restantes. Clique em Finalizar. </li>
<li>O IDE cria a pasta do projeto <code>$PROJECTHOME/MyHello</code>. A pasta do projeto contém todos os códigos-fonte e os metadados do projeto, como o script Ant do projeto. A aplicação é exibida na janela Design de Fluxo do Visual Mobile Designer.
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/newjavameproject.png" rel="lytebox" title="View do fluxo no Hello MIDlet no IDE"><img alt="View do fluxo no Hello MIDlet no IDE" border="1" src="../../../images_www/articles/74/javame/quickstart/newjavameproject-small.png"></a></p>
<p class="notes"><b>Observação:</b> para uma descrição completa dos componentes da paleta disponíveis, consulte a <a href="http://wiki.netbeans.org/VisualMobileDesignerPalatteReference">Referência da Paleta do Visual Mobile Designer</a>.</p>
</li>
</ol>
<h3 class="tutorial">Editando o Código-fonte Java</h3>
<p>Agora, vamos editar o texto exibido pelo MIDlet.</p>
<ol>
<li>Em <tt>HelloMIDlet.java</tt> clique em Tela para mostrar a janela View da Tela exibindo a Tela do Dispositivo, que é a única tela disponível na aplicação. </li>
<li>Clique na mensagem <tt>Hello World!</tt> na Tela do Dispositivo. Na janela Propriedades, clique no texto <tt>Hello World!</tt> para modificar a mensagem de boas-vindas e pressione Enter. Neste exemplo, digitamos <tt>Make my day</tt>.
<p class="align-center"><img alt="O texto 'Make my day' foi digitado no campo de texto da janela Propriedades." src="../../../images_www/articles/73/javame/quickstart/stringedit.png"></p></li>
<li>A View da Tela exibe o texto inserido no campo Texto.
<p class="align-center"><a href="../../../images_www/articles/73/javame/quickstart/screen.png" rel="lytebox" title="'Make my day' na exibição da Tela do Dispositivo na View de Tela VMD"><img alt="O texto 'Make my day' é visível na exibição da Tela do Dispositivo na view de Tela VMD." border="1" src="../../../images_www/articles/73/javame/quickstart/screen-small.png"></a></p></li>
</ol>
<h3 class="tutorial">Compilando e Executando o Projeto</h3>
<ol>
<li>Selecione <tt>Executar</tt> > <tt>Executar Projeto (MyHello)</tt> na barra de ferramentas principal do IDE. Siga o progresso da compilação do projeto na janela de Saída. Observe que o arquivo <code>HelloMIDlet.java</code> é construído antes de ser executado. Um emulador de dispositivo é aberto para exibir os resultados do MIDlet executado. O emulador de dispositivo inicia o MIDlet e exibe o texto inserido no código-fonte.
<p class="tips">É possível especificar o emulador para executar o MIDlet ao clicar com o botão direito do mouse no nó do projeto e selecionar <tt>Executar Com..</tt> no menu de contexto. O <tt>JavaMEPhone1</tt> disponível no Java ME SDK 3.4 é mostrado abaixo.</p>
<p class="align-center"><a href="../../../images_www/articles/74/javame/quickstart/emulator-screen.png" rel="lytebox" title="Mensagem "Make My Day" exibida no emulador de telefone default do Java ME SDK"><img alt="Mensagem "Make My Day" exibida no emulador de telefone default do Java ME SDK" border="1" src="../../../images_www/articles/74/javame/quickstart/emulator-screen-small.png"></a></p></li>
<li>Na janela emulador, selecione Aplicação > Sair para fechar o MIDlet e a janela do emulador.</li>
</ol>
<div class="feedback-box"><a href="/about/contact_form.html?to=6&subject=NetBeans%20MIDP%20Development%20Quick%20Start%20Guide">Enviar Feedback neste Tutorial</a></div>
<br style="clear:both;" >
<h2><a name="nextsteps"></a>Próximas Etapas </h2>
<ul>
<li><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb7400&id=NBDAG1552">Desenvolvendo Aplicações Java ME</a> em <i>Desenvolvendo Aplicações com o NetBeans IDE</i></li>
<li><a href="../../trails/mobility.html" target="_blank">Trilha de Aprendizado de Java ME no NetBeans IDE</a></li>
<li><a href="http://docs.oracle.com/javame/mobile/mobile.html" target="_blank">Documentção do Java para Dispositivos Móveis</a></li>
<li><a href="http://docs.oracle.com/javame/developer/developer.html" target="_blank">Documentação de Java ME e Java Card</a></li>
</ul>
</body>
</html>