Instalando jCompany

O jCompany Community é distribuído em suas releases através de uma arquivo compactado com todo o seu código fonte e documentação disponível. Dessa forma, será necessária a geração do jars dos projetos jCompany para que as aplicações criadas com o produtos rodem sem problemas. O primeiro passo é descompactar o arquivo jcompany-community.zip no diretório desejado, Ex: “C:\caminho\jcompany”.

O próximo passo é a importação dos projetos no Eclipse. Através da ferramenta de importação do Eclipse, é necessário importar todos os projetos a partir do diretório que foi descompactado o zip do jCompany Community. Alguns dos projetos virão inicialmente com problemas de compilação até que façamos o primeiro deploy e as dependências sejam baixadas pelo maven para que o classpath esteja completo e a aplicação não apresente mais erros.

Para facilitar o processo de build do jCompany, sugerimos também a configuração de variáveis no Eclipse.

No Eclipse, abra o menu “Window/ Preferences/ General/ Workspace/ Linked Resources” e adicione a entrada: JCOMPANY_POM= C:\caminho\jcompany\pom.xml Com isso o ambiente está completamente configurado para gerarmos os binários do jCompany Community. Clique sobre o arquivo “jcompany_utils/pom.xml”. Execute a tarefa “Run/ External Tools/ Open External Tool Dialog/ Program/ ‘Install jCompany’ ”. Assim, as tarefas maven serão executadas para a compilação, empacotamento e distribuição. Todas as dependências do jCompany Community serão baixadas dos diversos repositórios remotos do maven e serão colocadas no repositório local. Esse processo pode demorar alguns minutos para ser executado, visto que serão baixados aproximadamente 50 MB em artefatos open-source que são matéria prima do jCompany Community.

Após a finalização da tarefa de instalação, caso os projetos no workspace do Eclipse ainda estiverem com problemas de compilação, é recomendável que se selecione todos os projetos e se execute a tarefa de limpeza, no menu “Project /Clean”. Algumas vezes a tarefa de Clean não faz um Re-Build nos projetos, logo a tarefa deve ser feita algumas vezes até se conseguir êxito em solucionar os problemas de compilação de todos os projetos.

Para um melhor aproveitamento e aprendizado das tags JSF existentes no jCompany Community, existe um arquivo de snippets para ajudar na edição de JSP’s. Na view “Snippets”, clique com o botão direito do mouse e depois em “Customize” e faça a importação do arquivo que se encontra em “jcompany_utils/snippets/snippets.xml”.