blob: 700ba5baec378a93184473d7381e61bdafce8912 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- Copyright (c) 2009, 2012, Oracle and/or its affiliates. All rights reserved. -->
<!-- Use is subject to license terms.-->
<html>
<head>
<title>Criando, Depurando e Criando Perfil de uma Aplicação Incorporada Móvel - 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">
</head>
<body>
<a name="top"></a>
<h1>Criando, Depurando e Criando Perfil em uma Aplicação Incorporada Móvel</h1>
<div class="articledate" style="margin-left: 0px;"> Sungmoon Cho, Alyona Stashkova</div>
<p>As aplicações incorporadas móveis são empregadas em dispositivos incorporados pequenos, como dispositivos de medição industrial, máquinas de vendas de produtos, sistemas de segurança, modems, eletrodomésticos e similares com a exibição simples ou nenhuma exibição e com conectividade de rede limitada. Este exemplo mostra como desenvolver um novo projeto Java ME incorporado no NetBeans IDE usando a plataforma Oracle Java Micro Edition Embedded que inclui suporte a <a href="http://jcp.org/en/jsr/detail?id=228">JSR 228</a>, a API IM-NG (de perfil de módulo de informações de última geração). Ele explicará ainda como depurar e criar perfil no seu IMlet usando suporte a NetBeans para Oracle Java ME Embedded.</p>
<h3>Conteúdo</h3>
<img alt="O conteúdo desta página se aplica ao NetBeans IDE 7.3 e mais recente" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-80-74-73.png" title="O conteúdo desta página se aplica ao NetBeans IDE 7.3 e mais recente">
<ul>
<li><a href="#install" title="Instalando o Oracle Java ME Embedded">Instalando o Oracle Java ME Embedded</a></li>
<li><a href="#create" title="Criando um Projeto Incorporado">Criando um Projeto Incorporado</a></li>
<li><a href="#run" title="Executando a Aplicação">Executando a Aplicação</a></li>
<li><a href="#debug" title="Depurando a Aplicação">Depurando a Aplicação</a></li>
<li><a href="#profile" title="Criando Perfil da Aplicação">Criando Perfil da Aplicação</a></li>
<li><a href="#nextsteps" title="Consulte Também">Consulte Também</a></li>
</ul>
<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="https://netbeans.org/downloads/index.html">NetBeans IDE com Java ME</a></td>
<td class="tbltd1">Versão 7.3 e mais recente</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java Development Kit</a> (JDK)</td>
<td class="tbltd1">Versão 6, 7 ou 8 </td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Java ME SDK</a></td>
<td class="tbltd1">Versão 3.2 e mais recente </td>
</tr>
</tbody>
</table>
<p class="alert"><b>Importante:</b> Este tutorial só é executado em plataformas compatíveis com Win32.</p>
<h2><a name="install"></a>Instalando o Oracle Java ME Embedded</h2>
<p>Para configurar o NetBeans IDE com o software Oracle Java ME Embedded 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 Embedded 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 de um arquivo do instalador do Oracle Java ME SDK (por exemplo, oracle-jmesdk-3-4-rr-win32-bin.exe) e salve-o em qualquer local em 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 ( <img alt="Ícone do Gerenciador de Dispositivo do Java (TM) ME Platform SDK 3.2" src="../../../images_www/articles/73/javame/imp-ng/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/73/javame/imp-ng/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/73/javame/imp-ng/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/73/javame/imp-ng/installer.png" rel="lytebox" title="Caixa de diálogo Instalador"> <img alt="Caixa de diálogo Instalador" border="1" src="../../../images_www/articles/73/javame/imp-ng/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 Embedded:</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/73/javame/imp-ng/jpmanager.png" rel="lytebox" title="Painel Nome e Local"> <img alt="Painel Nome e Local" border="1" src="../../../images_www/articles/73/javame/imp-ng/jpmanager-small.png"></a></p></li>
<li>Clique em Adicionar Plataforma.</li>
<li>Em Selecionar Tipo de Plataforma do assistente Adicionar Plataforma Java, selecione Java ME CLDC Platform Emulator e clique em Próximo.<br> O IDE exibirá o diretório Escolher para a pesquisa de 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.2</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/73/javame/imp-ng/jpdetected.png" rel="lytebox" title="Plataforma J2ME detectada"> <img alt="Plataforma J2ME detectada" border="1" src="../../../images_www/articles/73/javame/imp-ng/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/73/javame/imp-ng/jpregistered.png" rel="lytebox" title="Plataforma J2ME registrada"> <img alt="Plataforma J2ME registrada" border="1" src="../../../images_www/articles/73/javame/imp-ng/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="create"></a>Criando um Projeto Incorporado </h2>
<p>A criação de novos projetos é a primeira etapa para desenvolver uma nova aplicação Java ME Embedded com o NetBeans IDE. </p>
<ol>
<li>Escolha Arquivo > Novo Projeto.<br> A caixa de diálogo Novo Projeto é exibida.</li>
<li>Selecione a categoria de Java ME e o projeto da Aplicação Incorporada. Clique em Próximo.</li>
<li>No painel Nome e Local do assistente Nova Aplicação Incorporada, especifique <tt>EmbeddedApp</tt> como nome do projeto.
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/newappname.png" rel="lytebox" title="Painel Nome e Local"> <img alt="Painel Nome e Local" border="1" src="../../../images_www/articles/73/javame/imp-ng/newappname-small.png"></a></p></li>
<li>Deixe a opção Criar Pacote Default e Classe de IMlet selecionada e clique em Próximo.</li>
<li>Verifique se CLDC Oracle Java(TM) Platform Micro Edition SDK está selecionado na plataforma do emulador e se IMPNGPhone1 está selecionado como dispositivo. </li>
<li>Clique em Finalizar.<br>Uma aplicação IMP-NG com um IMLet será criado em um projeto IDE padrão.
<p class="align-center"><img alt="Novo projeto criado" border="1" src="../../../images_www/articles/73/javame/imp-ng/prjcreated.png"></p></li>
</ol>
<p class="align-center"><a href="#top">início</a></p>
<h2><a name="run"></a>Executando a Aplicação</h2>
<p>Para verificar se a aplicação está sendo executada corretamente, modifique o código-fonte da aplicação, como a seguir:</p>
<ol>
<li>Na janela Projetos, clique duas vezes no arquivo <tt>IMlet.java</tt> e escolha Editar. <br>O IDE abrirá o arquivo <tt>IMlet.java</tt> no Editor de Código-fonte. </li>
<li>Role a tela pelo código-fonte e localize o método <tt>StartApp</tt> principal.</li>
<li>Insira a seguinte linha em negrito no corpo do método <tt>StartApp</tt>:
<pre class="examplecode"> public void startApp() {
<b>System.out.println(&quot;Hello, world!&quot;);</b>
}</pre></li>
<li>Escolha Arquivo > Salvar no menu principal do IDE para salvar as edições.</li>
</ol>
<p>Agora que você criou a aplicação, pode executá-la no IDE conforme descrito a seguir:</p>
<ol>
<li>Clique com o botão direito do mouse no nó do projeto <tt>EmbeddedApp</tt> e escolha Limpar e Construir.<br> A janela de Saída exibirá a instrução BUILD SUCCESSFUL.
<p class="notes"><b>Observação:</b> Escolha Janela > Saída > Saída no menu principal do IDE, caso a janela de Saída não esteja visível.</p>
</li>
<li>Na barra de menu IDE, escolha Executar > Executar Projeto.<br> O emulador IMPNGPhone1 é iniciado e exibe a aplicação EmbeddedApp em execução.
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/emulator.png" rel="lytebox" title="Emulador"> <img alt="Emulador" border="1" src="../../../images_www/articles/73/javame/imp-ng/emulator-small.png"></a></p>
<p class="notes"><b>Observação:</b> Mais informações sobre o Java ME Embedded Emulator estão disponíveis no <a href="http://docs.oracle.com/javame/config/cldc/rel/3.2/get-started-win/title.htm">Oracle Java ME Embedded Getting Started Guide for the Windows 32 Platform</a>.</p>
Na janela de Saída, você deverá ver a saída do programa, <code>Hello, world!</code>
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/output.png" rel="lytebox" title="Saída"> <img alt="Saída" border="1" src="../../../images_www/articles/73/javame/imp-ng/output-small.png"></a></p></li>
<li>No emulador, selecione <tt>Aplicação Incorporada (em execução)</tt> e clique em Suspender, à direita.<br> A aplicação está pausada. </li>
<li>Clique em Retomar.<br> A aplicação retoma a execução. </li>
<li>Para interromper a aplicação e fechar o emulador, clique em Interromper e escolha Aplicação > Sair do menu do emulador.<br> O processo de execução é encerrado no IDE.</li>
</ol>
<p class="align-center"><a href="#top">início</a></p>
<h2><a name="debug"></a>Depurando a Aplicação</h2>
<p>A depuração dos projetos incorporados é obtida da mesma forma que a de projetos Java em geral.</p>
<p>Clique com o botão direito do mouse no projeto, escolha Depurar para iniciar uma sessão de depuração. O emulador é aberto e a execução do programa é interrompida em qualquer ponto de interrupção definido.</p>
<p class="align-center"><a href="#top">início</a></p>
<h2><a name="profile"></a>Criando Perfil da Aplicação</h2>
<p>Use tarefas comuns de criação de perfil, como CPU padrão ou criação de perfil de memória, para criar uma aplicação incorporada móvel confiável.</p>
<p>Antes de criar perfil da aplicação, você deve instalar o plug-in das Ferramentas Java ME SDK, como a seguir:</p>
<ol>
<!--<li>Go to the <a href="http://www.oracle.com/technetwork/java/javame/javamobile/download/sdk/index.html">Java ME SDK download</a> page.</li>
<li>Click the Accept License Agreement option.</li>
<li>Download the <a href="http://download.oracle.com/otn-pub/java/java_me_sdk/3.2/nb-me-sdk-plugins-uc.zip">nb-me-sdk-plugins-uc.zip</a> file and save it on your computer.</li>
<li>Unpack the archive to a folder on your hard drive (for example, <code>C:/mesdk_nb</code>).</li>-->
<li>No NetBeans IDE, escolha Ferramentas > Plug-ins.</li>
<!--<li>In the Plugins Manager, select the Settings tab and click Add.
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/add.png" rel="lytebox"
title="The Add button highlighted">
<img src="../../../images_www/articles/73/javame/imp-ng/add-small.png"
alt="The Add button highlighted" border=1></a></p></li>
<li>In the Name field of the Update Center Customizer dialog box, type <code>Java ME SDK Plugins</code>.</li>
<li>In the URL text field, specify the path to the <code>updates.xml</code> file in the directory where you unpacked the <code>nb-me-sdk-plugins-uc.zip</code> file (for example, <code>file:/c:/mesdk_nb/updates.xml</code>) and click OK.<br>
The Java ME SDK Plugins configuration displays in the Configuration of the Update Centers list on the Setting tab.
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/settings-plugins.png" rel="lytebox"
title="Java ME SDK Plugins added">
<img src="../../../images_www/articles/73/javame/imp-ng/settings-plugins-small.png"
alt="Java ME SDK Plugins added" border=1></a></p></li>-->
<li>No Gerenciador de Plug-ins, selecione a guia Plug-ins Disponíveis.</li>
<li>Na guia Plug-ins Disponíveis, role a tela para localizar o plug-in das Ferramentas Java ME SDK e selecione-o para instalação.
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/available-plugins.png" rel="lytebox" title="Plug-ins Java ME SDK adicionados"> <img alt="Plug-ins Java ME SDK adicionados" border="1" src="../../../images_www/articles/73/javame/imp-ng/available-plugins-small.png"></a></p></li>
<li>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>Quando o processo de instalação for concluído, deixe a opção Reiniciar IDE agora selecionada e clique em Finalizar. </li>
</ol>
<p>Quando o NetBeans IDE for selecionado, você poderá iniciar o uso do IDE para criar perfil na sua aplicação incorporada móvel.</p>
<ol>
<li>Na guia Projetos do IDE, selecione o nome do projeto <code>EmbeddedApp</code>.</li>
<li>Escolha Perfil > Projeto de Perfil no menu principal para iniciar uma sessão de criação de perfil.
<p class="notes"><b>Observação:</b> Você será solicitado a integrar o criador de perfil quando um projeto tiver o perfil criado pela primeira vez. </p>
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/enable.png" rel="lytebox" title="Plug-ins Java ME SDK adicionados"> <img alt="Plug-ins Java ME SDK adicionados" border="1" src="../../../images_www/articles/73/javame/imp-ng/enable-small.png"></a></p>
</li>
<li>(Aplicável se essa for a primeira vez que um perfil é criado no projeto) Na caixa de diálogo Ativar Criação de Perfil, clique em Sim para executar a integração.</li>
<li>Na caixa de diálogo Perfil, escolha Criador de Perfil de CPU e, opcionalmente, marque Classes de Sistema do Perfil.</li>
<li>Clique em Executar.<br> O emulador é aberto com a aplicação <code>EmbeddedApp</code> em execução.</li>
<li>Interaja com a aplicação.</li>
<li>Saia da aplicação ou feche o emulador. <br>O IDE exibirá os dados de perfil na janela <code>cpu:<i>time</i></code>.
<p class="align-center">
<a href="../../../images_www/articles/73/javame/imp-ng/cpu.png" rel="lytebox" title="A janela cpu: tempo"> <img alt="A janela cpu: tempo" border="1" src="../../../images_www/articles/73/javame/imp-ng/cpu-small.png"></a></p>
<p class="notes"><b>Observação:</b> Para salvar os dados coletados durante a sessão de emulação para futura referência, você pode:</p>
<ul>
<li>exportar os dados para um arquivo <code>nps</code> clicando no botão Exportar para (<img alt="Botão Exportar para" border="1" src="../../../images_www/articles/73/javame/imp-ng/export.png">)</li>
<li>salvar uma tela em um arquivo <code>png</code>, clicando no botão Salvar View Atual como Imagem (<img alt="Botão Salvar View Atual como Imagem" border="1" src="../../../images_www/articles/73/javame/imp-ng/image.png">)</li>
</ul>
</li>
</ol>
<div class="feedback-box"><a href="/about/contact_form.html?to=6&subject=Creating,%20Debugging,%20and%20Profiling%20an%20Embedded%20Application">Enviar Feedback neste Tutorial</a></div>
<br style="clear:both;" >
<p class="align-center"><a href="#top">início</a></p>
<h2><a name="nextsteps"></a>Consulte Também</h2>
<ul>
<li><a href="imp-ng-screencast.html" target="_blank">Demonstração: Suporte para Perfil IMP-NG no NetBeans IDE</a></li>
<li><a href="http://www.oracle.com/technetwork/java/javame/javamobile/training/jmesdk/index.html" target="_blank">Java Mobile - Comece a Aprender</a></li>
<li><a href="http://www.oracle.com/technetwork/java/embedded/resources/me-embeddocs/index.html" target="_blank">Documentação do Cliente do Oracle Java ME Embedded</a></li>
<li><a href="https://blogs.oracle.com/javamesdk/" target="_blank">Blog da Equipe do Java ME SDK</a></li>
<li><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG1552">Desenvolvendo Aplicações Java ME</a> em <i>Desenvolvendo Aplicações com o NetBeans IDE</i></li>
</ul>
<p class="align-center"><a href="#top">início</a></p>
</body>
</html>