| <!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, "Hello Test Code", 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; |
| </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> |