UNIVERSIDADE FEDERAL DE MINAS GERAIS PROPEEs - Programa de Pós-Graduação em Engenharia de Estruturas INSANE - INteractive Structural ANalysis Environment ROTEIRO ILUSTRADO PARA INSTALAÇÃO DO SISTEMA COMPUTACIONAL INSANE Maio de 2013
Capítulo 1 Roteiro para Instalação do INSANE O INSANE SDK (Standard Development Kit) é o nome dado ao pacote de programas utilizados pela equipe de desenvolvimento do INSANE. Seus principais componentes são o IDE Eclipse, o Java SDK e o Maven. Neste roteiro, serão mostrados os detalhes das instalações e do uso destes programas. 1.1 Arquivos necessários para instalação O primeiro passo é baixar os arquivos necessários para instalação do INSANE SDK. A Tabela 1.1 apresenta as versões dos programas a serem utilizados e os links onde os mesmos são encontrados. Tabela 1.1: Programas para instalação do pacote INSANE SDK. Programa Versão (com link para download) Eclipse Juno Eclipse Classic 4.2.2 Java Platform (JDK) Java Platform (JDK) 7u21 Apache Maven Apache Maven 3.0.5 Ao realizar o download dos arquivos, se certifique da versão de seu sistema operacional e se a versão dos programas são as mais atualizadas. 1
2 1.2 Instalações dos programas Para instalação do pacote Java SE 7u6, basta extrair e executar o arquivo obtido no link correspondente da Tabela 1.1. Para a instalação do Maven 3.0.4 e do Eclipse Classic 4.2, basta extrai-los nas respectivas pastas desejadas. Dica: crie uma pasta chamada Java, Eclipse e outra chamada Maven dentro do diretório Arquivos de Programa (C:\Program Files) e extraia os arquivos obtidos em suas respectivas pastas. O único a ser executado é o pacote Java SE 7u6. É necessário agora configurar as variáveis de ambiente do sistema operacional. Para o sistema operacional Windows 7, acesse o Painel de Controle Sistema e Segurança Sistema Configuraç~oes avançadas do sistema e entre em Variáveis de Ambiente..., conforme Figura 1.1. Figura 1.1: Aba Propriedades do Sistema.
3 Na seção Variáveis do usuário..., crie uma nova variável denominada como JAVA_HOME, definindo seu valor com o caminho do diretório de instalação do Java SE 7u6, exemplo: C:\Program Files\Java\jdk1.7.0_05. Analogamente, crie a nova variável MAVEN_HOME com valor definido para o diretório de instalação do Maven, exemplo: C:\Program Files\Maven. Edite a variável Path, acrescentando os caminhos das pastas de instalação do Java SE 7u6 e do Maven seguidos de \bin, como os exemplos: C:\Program Files\Java\jdk1.7.0_05\bin e C:\Program Files\Maven\bin (Figura 1.2). Dica: verifique se estes caminhos existem, confirmando-os pela busca de seus diretórios. Figura 1.2: Aba para criação de Nova variável de sistema.
4 Reinicie o computador para que as novas configurações tenham efeito. Caso seu sistema operacional seja o Linux, não é necessário reiniciar o computador. Basta editar o arquivo /etc/profile (é necessário acesso de superusuário para isso) adicionando as seguintes linhas (os caminhos de instalação podem variar): JAVA_HOME=/usr/java/jdk1.7.0_05 ECLIPSE_HOME=/usr/local/eclipse MAVEN_HOME=/usr/local/maven-3.0.4 export JAVA_HOME ECLIPSE_HOME MAVEN_HOME PATH=$PATH:$JAVA_HOME/bin:$ECLIPSE_HOME:$MAVEN_HOME/bin export PATH Para verificar se tudo está corretamente configurado, digite no Prompt de Comando: mvn -version. Deve aparecer algo similar ao mostrado na Figura 1.3. Figura 1.3: Testando a configuração do Path e a instalação do Maven. 1.2.1 Instalação de plug-in no Eclipse Utilizaremos a distribuição Subversive para o Eclipse, que consiste da instalação de 2 partes: plug-in Subversive e Subversive SVN Connectors. Estes devem ser instalados através do próprio Eclipse, pelo processo a seguir: abra o Eclipse, acesse Help Install New Software. Para a instalação do plug-in Subversive, no primeiro campo (Work with) entre com o site: http://download.eclipse.org/releases/juno/201206270900.
5 Assim como na Figura 1.4, expanda o nó Collaboration, selecione a opção Subversive SVN Team Provider e pressione Next. Figura 1.4: Instalação do Subversive SVN Team Provider no Eclipse. Na janela seguinte, pressione Next novamente, aceite os termos de licença e clique em Finish. O Eclipse irá instalar o plug-in Subversive SVN Team Provider e irá solicitar para ser reiniciado. Ao reiniciá-lo, o Eclipse automaticamente solicitará a instalação do plug-in Subversive SVN Connectors. Selecione a opção SVN Kit 1.3.7 conforme ilustrado na Figura 1.5.
6 Figura 1.5: Instalação do Subversive SVN Connectors - SVN Kit 1.3.7 no Eclipse. Pressione Finish e na janela seguinte, com todos os pacotes selecionados, clique em Next duas vezes, aceite os termos de licença e clique em Finish. Caso apareça a janela para validação do pacote, clique em OK para continuar com a instalação e aceite a reinicialização do Eclipse. 1.3 Criando os ambientes de trabalho e fazendo checkout do INSANE Para trabalharmos com o Eclipse, utilizamos dois ambientes de trabalho (workspaces): um para comunicação com o servidor Subversion e outro para trabalho local. Ao iniciar o Eclipse, ele pedira o diretório a ser utilizado naquela seção. Crie um diretório chamado dev para ser utilizado com o Subversion e outro com o nome de sua preferência (aqui denominado apenas workspace) em qualquer local de seu disco rígido (dê preferência para um diretório de fácil acesso). Inicie o Eclipse entrando com o diretório dev. Acesse File New Project. Na janela que aparecerá, conforme ilustrado na Figura 1.6, selecione Project from SVN e prossiga.
7 Figura 1.6: Criando um novo projeto a partir do SVN Repository. Na tela seguinte, digite o endereço https://www.insane.dees.ufmg.br/svn e clique em Next, conforme ilustrado na Figura 1.7. Dica: caso não sejam carregados os arquivos do INSANE, digite o endereço acima sem o www. Figura 1.7: Realizando o checkout do projeto com o SVN Repository. Aguarde a validação do repositório e pressione Finish. Na janela seguinte, selecione a opção Check out as a project with the name specified (Figura 1.8) e clique em Finish para finalizar o download do sistema INSANE diretamente do
8 repositório SVN armazenado no servidor do Projeto INSANE. Este processo poderá demorar alguns minutos, conforme a velocidade de conexão com a internet. Figura 1.8: Realizando o checkout a partir do projeto especificado: SVN. Abra o Prompt de Comando, indo para a pasta trunk, conforme o exemplo ilustrado na Figura 1.9. Repare que o diretório trunk fica dentro da pasta dev, podendo ter outras pastas intermediárias. Em seguida, para compilar todos os projetos do INSANE, digite o comando: mvn install. Figura 1.9: Compilando os projetos do INSANE pelo Prompt de Comando. Após digitar o comando acima, será realizado o download de vários recursos na internet e ao término da compilação, aparecerá a expressão: BUILD SUCCESS. Dica: em caso de falhas, limpe a compilação com o comando: mvn clean e em seguida digite novamente mvn install, até conseguir a expressão acima.
9 Em seguida, digite no Prompt de Comando: mvn eclipse:eclipse para que os projetos sejam criados no Eclipse. Este comando também deve resultar na expressão: BUILD SUCCESS. 1.4 Instalação do Checkstyle O Checkstyle é um plug-in que deve ser instalado para que o estilo de programação do INSANE seja carregado. Tendo ele instalado no Eclipse, este avisará ao usuário em tempo de implementação, os erros de sintaxe cometidos. Inicialize o Eclipse a partir do diretório workspace. Clique em Help e em seguida em Install New Software. Clique em Add e preencha os campos abaixo: Name: checkstyle e Location: http://eclipse-cs.sf.net/update/. Uma vez carregados os arquivos, expanda o nó Checkstyle e marque apenas a opção Eclipse Checkstyle Plug-in (Figura 1.10). Prossiga até aparecer o termo de licença e aceite a opção de reiniciar o Eclipse, caso ela apareça. Figura 1.10: Instalação do Checkstyle.
10 1.5 Concluindo a configuração do Eclipse Abra o programa Eclipse no diretório workspace e clique em File Import. Expanda o nó General, selecione a opção Existing Projects into Workspace e clique em Next. Na próxima tela, no campo Select root directory, clique em Browse e busque pela pasta trunk, selecione-a e clique em OK (Figura 1.11). Figura 1.11: Importando os projetos do diretório dev. Na próxima janela, serão listados vários projetos, desmarque a opção xdocs, como mostrado na Figura 1.12 e, em seguida, selecione Finish.
11 Figura 1.12: Conclusão da importação dos projetos do diretório dev. Neste momento, será iniciado o Refresh, processo observado na parte inferior direita do Eclipse. Aguarde até que ele termine. Em seguida, selecione o primeiro projeto (analysismodel), clique com o botão direito do mouse e selecione a opção Properties. Na próxima tela, selecione Java Build Path (coluna à esquerda) e a aba Libraries. Em seguida, clique em Add Variable e, na janela seguinte, clique em Configure Variables, conforme ilustrado na Figura 1.13.
12 Figura 1.13: Adicionando uma nova variável para o Java Build Path. Na janela Preferences (Filtered), clique em New (à direita), que abrirá a pequena tela New Variable Entry, assim como na Figura 1.14. Figura 1.14: Adicionando a nova variável M2-REPO. Preencha os campos como mostrado na Figura 1.14 e prossiga clicando em OK até a janela de atualização dos projetos do INSANE. Atenção: o Path mostrado nesta figura pode ser diferente, porém semelhante ao caminho mostrado e terminar em.../.m2/repository, ou seja, procure pela
13 pasta.m2 (caso esteja oculta, pedir para mostrar os diretórios ocultos) e dentro dela, procure por repository. 1.6 Ativando o Checkstyle Para ativar o Checkstyle, clique em Window Preferences, selecione Checkstyle (coluna à esquerda), de acordo com a Figura 1.15. Figura 1.15: Ativando o Checkstyle. Na sequência, clique em New. Na janela seguinte, escolha no campo Type a opção External Configuration File. O campo Location será preenchido através do Browse ao lado dele. Preencha os campos abaixo como na Figura 1.16 e dê OK nas janelas seguintes. Atenção: o caminho deve ser semelhante ao mostrado abaixo e igual a partir da pasta dev.
14 Figura 1.16: Criando um novo Check Configuration. Ainda na janela Window Preferences, selecione Checkstyle e a primeira linha que aparece na lista, ou seja, InsaneChecks, como mostrado na Figura 1.17. Em seguida, clique em Set as Default e dê OK nesta janela. Figura 1.17: Configurando o InsaneChecks como Default. Na sequência, selecione todos os projetos e com o botão direito do mouse selecione Checkstyle Activate Checkstyle. Analogamente, clique em Checkstyle Check Code with Checkstyle (Figura 1.18). Verifique ainda se os projetos continuam conectados ao svn, observado pelos links do site do INSANE ao lado dos
15 projetos. Caso ainda estejam, selecione todos os projetos, clique com o botão direito do mouse e clique em Team Disconnect, aceite a confirmação para desconectar do servidor svn e aguarde a atualização dos projetos. Figura 1.18: Ativando e avaliando o código a partir do Checkstyle. 1.7 Configurando a biblioteca nativa para o JOGL O OpenGL (Open Graphics Library) é uma biblioteca de funções e estruturas de dados com uma interface portável de alto nível para acesso ao hardware gráfico. Essa interface consiste basicamente de 120 funções que podem ser utilizadas para especificar objetos e operações necessárias para produzir aplicações 3D interativas. Um dos principais atrativos do OpenGL é a sua facilidade de utilização e portabilidade. A seguir, são apresentados os passos para sua configuração no INSANE. Acesse o projeto ui.rich.full e, com o botão direito do mouse, selecione Properties. Uma vez aberta a janela Properties for ui.rich.full, selecione Java build path Source. Nesta aba, selecione Native library location dentro do pacote ui.rich.full/src/main/java e clique em Edit (Figura 1.19).
16 Figura 1.19: Configurando o OpenGL. Na próxima janela, clique em Workspace... e selecione o pacote resources localizado no projeto ui.rich.full. Siga o caminho: br ufmg dees insane ui rich full e escolha a versão do jogl que é compatível com o seu sistema operacional (Figura 1.20) e dê OK na sequência. Figura 1.20: Configurando o OpenGL. Pronto! Após estas configurações o sistema INSANE já pode ser executado.
17 1.8 Executando o INSANE Para executar o sistema computacional INSANE, selecione a classe Insane.Java dentro do pacote br.ufmg.dees.insane.ui.rich.full do projeto ui.rich.full, clique com o botão direito do mouse e selecione Run As Java Application, conforme ilustrado na Figura 1.21. Figura 1.21: Como executar o sistema INSANE. Neste momento, a interface gráfica do INSANE será exibida e o sistema já poderá ser utilizado em sua versão mais atualizada.
18 Figura 1.22: Interface do sistema computacional INSANE. Bom Trabalho! Desenvolvedores do Sistema Computacional INSANE.