| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <!-- |
| Copyright (c) 2011 Oracle and/or its affiliates. All rights reserved. |
| --> |
| <html> |
| <head> |
| <title>Configurando o NetBeans IDE com o JavaFX 2.1</title> |
| <meta name="KEYWORDS" content="NETBEANS, JAVAFX"> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <meta name="DESCRIPTION" content="How to set up NetBeans IDE to use with JavaFX 2.1 when the two are installed separately" > |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css" media="screen"></head> |
| <body> |
| <h1>Configurando o NetBeans IDE com o JavaFX 2.1</h1> |
| <p>O JavaFX fornece uma poderosa plataforma de IU com base em Java capaz de manipular uma grande quantidade de aplicações comerciais orientada a dados. O JavaFX 2 é uma atualização importante da plataforma JavaFX. Iniciando com essa versão, os desenvolvedores podem criar aplicações JavaFX completamente em Java. </p> |
| <p>O NetBeans IDE suporta a criação de aplicações JavaFX 2.0.</p> |
| <p><b>Conteúdo</b></p> |
| <p><img alt="O conteúdo desta página se aplica ao NetBeans IDE 7.1" class="stamp" height="114" src="../../../images_www/articles/71/netbeans-stamp-71-72.gif" title="O conteúdo desta página se aplica ao NetBeans IDE 7.1" width="114"></p> |
| <ul> |
| <li><a href="#installing">Instalando o NetBeans IDE e o JavaFX 2.1 SDK</a> </li> |
| <li><a href="#upgrade">Fazendo Upgrade do JavaFX 2</a></li> |
| <li><a href="#create-platform">Criando uma Plataforma Java Compatível com JavaFX</a> |
| <ul> |
| <li><a href="#open-newapp-wiz">Abrindo o Assistente de Nova Aplicação JavaFX</a></li> |
| <li><a href="#create-platform-manual">Criando Manualmente uma Plataforma Compatível com JavaFX</a></li> |
| </ul> |
| </li> |
| <li><a href="#tutorials">Tutorials</a></li> |
| <li><a href="#troubleshooting">Solução de Problemas</a></li> |
| </ul> |
| |
| <p><b>Para seguir este tutorial, são necessários os recursos e o software a seguir.</b></p> |
| <table> |
| <tbody> |
| <tr> |
| <th width="208" class="tblheader" scope="col">Software ou Recurso</th> |
| <th width="218" 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</a></td> |
| <td class="tbltd1">7.1.2 Java SE, Java EE, ou Todos</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javafx/downloads/index.html" target="_blank">JavaFX 2.1 SDK</a></td> |
| <td class="tbltd1">Release mais recente |
| </tr> |
| </tbody> |
| </table> |
| |
| |
| |
| |
| |
| <h2><a name="installing"></a>Instalando o NetBeans IDE e o JavaFX 2.1 SDK</h2> |
| |
| <p>Dependendo de seu sistema operacional, você pode instalar o JavaFX 2.1.1 empacotado com o Java JDK. Caso contrário, será necessário instalar o JavaFX 2.1 separadamente.</p> |
| <ul> |
| <li>Para o Windows, o JavaFX 2.1.1 é empacotado com o JDK 1.7 atualização 4. Se você instalar o Java FX 2.1 SDK e Runtime empacotados nas localizações default, o NetBeans IDE pode <a href="#create-platform">criar uma plataforma Java ativada por JavaFX</a> automaticamente.</li> |
| <li>Para MacOS, JavaFX 2.1 é incorporado no Mac JDK 1.7 atualização 4. O NetBeans IDE pode <a href="#create-platform">criar uma plataforma Java ativada por JavaFX</a> automaticamente.</li> |
| <li>Você também pode instalar o JavaFX 2.1 separadamente no <a href="http://www.oracle.com/technetwork/java/javafx/downloads/index.html" target="_blank">site de download do JavaFX</a>. O JavaFX 2.1 requer o Java JDK 1.6.0, atualização 26 ou mais recente, ou o Java 7. O JavaFX não é executado em todos os sistemas operacionais. Verifique o <a href="http://download.oracle.com/javafx/2/system_requirements/jfxpub-system_requirements.htm" target="_blank">documento de Requisitos do Sistema do JavaFX</a> para ver quais plataformas são suportadas pelo JavaFX. Os requisitos do sistema para o JavaFX 2.1 também permite a instalação do NetBeans IDE.</li> |
| </ul> |
| <p class="alert"><strong>Importante:</strong> Para desenvolver JavaFX no Mac, você precisa de Mac JDK 7 atualização 4, JavaFX 2.1 (empacotado com Mac JDK 7u4) e NetBeans IDE 7.1.2 ou mais recente. Se tiver NetBeans IDE 7.1 ou 7.1.1, instale todas as atualizações disponíveis para fazer upgrade para NetBeans IDE 7.1.2.</p> |
| <p class="notes"><strong>Observação:</strong> Quando você instala o JavaFX 2.1 no Windows, você instala dois pacotes: o JavaFX 2.1 SDK e o JavaFX 2.1 Runtime.</p> |
| <p>Se você instalar o JavaFX 2.1 manualmente para Windows, instale o JavaFX 2.1 SDK e Runtime e para a localização default (<tt>C:/Program Files/Oracle/</tt>). O NetBeans IDE verifica as localizações default do Windows para o JavaFX 2.1 SDK e o JavaFX 2.1 Runtime. Se o JavaFX 2 estiver nos locais default, o NetBeans IDE automaticamente cria uma plataforma Java Ativada por JavaFX. Se você instalar o JavaFX 2.1 Java encapsulado com JDK, o NetBeans pode localizar o JavaFX 2.1 SDK e Runtime.</p> |
| <p>Se você instalar o JavaFX 2.1 para MacOS manualmente, não há localização default e você deve <a href="#create-platform">criar uma plataforma Java Ativada por JavaFX</a> manualmente.</p> |
| <h2 id="upgrade">Fazendo Upgrade do JavaFX 2</h2> |
| <p>Se quiser fazer upgrade de uma versão de JavaFX 2 para outra (por exemplo, de JavaFX 2.0 para JavaFX 2.1), é mais seguro desinstalar a versão mais antiga do JavaFX 2. <span class="alert">Desinstale manualmente a versão antiga e certifique-se de que seus diretórios foram deletados. O instalador do JavaFX nem sempre desinstala versões mais antigas do JavaFX 2 corretamente, o que pode levar ao uso da versão errada. </span></p> |
| <p>Além disso, você pode ter um problema se o novo local SDK FX diferir do antigo. A plataforma ativada por FX default existente pode ainda apontar para o local antigo. Neste caso, abra Ferramentas > Plataformas Java e delete a plataforma ativada por FX default. Em seguida, <a href="#create-platform">crie uma nova plataforma ativada por FX default</a> usando a versão atualizada do JavaFX 2.</p> |
| <h2><a name="create-platform"></a>Criando uma Plataforma Java compatível com JavaFX</h2> |
| <p>Netbeans IDE requer um JavaFX ativado 2.1 Java Platform para usar o JavaFX 2.1. Esta seção descreve como criar uma plataforma Java ativada por JavaFX 2.1 no NetBeans IDE.</p> |
| <p>O NetBeans IDE tenta criar uma plataforma java ativada por JavaFX quando você inicia um Novo assistente de projeto JavaFX ou abre um projeto JavaFX existente pela primeira vez. Se o NetBeans IDE não puder criar uma plataforma Java compatível com JavaFX automaticamente, uma advertência aparecerá. Nesse caso, você deve criar uma plataforma Java compatível com JavaFX manualmente. Será possível criar plataformas Java compatíveis com JavaFX, por exemplo, se você desejar que ela usem JDKs Java diferentes.</p> |
| <p>O procedimento nessa seção é dividido em duas partes, para refletir a criação da plataforma de forma manual ou automática:</p> |
| <ul> |
| <li><strong>Abrindo o Assistente de Nova Aplicação JavaFX.</strong> Este é o ponto inicial universal. Quando você abre o assistente, o NetBeans IDE tenta criar uma plataforma Java compatível com JavaFX. Se o NetBeans tiver êxito, você finalizou. </li> |
| <li><strong>Criando Manualmente uma Plataforma Compatível com JavaFX.</strong> Se a geração da plataforma automática falhar ou você quiser uma plataforma adicional ativada por JavaFX, você deve criar a plataforma manualmente.</li> |
| </ul> |
| <div class="indent"> |
| <h3><a name="open-newapp-wiz"></a>Abrindo o Assistente de Nova Aplicação JavaFX</h3> |
| <p>A primeira etapa para criar uma plataforma Java compatível com JavaFX é abrir o Assistente de Nova Aplicação JavaFX do NetBeans IDE. (Em vez disso, você pode abrir o assistente de Novo Pré-Carregador JavaFX.) Se o IDE não encontrar uma plataforma Java compatível com JavaFX, o IDE tentará gerar uma plataforma Java compatível com JavaFX. Se o IDE tiver êxito ao criar a plataforma Java compatível com JavaFX, a instalação estará completa. Se o IDE não gerar uma plataforma Java compatível com JavaFX, será necessário criar a plataforma manualmente.</p> |
| <p class="notes"><b>Observação:</b> a geração da plataforma automática funciona no Windows com JavaFX SDK e Runtime instalado na localização default (<tt>C:\Arquivos de Programa\Oracle\</tt>) e no MacOS com o JavaFX SDK incorporado no Mac JDK 7u4.</p> |
| <p><strong>Para abrir o Assistente de Nova Aplicação JavaFX:</strong></p> |
| <ol> |
| <li>No IDE, clique no ícone Novo Projeto (ou Arquivo > Novo Projeto ou Ctrl-Shift-N). O assistente para Novo Projeto é aberto. <br><img alt="Primeiro painel da janela Novo Projeto com a Aplicação JavaFX selecionada" class="margin-around" height="434" src="../../../images_www/articles/72/java/javafx-setup/new-project.png" width="600"></li> |
| <li>Selecione a categoria JavaFX. Em Projetos, selecione Aplicação JavaFX. Clique em Próximo. O painel Nome e Localização é aberto. O IDE procura pelo JavaFX SDK e tenta gerar uma plataforma Java compatível com JavaFX. </li></ol> |
| <p>Uma das duas telas serão exibidas, dependendo se o NetBeans IDE gerou ou não uma plataforma compatível com JavaFX:</p> |
| <ul> |
| <li><b>A plataforma foi gerada:</b> O IDE gerou uma plataforma Java compatível com JavaFX. Essa plataforma compatível com JavaFX usa os mesmos códigos-fonte do JDK que o IDE usa por default. O nome da plataforma gerada é Plataforma Java FX Default. O IDE seleciona automaticamente essa plataforma. Sua configuração está completa, a menos que você deseje a criação de uma plataforma Java compatível com JavaFX. Agora você pode fazer os <a href="#tutorials">Tutoriais</a>. Se você deseja criar plataformas Java compatíveis com JavaFX adicionais, consulte <a href="#create-platform-manual">Criando Manualmente uma Plataforma Java Compatível com JavaFX</a>.<br> <img alt="Assistente Nova Aplicação JavaFX que mostra a plataforma gerada automaticamente" class="margin-around" height="496" src="../../../images_www/articles/72/java/javafx-setup/newproject-autogen-platform.png" width="600"> </li> |
| <li><strong>A plataforma não foi gerada:</strong> A lista Plataforma JavaFX não mostra nenhuma plataforma compatível com JavaFX. Uma advertência é exibida na parte inferior do painel. Vá para <a href="#create-platform-manual">Criando Manualmente uma Plataforma Compatível com JavaFX</a><br> <img alt="Painel Nome e Localização do assistente do Novo Projeto, com uma plataforma Java ativada por não-JavaFX selecionada" class="margin-around" height="501" src="../../../images_www/articles/71/java/javafx-setup/newproject-nofx.png" width="578"> </li> |
| </ul> |
| <h3><a name="create-platform-manual"></a>Criando Manualmente uma Plataforma Compatível com JavaFX</h3> |
| <p>Uma plataforma Java compatível com JavaFX precisa ser criada manualmente nos seguintes casos:</p> |
| <ul> |
| <li>Falha no NetBeans IDE ao gerar uma plataforma Java compatível com JavaFX quando você <a href="#open-newapp-wiz">abriu o assistente Nova Aplicação JavaFX</a> ou o Novo Pré-Carregador JavaFX.</li> |
| <li>Você deseja uma plataforma compatível com JavaFX com base em um Java JDK diferente do JDK que o IDE usa por default. Por exemplo, seu IDE usa o Java JDK 1.6.0 atualização 27, mas você deseja construir aplicações JavaFX usando o Java 7. </li> |
| </ul> |
| <p><strong>Para criar uma plataforma compatível com JavaFX manualmente:</strong></p> |
| <ol> |
| <li>Abra o Gerenciador de Plataformas Java do NetBeans IDE. O Gerenciador de Plataformas pode ser aberto das seguintes maneiras: |
| <ul> |
| <li>No assistente Nova Aplicação JavaFX ou Novo Pré-Carregador JavaFX, clique em Gerenciar Plataformas...</li> |
| <li>Expanda o menu Ferramentas e selecione Plataformas Java.</li> |
| <li>Abra as Propriedades do Projeto de um projeto Java. Acesse a página Bibliotecas. Clique em Gerenciar Plataformas... </li> |
| </ul> |
| </li> |
| <li>Clique em Adicionar Plataforma... O assistente Adicionar Plataforma Java abre no painel Selecionar Plataforma Java. Procure pelo JDK desejado.<br> <img alt="Escolha o painel Plataforma Java do assistente Adicionar Plataforma Java que mostra plataformas disponíveis" class="margin-around" height="448" src="../../../images_www/articles/71/java/javafx-setup/addplatform.png" width="551"></li> |
| <li>Selecione um JDK. É necessário selecionar o JDK 1.6 atualização 26 ou posterior (ou o JDK 7). Clique em Próximo. O painel Nome da Plataforma é aberto.<br> <img alt="Painel Nome da Plataforma do assistente Adicionar Plataforma Java" class="margin-around" height="292" src="../../../images_www/articles/71/java/javafx-setup/platform-name.png" width="560"></li> |
| <li>Dê um nome arbitrário e descritivo para a nova plataforma e clique em Finalizar. Você retorna para o Gerenciador de Plataformas. A plataforma criada é listada.<br> <img alt="Gerenciador de Plataforma que mostra nova plataforma" class="margin-around" height="462" src="../../../images_www/articles/71/java/javafx-setup/platform-mgr-newplatform-nofx.png" width="600"></li> |
| <li>Selecione a plataforma que você criou. Abra a guia JavaFX para essa plataforma. Neste momento, o JavaFX não é compatível com essa plataforma. Marque a caixa Ativar JavaFX. Uma advertência de que a plataforma JavaFX é inválida é exibida.</li> |
| <li>Clique em Procurar próximo ao campo JavaFX SDK. Procure a pasta do JavaFX 2.1 SDK.<br> <img alt="Navegando para JavaFX 2.1 SDK" class="margin-around" height="340" src="../../../images_www/articles/71/java/javafx-setup/sdk-location.png" width="498"></li> |
| <li>Clique em Abrir. Você retorna para o Gerenciador de Plataformas Java. Os campos JavaFX SDK e JavaFX Javadoc agora estão preenchidos. Se JavaFX Runtime 2.0 estiver no mesmo diretório que JavaFX 2.1 SDK, o campo JavaFX Runtime também estará preenchido. Se JavaFX Runtime estiver em um diretório diferente do diretório do SDK, procure pelo Runtime. Você não precisa de nada no campo Códigos-fonte. |
| <p>Clique em Fechar caso existam valores para os campos JavaFX 2.1 SDK, JavaFX Javadoc e JavaFX Runtime e não há qualquer advertência de que a plataforma JavaFX é inválida. Sua plataforma compatível com JavaFX está concluída.<br> <img alt="Gerenciador de Plataforma Java Concluído mostrando diretórios JavaFX 2.1 válidos" class="margin-around" height="408" src="../../../images_www/articles/71/java/javafx-setup/platform-mgr-withfx.png" width="600"></p> |
| </li> |
| <li>Se você retornar ao assistente Nova Aplicação JavaFX ou abri-lo, será necessário selecionar a plataforma compatível com JavaFX que você criou. Selecione a plataforma compatível com JavaFX 2.1 que você criou na lista Plataformas JavaFX. Se você havia recebido uma advertência de que a plataforma Java que você selecionou não tinha suporte ao JavaFX, esse advertência desaparecerá.<br> <img alt="Assistente Nova Aplicação JavaFX com plataforma JavaFX criada manualmente selecionada" class="margin-around" height="496" src="../../../images_www/articles/72/java/javafx-setup/new-project-withfx.png" width="600"> |
| <p> Você pode clicar em Finalizar e criar um projeto ou clicar em Cancelar. A nova plataforma permanecerá mesmo se o assistente de Novo Projeto for cancelado.</p> |
| </li> |
| </ol> |
| </div> |
| <h2><a name="tutorials"></a>Tutorials</h2> |
| <p>Após configurar o NetBeans IDE para usar o JavaFX 2.1, tente executar os <a href="http://download.oracle.com/javafx/" target="_blank">tutoriais de JavaFX</a> como projetos NetBeans.</p> |
| <h2><a name="troubleshooting"></a>Solução de Problemas</h2> |
| <ul> |
| <li><strong>Recebi uma advertência de que meu Runtime de JavaFX está obsoleto.</strong> Você já instalou uma versão anterior do JavaFX 2? Talvez o instalador não tenha desinstalado a versão antiga do Runtime corretamente. <strong>Correção:</strong> desinstale manualmente uma versão mais antiga do JavaFX 2. Assegure-se de deletar quaisquer diretórios que permanecerem após a desinstalação.</li> |
| |
| <li><strong>Tenho outro problema que não foi descrito neste documento!</strong> Se você acha que está faltando algo neste documento, clique em Enviar Feedback no link Este Tutorial abaixo e informe aos escritores. Se você acha que encontrou um erro no suporte do NetBeans IDE para JavaFX 2, <a href="https://netbeans.org/community/issues.html">relate o erro</a>. Na página enter_bug.cgi, selecione o produto javafx.</li> |
| </ul> |
| <div class="feedback-box" ><a href="/about/contact_form.html?to=3&subject=Feedback:%20JavaFX%20Setup">Enviar Feedback neste Tutorial</a></div> |
| <br style="clear:both;" /> |
| |
| <p><a href="../../trails/matisse.html">Voltar à Trilha do Aprendizado</a></p> |
| </body> |
| </html> |
