| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <!-- Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. --> |
| <!-- Use is subject to license terms.--> |
| <head> |
| <title>Importando Projetos do Eclipse para o NetBeans IDE - Tutorial</title> |
| <meta name="KEYWORDS" content="NETBEANS, TUTORIAL, GUIDE, USER, DOCUMENTATION"> |
| <meta name="description" |
| content="Overview of Eclipse Import features in NetBeans IDE"> |
| <link rel="stylesheet" href="../../../netbeans.css"> |
| |
| <meta HTTP-EQUIV="Content-Type" Content="text/html; charset=UTF-8"></head> |
| <body> |
| <a name="top"></a> |
| <h1>Importando Projetos do Eclipse para o NetBeans IDE</h1> |
| |
| <p><b>Conteúdo</b></p> |
| <img alt="Conteúdo nesta página se aplica ao NetBeans IDE 6.9, 7.0, 7.1, 7.2, 7.3 e 7.4" class="stamp" src="../../../images_www/articles/72/netbeans-stamp-74-73-72.png" title="O conteúdo desta página aplica-se ao NetBeans IDE 6.9, 7.0, 7.1, 7.2, 7.3 e 7.4"> |
| <ul class="toc"> |
| <li><a href="#intro" title="O Assistente de Importação de Projetos do Eclipse">O Assistente de Importação de Projetos do Eclipse</a></li> |
| <li><a href="#how-it-works" title="Como Funciona o Assistente de Importação">Como Funciona o Assistente de Importação</a></li> |
| <li><a href="#import" title="Importando e Configurando Projetos">Importando e Configurando Projetos</a></li> |
| <li><a href="#build" title="Construindo e Executando um Projeto">Construindo e Executando um Projeto</a></li> |
| <li><a href="#metadata" title="Arquivos do Projeto NetBeans">Arquivos do Projeto NetBeans</a></li> |
| <li><a href="#versioning" title="Considerações sobre o Controle de Versão">Considerações sobre o Controle de Versão</a></li> |
| <li><a href="#resynch" title="Ressincronizando um Projeto">Ressincronizando um Projeto</a></li> |
| <li><a href="#problems" title="Resolvendo Problemas de Importação">Resolvendo Problemas de Importação</a></li> |
| <li><a href="#nextsteps" title="Consulte Também">Consulte Também</a></li> |
| </ul> |
| <p><b>Para concluir este tutorial, você precisa dos 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">NetBeans IDE</a></td> |
| <td class="tbltd1">versão 6.9, 7.0, 7.1, 7.2, 7.3 ou 7.4 </td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">JDK (Java Development Kit)</a></td> |
| <td class="tbltd1">versão 6 ou 7</td> |
| </tr> |
| </tbody> |
| </table> |
| <a name="intro"></a><h2>O Assistente de Importação de Projetos do Eclipse</h2> |
| <p>Um suporte aprimorado para a importação de projetos do Eclipse está disponível no NetBeans IDE. O assistente Importar Projeto do Eclipse permite que você use o NetBeans para trabalhar com projetos de área de trabalho Java e de aplicações web criadas no Eclipse e MyEclipse.</p> |
| |
| <p>Após criar um projeto NetBeans de um projeto Eclipse, você pode trabalhar das seguintes maneiras:</p> |
| <ul> |
| <li>Usar o NetBeans em um projeto de equipe em que outros desenvolvedores usem o Eclipse. |
| </li> |
| <li>Use o intercâmbio entre o NetBeans e o Eclipse em um projeto. |
| </li> |
| <li>Experimente o NetBeans em um projeto existente que tenha sido criado no Eclipse. </li> |
| </ul> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="how-it-works"></a><h2>Como Funciona o Assistente de Importação</h2> |
| <p>Quando você importa um projeto, o IDE analisa os metadados do projeto Eclipse e cria um projeto NetBeans com base nesses metadados. A importação do projeto não impõe alterações na estrutura do projeto Eclipse, portanto isso não interfere no modo em que o projeto funciona no Eclipse.</p> |
| <p>Depois de ter importado o projeto, você pode usar um dos IDEs do NetBeans e Eclipse, ou ambos, para editar, construir, executar, depurar e criar o perfil do projeto. Se você fizer uma alteração de configuração no projeto Eclipse, você pode sincronizar o projeto NetBeans novamente. Isso permite que você trabalhe em projetos no NetBeans mesmo se todos em sua equipe estiverem trabalhando com o Eclipse. O caminho de construção que você define no Eclipse continua sendo o caminho de construção mestre do projeto.</p> |
| <p class="align-center"><a href="#top">início</a></p> |
| <h2><a name="import"></a>Importando e Configurando Projetos</h2> |
| |
| <p><b>Para importar um projeto Eclipse para o IDE:</b></p> |
| <ol> |
| <li>Certifique-se de que você tenha uma cópia do projeto que deseja importar para seu sistema. |
| <p>Normalmente, esse projeto já estaria em um espaço de trabalho do Eclipse em seu sistema.</p></li> |
| <li>Escolha Arquivo > Importar Projeto > Projeto Eclipse.</li> |
| <li>Na página Localização do Espaço de Trabalho do assistente, selecione o botão de opção Projetos de Importação do Espaço de Trabalho e, em seguida, especifique a localização do espaço de trabalho. Clique em Próximo. |
| |
| <p class="align-center"><a href="../../../images_www/articles/71/java/import-eclipse/eclipse-import-workspace-location.png" rel="lytebox" title="A página Localização do Espaço de Trabalho do assistente de Importação do Projeto Eclipse - Clique para ampliar"> <img alt="A página Localização do Espaço de Trabalho do assistente de Importação do Projeto Eclipse " border="1" src="../../../images_www/articles/71/java/import-eclipse/eclipse-import-workspace-location-small.png"></a></p></li> |
| |
| <li>Na página Projetos a Importar, selecione os projetos que você deseja importar.</li> |
| <li> Escolha uma das duas opções a seguir para armazenar os arquivos do projeto NetBeans: |
| <ul> |
| <li><b>Armazenar dados do projeto NetBeans nas pastas do projeto Eclipse.</b> O Netbeans adiciona pastas e arquivos dentro da pasta de nível superior do projeto original.</li> |
| <li><b>Criar projetos NetBeans importados em um local separado.</b> O Netbeans usa os códigos-fonte e as bibliotecas na pasta do projeto Eclipse original, mas cria uma pasta separada para armazenar metadados do projeto NetBeans e construir saídas.</li> |
| </ul> |
| <p class="notes"><b>Observação:</b> normalmente, é melhor armazenar os dados do projeto NetBeans dentro das pastas do projeto Eclipse. Na maioria dos casos, isso significa que os metadados do projeto NetBeans irão se referir a códigos-fonte e bibliotecas com os mesmos caminhos que são usados pelos metadados do Eclipse. Portanto, efetuar check-out do projeto de um sistema de controle de versões em máquinas diferentes deve resultar em comportamento similar, tanto no NetBeans quanto no Eclipse.<br>Consulte <a href="#metadata">Arquivos do Projeto NetBeans</a> a seguir para obter uma relação dos arquivos e pastas criados pelo NetBeans IDE.</p> |
| </li> |
| <li>(Aplicável só quando as aplicações web estiverem sendo importadas). Clique em Próximo. Na página Servidores, registre todos os servidores que seu projeto precisa com o NetBeans IDE.</li> |
| <li>Clique em Finalizar.</li> |
| </ol> |
| |
| <p>Depois de ter concluído o assistente, as caixas de diálogo a seguir devem ser exibidas:</p> |
| <ul> |
| <li><b>Problemas de Importação.</b> Esta caixa de diálogo fornece informações sobre discrepâncias entre a estrutura do projeto no Eclipse e no Netbeans e aponte ações que você pode precisar levar para corrigir as discrepâncias. <br>Você pode copiar as informações obtidas dessa caixa de diálogo e colá-las em outro lugar para consultar posteriormente. <br>Na maioria dos casos, você usa a caixa de diálogo Propriedades do Projeto para resolver esses problemas. Veja <a href="#problems">Resolvendo Problemas de Importação</a> para obter um guia para a solução dos problemas mais comuns. |
| <p class="align-center"><a href="../../../images_www/articles/71/java/import-eclipse/eclipse-import-issues.png" rel="lytebox" title="A caixa de diálogo Problemas de Importação - Clique para ampliar"> <img alt="A caixa de diálogo Problemas de Importação" border="1" src="../../../images_www/articles/71/java/import-eclipse/eclipse-import-issues-small.png"></a></p> |
| |
| </li> |
| <li><b>Resolver Problemas de Referência.</b> Essa caixa de diálogo o alerta para um problema de referência específico com uma das suas bibliotecas de projeto. Você pode solucionar esse problema depois de fechar a caixa de diálogo clicando com o botão direito do mouse no nó do projeto e escolhendo Resolver Problemas de Referências.</li> |
| <li><b>Resolver Servidor Ausente.</b> Essa caixa de diálogo o alerta que o projeto não pode localizar um servidor necessário. Você pode solucionar esse problema depois de fechar a caixa de diálogo clicando com o botão direito do mouse no nó do projeto e escolhendo Resolver Servidor Ausente.</li> |
| </ul> |
| <p>Depois de ter concluído o assistente e ter fechado algumas das caixas de diálogo informativas mostradas acima, os nós dos projetos serão exibidos na janela Projetos. |
| </p> |
| |
| <p class="align-center"><img alt="A janela Projetos após um projeto ser importado." class="margin-around" src="../../../images_www/articles/71/java/import-eclipse/eclipse-import-projects-window.png"></p> |
| |
| <p>Se houver referências nos metadados de seu projeto sobre servidores ou outros recursos que o NetBeans não consegue resolver, o nó do projeto será exibido em vermelho. Você pode resolver essas referências imediatamente clicando com o botão direito do mouse no nó do projeto e escolhendo Resolver Problemas de Referência e Resolver Servidor Ausente.</p> |
| |
| <p>Para outros tipos de ajustes na configuração do projeto, você usa a caixa de diálogo Propriedades do Projeto. Abra a caixa de diálogo Propriedades do Projeto clicando com o botão direito do mouse no nó do projeto e escolhendo Propriedades.</p> |
| <p>Para obter mais informações sobre a configuração do seu projeto, veja <a href="project-setup.html#projects-configuring">Configurando o Classpath e Outras Definições do Projeto</a> no guia Criando, Importando e Configurando Projetos Java.</p> |
| <p class="align-center"><a href="#top">início</a></p> |
| <h2><a name="build"></a>Construindo e Executando um Projeto</h2> |
| |
| <p>Depois de ter importado o projeto no NetBeans, você pode construir e executar o projeto. Todos os artefatos criados a partir dos comandos construir e executar do NetBeans são criados nas pastas <code>build</code> e <code>dist</code>. O NetBeans não substitui a saída criada a partir de ações de construção do Eclipse. Se o projeto Eclipse já tiver pastas <code>build</code> e <code>dist</code>, o projeto NetBeans cria pastas chamadas <code>nbbuild</code> e <code>nbdist</code> e as utiliza para as saídas do comando construir.</p> |
| <p>A seguir, alguns dos comandos construir e executar disponíveis no menu Executar:</p> |
| <ul> |
| <li><b>Executar o Projeto.</b> O teste executa a aplicação no IDE.</li> |
| <li><b>Limpar e Construir Projeto.</b> Deleta o conteúdo de <code>build</code> (ou <code>nbbuild</code>) e <code>dist</code> (ou <code>nbdist</code>) pastas e recria todas as saídas do projeto. Usa o script de construção do NetBeans. Similar ao comando Limpar no Eclipse.</li> |
| <li><b>Limpar.</b> Deleta o conteúdo das pastas <code>nbbuild</code> e <code>nbdist</code>.</li> |
| <li><b>Construir.</b> Recria as saídas do projeto. Se a funcionalidade Compilar ao Salvar for ativada, o comando Construir é desativado. Veja a seção <a href="project-setup.html#building-compile-on-save">Compilar ao Salvar</a> da guia Criar, Importar e Configurar Projetos Java.</li> |
| </ul> |
| |
| <p>Para obter mais informações sobre a construção e execução de sua aplicação, bem como sobre a personalização do processo de construção, consulte <a href="project-setup.html">Criando, Importando e Configurando Projetos Java</a>. |
| </p> |
| <p class="align-center"><a href="#top">início</a></p> |
| <h2><a name="metadata"></a>Arquivos do Projeto do NetBeans</h2> |
| |
| <p>Depois de ter importado o projeto, você encontrará a pasta e os arquivos a seguir em seu sistema:</p> |
| <ul> |
| <li>arquivo <code>build.xml</code> ou arquivo <code>nb-build.xml</code>. O script de construção principal do NetBeans para o projeto. Você pode personalizar esse script de acordo com as necessidades de seu projeto. Por default, esse arquivo é chamado de <code>build.xml</code>. Se esse arquivo já existir na pasta do projeto, o script é chamado de <code>nb-build.xml</code>.</li> |
| <li>pasta <code>nbproject</code>. Contém a maioria dos metadados do projeto NetBeans, incluindo recursos que são chamados pelo script de construção principal do NetBeans. Se você marcar essa pasta e o arquivo <code>build.xml</code> ou <code>nb-build.xml</code> em seu sistema de controle de versão, outros usuários poderão abrir o projeto no NetBeans. Essa pasta também contém a pasta <code>private</code>, que contém dados específicos de seu sistema. Essa pasta não deve ter check-in no sistema de controle de versão, pois seu conteúdo variará entre os usuários. Veja <a href="#versioning">Considerações sobre o Controle de Versão</a> a seguir.</li> |
| <li>pasta <code>nbbuild</code>. Quando você construir ou executar seu projeto no NetBeans, os códigos-fonte serão compilados nessa pasta.</li> |
| <li>pasta <code>nbdist</code>. Quando você constrói seu projeto no NetBeans, as saídas distribuíveis do projeto são criadas e colocadas nessa pasta. Tais saídas podem ser arquivos JAR e arquivos WAR.</li> |
| </ul> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="versioning"></a><h2>Considerações sobre o Controle de Versão</h2> |
| <p>Se o check-out do projeto tiver sido feito em um sistema de controle de versão, as pastas <code>build</code> (ou <code>nbbuild</code>), <code>dist</code> (ou <code>nbdist</code>) e <code>nbproject/private</code> não deverão ter check-in para esse sistema de controle de versão. </p> |
| <p>Se o projeto estiver sob os sistemas de controle de versão CVS, Subversion ou Mercurial, os arquivos "ignorar" apropriados são criados ou atualizados para esses diretórios quando o projeto é importado.</p> |
| <p class="notes">Embora a pasta <code>nbproject/private</code> deva ser ignorada, a pasta <code>nbproject</code> deve ter check-in no sistema de controle de versão. A pasta <code>nbproject</code> contém metadados do projeto que permitem que outros usuários abram o projeto no NetBeans sem ter que importar o projeto primeiro.</p> |
| <p class="align-center"><a href="#top">início</a></p> |
| |
| <h2><a name="resynch"></a>Ressincronizando um Projeto</h2> |
| |
| <p>O importador do projeto tem funcionalidades de sincronização. Se o classpath no Eclipse tiver sido alterado desde que foi importado inicialmente, você pode usar a funcionalidade Sincronizar Projetos do Eclipse novamente para atualizar o classpath no projeto NetBeans correspondente.</p> |
| <p>A ressincronização do projeto é unidirecional, de projetos Eclipse para projetos NetBeans. Se você fizer alterações na estrutura do projeto no NetBeans, essas alterações não serão propagadas para o projeto Eclipse com a funcionalidade de ressincronização. Se você pretende manter tanto o projeto Eclipse quanto o NetBeans, use o projeto Eclipse como projeto "mestre".</p> |
| <p>O IDe também ressincroniza os projetos automaticamente se as alterações na configuração do Eclipse forem inequívocas e não exigirem sua intervenção. Essa ressincronização automática ocorre logo depois que você abre o projeto. Se a ressincronização exigir sua intervenção, você precisa ressincronizar manualmente o projeto.</p> |
| |
| <!-- TODO add information on what gets synchronized--> |
| <p><b>Para sincronizar novamente de modo manual os projetos NetBeans com projetos Eclipse:</b></p> |
| <ul> |
| <li>Escolha Arquivo > Importar Projeto > Ressincronizar Projetos do Eclipse.</li> |
| </ul> |
| <p class="notes"><b>Observações:</b> quando você ressincronizar um projeto, a ressincronização é realizada em todos os projetos que você importou do espaço de trabalho.</p> |
| |
| <p class="align-center"><a href="#top">início</a></p> |
| <h2><a name="problems"></a>Resolvendo Problemas de Importação</h2> |
| |
| <p>Quando você importa um projeto no NetBeans, pode haver algumas questões que não são automaticamente resolvidas no NetBeans IDE. Para alguns desses problemas, um item do menu, como Resolver Problema de Servidor Ausente, é exibido no menu de contexto do projeto. Outros problemas podem ser resolvidos na caixa de diálogo Propriedades do projeto referente ao projeto importado no NetBeans IDE. |
| </p> |
| <p>Eis uma lista de problemas de importação comuns e suas soluções.</p> |
| |
| <table> |
| <tr> |
| <th class="tblheader" scope="col">Mensagem do Problema</th> |
| <th class="tblheader" scope="col">Solução</th> |
| </tr> |
| <tr> |
| <td class="tbltd1">Resolver Problema de Servidor Ausente</td> |
| <td class="tbltd1">Clique com o botão direito do mouse no nó do projeto e escolha Resolver Problema de Servidor Ausente. Em seguida, navegue até o arquivo ou pasta que contém o servidor.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Resolver Problema de Referência</td> |
| <td class="tbltd1">Clique com o botão direito do mouse no nó do projeto e escolha Resolver Problema de Referência. Em seguida, navegue até o arquivo ou pasta que contém o recurso que é mencionado no projeto.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">A plataforma Eclipse para o projeto <i>ProjectName</i> não pode ser usada. Ela é um JRE e o projeto NetBeans requer um JDK. O NetBeans usará a plataforma default. |
| </td> |
| <td class="tbltd1">Caso queira alterar a plataforma que o NetBeans usa para o projeto, escolha Ferramentas > Plataformas e especifique uma plataforma diferente.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">O projeto Eclipse <i>projectname</i> reivindica usar JDK do diretório "{1}". Mas esse diretório não existe. O NetBeans usará a plataforma default. |
| </td> |
| <td class="tbltd1">Caso queira alterar a plataforma que o NetBeans usa para o projeto, escolha Ferramentas > Plataformas e especifique uma plataforma diferente.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">O NetBeans não oferece suporte a inclusões/exclusões de código-fonte por raiz de código-fonte como o Eclipse. Elas foram mescladas e é recomendável que você as verifique no painel Código-fonte das propriedades do projeto. |
| </td> |
| <td class="tbltd1">No NetBeans, inclusões e exclusões são declaradas em um local para todo o projeto. Para verificar as inclusões e exclusões no projeto NetBeans, clique com o botão direito do mouse no nó do projeto e, na janela Projetos, escolha Propriedades. Na caixa de diálogo Propriedades do Projeto, selecione a guia Códigos-fonte e, em seguida, clique no botão Inclusões/Exclusões.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Falha na importação devido a <i>...</i>. Mais detalhes podem ser encontrados no arquivo de log do IDE.</td> |
| <td class="tbltd1">Você pode abrir o arquivo de log do IDE escolhendo Exibir > Log do IDE.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Tipo de projeto desconhecido, ele não pode ser importado.</td> |
| <td class="tbltd1">Você pode importar apenas os seguintes tipos de projeto Eclipse: Projeto Java, Projeto Java de um arquivo Ant existente, Web Estática, Web Dinâmica e Projeto JPA.</td> |
| </tr> |
| </table> |
| <!-- TODO link to a wiki with other troubleshooting info--> |
| |
| <!-- ======================================================================================= --> |
| <p class="align-center"><a href="#top">início</a></p> |
| <div class="feedback-box" ><a href="/about/contact_form.html?to=3&subject=Feedback:%20Importing%20Eclipse%20Projects%20into%20NetBeans%20IDE">Enviar Feedback neste Tutorial</a></div> |
| <br style="clear:both;" > |
| <h2><a name="nextsteps"></a>Consulte Também</h2> |
| <ul> |
| <li><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb7400&id=NBDAG445">Importando um Projeto Eclipse ou JBuilder</a> em <i>Desenvolvendo Aplicações com o NetBeans IDE</i></li> |
| <li><a href="http://wiki.netbeans.org/NetBeansForEclipseUsers">NetBeans para Usuários do Eclipse</a></li> |
| <li><a href="project-setup.html">Criando, Importando e Configurando Projetos Java</a></li> |
| <li><a href="../../trails/java-se.html">Trilha de Aprendizado do Desenvolvimento Geral em Java</a></li> |
| <li><a href="../../trails/matisse.html">Trilha de Aprendizado das Aplicações de GUI do Java</a></li> |
| <li><a href="../../trails/java-ee.html">Trilha de Aprendizado do Java EE e Java Web</a></li> |
| </ul> |
| <p class="align-center"><a href="#top">início</a></p> |
| </body> |
| </html> |
