Importando projetos do Eclipse para o NetBeans IDE
Conteúdo
Para concluir este tutorial, você precisa dos seguintes recursos e softwares.
Assistente de importação de projetos do Eclipse
O NetBeans IDE 6.5 apresenta um Assistente de importação de projetos do Eclipse aprimorado. Esse assistente permite que você use o NetBeans para trabalhar com projetos de área de trabalho Java e de aplicações Web criados no Eclipse e MyEclipse.
Após criar um projeto NetBeans a partir de um projeto Eclipse, você pode trabalhar das seguintes maneiras:
- Usar o NetBeans em um projeto de equipe em que outros desenvolvedores usem o Eclipse.
- Alternar entre o NetBeans e o Eclipse em um projeto.
- Experimente o NetBeans em um projeto existente que tenha sido criado no Eclipse.
Como funciona o Assistente de importação
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.
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 trabalhand com o Eclipse. O caminho de construção que você define no Eclipse continua sendo o caminho de construção mestre do projeto.
Importando e configurando projetos
Para importar um projeto Eclipse no NetBeans:
- Certifique-se de que você tenha uma cópia do projeto que deseja importar para seu sistema.
Normalmente, esse projeto já estaria em um espaço de trabalho do Eclipse em seu sistema.
- Escolha Arquivo > Importar projeto > Projeto Eclipse.
- Na página Localização do espaço de trabalho do assistente, selecione o botão de opção Importar projetos para o espaço de trabalho e, em seguida, especifique a localização do espaço de trabalho.
- Na página Projetos a importar, selecione os projetos que você deseja importar. Em seguida, selecione uma das seguintes opções de armazenamento dos arquivos do projeto NetBeans:
- Armazenar dados do projeto NetBeans nas pastas do projeto Eclipse.O NetBeans adiciona pastas e arquivos na pasta de nível superior do projeto original.
- Criar projetos NetBeans importados em um local separado. O NetBeans usa os códigos-fonte e bibliotecas na pasta do projeto Eclipse original, mas cria uma pasta separada para armazenar os metadados do projeto NetBeans e criar saídas.
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, a extração 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.
Veja Arquivos do projeto NetBeans a seguir para obter uma relação dos arquivos e pastas criados pelo NetBeans.
- Na página Servidores, registre todos os servidores que seu projeto precisa com o IDE NetBeans. (Essa página não é exibida se você não estiver importando aplicativos Web.)
Depois de ter concluído o assistente, as caixas de diálogo a seguir devem ser exibidas:
- Problemas de importação. Esse diálogo oferece informações sobre as discrepâncias entre a estrutura do projeto no Eclipse e no NetBeans e destaca as ações que você pode ter que tomar para corrigir as discrepâncias.
Você pode copiar as informações obtidas desse diálogo e colá-las em outro lugar para consultar posteriormente.
Na maioria dos casos, você usa a caixa de diálogo Propriedades do projeto para resolver esses problemas. Veja Resolvendo problemas de importação para obter um guia para a solução dos problemas mais comuns.
- Resolver problemas de referência. Essa caixa de diálogo alerta você sobre um problema de referência específico com uma das bibliotecas de seu 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 projeot e escolhendo Resolver problemas de referências.
- Resolver servidor ausente. Essa caixa de diálogo alerta você de que o projeto não foi capaz de encontrar 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.
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.
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.
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.
Para obter mais informações sobre a configuração de seu projeto, veja Configurando o classpath e outras configurações do projeto no guia Criando, importando e configurando projetos Java.
Construindo e executando um projeto
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 build e dist. O NetBeans não sobrescreve a saída criada a partir de ações construir do Eclipse. Se o projeto Eclipse já tiver pastas build e dist, o projeto NetBeans cria pastas chamadas nbbuild e nbdist e as utiliza para as saídas do comando construir.
A seguir, alguns dos comandos construir e executar disponíveis no menu Executar:
- Executar projeto. Testa a execução do aplicativo no IDE.
- Limpar e construir projeto. Exclui o conteúdo das pastas
build (ou nbbuild) e dist (ou nbdist) e reconstrói todas as saídas do projeto. Usa o script de construção do NetBeans. Similar ao comando Limpar no Eclipse.
- Limpar. Exclui o conteúdo das pastas
nbbuild e nbdist.
- Construir. Reconstrói as saídas do projeto. Se o recurso Compilar ao salvar estiver habilitado, o comando Construir é desabilitado. Veja a seção Compilar ao salvar do guia Criando, importando e configurando projetos Java.
Para obter mais informações sobre a construção e execução de seu aplicativo, bem como sobre a personalização do processo de construção, veja Criando, importando e configurando projetos Java.
Arquivos do projeto NetBeans
Depois de ter importado o projeto, você encontrará a pasta e os arquivos a seguir em seu sistema:
- Arquivo
build.xml ou arquivo nb-build.xml. 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 padrão, esse arquivo é chamado de build.xml. Se esse arquivo já existir na pasta do projeto, o script é chamado de nb-build.xml.
- Pasta
nbproject. 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 build.xml ou nb-build.xml 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 private, que contém dados específicos de seu sistema. Essa pasta não deve ser copiada para o sistema de controle de versão, já que seu conteúdo irá variar entre os usuários. Veja Considerações sobre o controle de versão a seguir.
- Pasta
nbbuild. Quando você criar ou executar seu projeto no NetBeans, os códigos-fonte serão compilados nessa pasta.
- Pasta
nbdist. Quando você constrói seu projeto no NetBeans, as saídas distribuíveis do projeto são craidas e colocadas nessa pasta. Tais saídas podem ser arquivos JAR e arquivos WAR.
Considerações sobre o controle de versão
Se o projeto foi copiado de um sistema de controle de de versão, as pastas build (ou nbbuild), dist (ou nbdist) e nbproject/private não devem ser copiadas para esse sistema de controle de versão.
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.
Embora a pasta nbproject/private deva ser ignorada, a pasta nbproject deve ser copiada para o sistema de controle de versão. A pasta nbproject contém metadados do projeto que permitem que outros usuários abram o projeto no NetBeans sem ter que importar o projeto primeiro.
Sincronizando um projeto novamente
O importador do projeto tem recursos de sincronização. Se o classpath no Eclipse tiver sido alterado desde que foi importado inicialmente, você pode usar o recurso Sincronizar projetos do Eclipse novamente para atualizar o classpath no projeto NetBeans correspondente.
A ressincronização do projeto é unidirecional, de projetos Ecilpse 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 o recurso de ressincronização. Se você pretende manter tanto o projeto Eclipse quanto o NetBeans, use o projeto Eclipse como projeto "mestre".
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.
Para sincronizar novamente de modo manual os projetos NetBeans com projetos Eclipse:
- Escolha Arquivo > Importar projeto > Ressincronizar projetos Eclipse.
Observações: quando você ressincronizar um projeto, a ressincronização é realizada em todos os projetos que você importou do espaço de trabalho.
Resolvendo problemas de importação
Quando você importa um projeto no NetBeans, podem haver algumas coisas 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.
Eis uma lista de problemas de importação comuns e suas soluções.
| Resolver problema de servidor ausente |
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. |
| Resolver problema de referência |
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. |
| A plataforma Eclipse para o projeto ProjectName não pode ser usada. Ela é um JRE e o projeto NetBeans requer um JDK. O NetBeans usará a plataforma padrão.
|
Caso queira alterar a plataforma que o NetBeans usa para o projeto, escolha Ferramentas > Plataformas e especifique uma plataforma diferente. |
| O projeto Eclipse ProjecName afirma usar o JDK a partir do diretório "{1}". Mas esse diretório não existe. O NetBeans usará a plataforma padrão.
|
Caso queira alterar a plataforma que o NetBeans usa para o projeto, escolha Ferramentas > Plataformas e especifique uma plataforma diferente. |
| 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.
|
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 aba Códigos-fonte e, em seguida, clique no botão Inclusões/exclusões. |
| Falha na importação devido a .... Mais detalhes podem ser encontrados no arquivo de log do IDE. |
Você pode abrir o arquivo de registro do IDE escolhendo Visualizar > Registro do IDE. |
| Tipo de projeto desconhecido, ele não pode ser importado. |
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. |
Veja também