Compartilhando bibliotecas do projeto no NetBeans IDE 6.1
Conteúdo
Para seguir este tutorial, você precisa dos seguintes recursos e softwares.
Compartilhamento de projeto
Como o sistema do projeto NetBeans IDE é baseado em Ant, os projetos do NetBeans já são geralmente transferíveis entre usuários diferentes, independentemente de eles usarem o IDE ou não. Os metadados do projeto são armazenados em uma combinação de XML legível por humanos e arquivos de propriedade. Os projetos podem ser construídos fora do IDE meramente executando-se o script Ant.
Entretanto, uma inconveniência tem sido que a forma de referência do script de construção do projeto às bibliotecas depende de vários fatores específicos para cada usuário, particularmente no caso de bibliotecas definidas na caixa de diálogo Gerenciador de bibliotecas.
Portanto, por exemplo, se você tinha um projeto que dependia de uma biblioteca personalizada especificada na janela Bibliotecas e queria que outra pessoa examinasse o projeto, você poderia enviá-lo em um arquivo zip. Mas talvez eles tenham problema para construir o projeto devidos a referências não-resolvidas à biblioteca personalizada.
Outra inconveniência é que as bibliotecas são armazenadas em uma variedade de locais, com base em sua origem. As bibliotecas que vêm com o IDE são armazenadas em várias pastas diferentes na instalação do IDE. Os exemplos disso incluem as bibliotecas das extensões de layout do Swing, vinculação de beans e drivers de banco de dados.
No NetBeans IDE 6.1, o sistema do projeto foi aprimorado para oferecer mais opções para a manipulação de bibliotecas que o seu projeto precisa em seu classpath. Essa flexibilidade torna mais fácil para você manipular as seguintes situações:
- Você cria um projeto e precisa torná-lo disponibilizável e construível para outros usuários, independentemente de eles usarem o IDE ou não. Eles precisam ser capazes de acessar o projeto através de um checkout de controle de versão ou descompactando um arquivo zip que você forneceu para eles. Eles devem ser capazes de construir o aplicativo sem configuração extra.
- Você deve começar a trabalhar em um projeto existente e aderir a um conjunto estrito de convenções relacionadas a onde as bibliotecas do projeto são armazenadas (e se os seus scripts de construção os acessam com uma referência relativa ou referência absoluta). Outros usuários do time não estão usando o NetBeans IDE e não temos planos de troca.
O NetBeans IDE 6.1 permite que você resolva esses tipos de situações, definindo explicitamente uma localização para as bibliotecas das quais o seu projeto depende. Além disso, você decide entre usar um caminho relativo ou caminho absoluto ao se referir a essas bibliotecas. A partir daqui neste artigo, nos referiremos a esses recursos como tornar um projeto "compartilhável".
Configurando localização de biblioteca
Você pode configurar os projetos Java SE, Web e comercial para que sejam compartilháveis. Você pode tornar um projeto compartilhável ao criar o projeto (no assistente para Novo projeto) ou depois na aba Bibliotecas da caixa de diálogo Propriedades do projeto.
Para tornar as bibliotecas gerais do projeto Java compartilháveis durante a criação do projeto:
- Escolha Arquivo > Novo projeto.
- Na categoria Java do assistente, selecione um dos modelos padrão. Em seguida clique em Próximo.
- Na página Nome e localização do assistente, marque a caixa de verificação Usar pasta dedicada para armazenar bibliotecas.
- No campo Bibliotecas, selecione a localização das bibliotecas a serem compartilhadas.
Se as bibliotecas já estiverem incluídas no IDE, elas serão copiadas para a pasta que você designou.
Para tornar as bibliotecas do projeto Java EE ou da Web compartilháveis durante a criação do projeto:
- Escolha Arquivo > Novo projeto.
- Na categoria Web do assistente, selecione um dos modelos padrão. Em seguida clique em Próximo.
- Na página Nome e localização do assistente, marque a caixa de verificação Usar pasta dedicada para armazenar bibliotecas.
- No campo Bibliotecas, selecione a localização das bibliotecas a serem compartilhadas.
Se as bibliotecas já estiverem incluídas no IDE, elas serão copiadas para a pasta que você designou.
- (Opcional) Na página Servidor e configurações, selecione o botão de opção Copiar arquivos JAR do servidor para a pasta Bibliotecas.
Para tornar as bibliotecas de um projeto existente compartilháveis:
- Clique com o botão direito do mouse no nó do projeto e escolha Propriedades.
- Na caixa de diálogo Propriedades do projeto, selecione o nó Bibliotecas.
- No painel Bibliotecas, clique em Procurar para abrir o assistente para Nova pasta Bibliotecas.
- Na página Pasta Biblioteca do assistente, indique uma localização para as bibliotecas e clique em Próximo.
Você pode indicar a localização como uma referência relativa ou uma referência absoluta.
- No painel Ações do assistente, verifique a ação selecionada para cada biblioteca listada. Na maioria dos casos, o IDE detecta a ação mais apropriada para essa biblioteca.
As ações seguintes estão disponíveis:
- Copiar arquivos JAR da biblioteca para a nova pasta de bibliotecas. Use esta opção se a biblioteca não estiver na pasta que selecionou e você deseja colocar os arquivos JAR aí.
- Usar caminho relativo para arquivos JAR da biblioteca. Use essa opção se a biblioteca não estiver na pasta de bibliotecas e você precisa acessar a biblioteca em sua localização existente usando um caminho relativo. Uma entrada com uma referência relativa é adicionada para a biblioteca no arquivo nblibraries.properties da pasta de bibliotecas.
- Usar caminho absoluto para arquivos JAR da biblioteca. Use essa opção se a biblioteca não estiver na pasta de bibliotecas e você precisar acessar a biblioteca em sua localização existente usando um caminho absoluto. Uma entrada com uma referência absoluta é adicionada para a biblioteca no arquivo nblibraries.properties da pasta das bibliotecas.
- Usar biblioteca existente na pasta de bibliotecas. Use essa opção se já houver uma cópia da biblioteca na pasta de bibliotecas e você deseja usar essa cópia da biblioteca.
- Clique em Terminar para sair do assistente para Tornar projeto compartilhável.
- Clique em OK para sair da caixa de diálogo Propriedades do projeto.
Observações:
- Você também pode usar o nó Bibliotecas da caixa de diálogo Propriedades do projeto para alterar a localização da pasta Bibliotecas. Caso você já tenha especificado uma pasta Bibliotecas, clicar em Procurar abre um seletor de arquivos em vez do assistente para Nova pasta Biblioteca.
- As bibliotecas de projeto de forma livre não podem ser compartilhadas das formas descritas neste tópico.
- O assistente para Novo projeto não inclui a opção de bibliotecas compartilháveis para alguns modelos de projeto padrão, tal como o aplicativo de área de trabalho Java. Entretanto, você pode tornar tais projetos compartilháveis na caixa de diálogo Propriedades do projeto.
