blob: 974a3415d78dea283e846c7bbcef1e6edfd4f50d [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 6.9, 7.0 ou 7.1, consulte o <a href="../../71/javame/quickstart.html">Guia de Início Rápido ao Desenvolvimento em NetBeans IDE 6.9, 7.0 ou 7.1 Java ME MIDP</a>.</p>
</ul>
<h3>Conteúdo</h3>
<img alt="O conteúdo desta página se aplica ao NetBeans IDE 7.2" class="stamp" src="../../../images_www/articles/72/netbeans-stamp.gif" title="O conteúdo desta página aplica-se ao NetBeans 7.2">
<ul>
<li><a href="#reqs" title="Requisitos do Tutorial">Requisitos do Tutorial</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="https://netbeans.org/downloads/index.html" target="_blank">NetBeans IDE com Java ME</a></td>
<td class="tbltd1">Versão 7.2 </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 6 ou 7 </td>
</tr>
</tbody>
</table>
<br>
<p><b class="notes">Observação</b>: o emulador que vem com o IDE varia dependendo de qual instalador de sistema operacional foi baixado.</p>
<ul>
<li>As distribuições para Windows do NetBeans 7.1,7.1.1 e 7.2 vêm junto com o Java ME SDK 3.0.5.</li>
<li>A distribuição para Linux do NetBeans IDE é oferecida com o Sun Java Wireless Toolkit 2.5.2.</li>
<li>A versão OS X do NetBeans IDE vem com o Java ME SDK 3.0 para CLDC.</li>
</ul>
<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>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>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 Olá MIDlet 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 do Explorer e selecione <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> é criado e o código-fonte é exibido 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="../../../kb/73/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</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 class="align-center"><a href="../../../images_www/articles/72/javame/quickstart/mmd-emulator.png" rel="lytebox" title="Mensagem "Make My Day" no emulador CLDC default do Java SDK 3.0.5"> <img alt="Mensagem "Make My Day" no emulador CLDC default do Java SDK 3.0.5" border="1" src="../../../images_www/articles/72/javame/quickstart/mmd-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="notes"><b>Observação:</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>
</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>Selecione a caixa de seleção <tt>Criar Hello MIDlet</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/72/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/72/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/72/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/72/javame/quickstart/motd-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/72/javame/quickstart/motd-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 (F6)</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>DefaultFXPhone1</tt> disponível no Java ME SDK 3.0.5 é mostrado abaixo.</p>
<p class="align-center"><a href="../../../images_www/articles/72/javame/quickstart/motd-emulator.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/72/javame/quickstart/motd-emulator-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>
<p>Para mais tutoriais mostrando como desenvolver aplicações MIDP e CLDC visite a Trilha de Aprendizado de Aplicação Móvel.</p>
<ul>
<li><a href="../../trails/mobility.html">Trilha de Aprendizado de Java ME no NetBeans IDE</a></li>
</ul>
</body>
</html>