DevelopmentEnvironment_pt

Esta página descreve com podemos instalar um ambiente de desenvolvimento para compilar/publicar AppFuse ou StrutsResume da linha de comando. Após instalar isto, pode ser que você queira checar Como rodar o Ant no Eclipse. Esta é a maneira que tenho atualmente instalado o AppFuse, quando o utilizo como uma linha base para desenvolvimento de aplicações web.

Tabela de Conteúdos

• [1] Download - links para baixar o JDK, J2EE, Tomcat, Ant e MySQL
• [2] Instação - instruções detalhadas de onde extrair/instalar todos os pacotes acima
• [3] Configuração - como configurar suas variáveis de ambiente
• [4] Dicas Adicionais - outras ferramentas que recomendo o uso

Download [#1]

1. Baixe a última versão da JDK (J2SE SDK) de http://java.sun.com. Já que é 07/12/2005, a versão é 1.4.2_08. O AppFuse funciona com o 1.5 se você quiser utilizá-lo. Aqui está minha experiência. Note que o Cactus foi removido do AppFuse na versão 1.6 e o Cargo (utilizado para testes JSPs) ainda não funciona com o Tomcat 5.5.x.
2. Baixe o último release do Tomcat do http://jakarta.apache.org/tomcat. Atualmente, enquanto escrevo este, é 5.0.28. NÃO baixe a versão LE ou você terá que adicionar os JARs para o DBCP (pool de conexão de banco de dados) e para o JavaMail (para e-mail) JARs.
3. Baixe o último release do Ant do

1. Baixe o último release do MySQL do http://www.mysql.com. Atualmente, é o 4.0.21.

Eu geralmente coloco todos estes downloads em uma pasta "Downloads" - na verdade, estou planejando empacotar um CD com todas estas bibliotecas nele - bom para se ter quando se está viajando para novos clientes e a rede é lenta.

Instalação [#2]

1. Crie as pastas "Tools" e "SDKs" em seu HD. No Windows, crio eles em c:\Tools e c:\SDKs. Em *nix, eu geralmente os crio em /opt/dev/tools e opt/dev/sdks.
2. Crie variáveis de ambiente para estas pastas - SDKS_HOME e TOOLS_HOME (opcional)
3. Instale o J2SE SDK (a.k.a. JDK) no diretório SDKs - mantendo os nomes dos diretórios intactos.
4. Instale o Tomcat no diretório Tools - Eu geralmente nomeio o diretório de instalação como "jakarta-tomcat-x" onde x é a versão corrente (i.e. 5.0.28).
5. Descompacte/Instale o Ant no diretório Tools - "apache-ant-x" é o que eu utilizo para o nome do diretório.
6. Instale o MySQL no diretório Tools. Eu geralmente o nomeio "mysql".
7. Crie um diretório "Source" em seu HD (aqui é onde colocaremos todo o nosso código para os nossos projetos). Em *nix, geralmente crio uma pasta "dev" em meu diretório home.

Neste ponto, você deve ter uma estrutura de diretório que parece com o seguinte:

SDKs -
    - j2sdk-1.4.2_05
Tools - 
    - apache-ant-1.6.2
    - jakarta-tomcat-5.0.28
    - mysql
Source

Agora vamos configurar todas estas ferramentas para que o nosso Sistema Operacional saiba que elas estão instaladas.

Configuração [#3]

Vou mostrar somente um exemplo assumindo que os caras de *nix são espertos o suficiente para fazer tudo funcionar em seu sistema operacional.

1. Para setar as variáveis de ambiente no Windows, ou você vai para o Painel de Controle -> Sistema ou clica com o botão direito no Meu Computador -> Propriedades, ou ainda aperte o botão Windows+Pause.
2. Clique na tab Avançado e então clique no botão Variáveis de Ambiente.
3. Coloque o foco na segunda caixa (Variáveis de Sistema) clicando em um dos valores existentes.
4. Entre com as seguintes variáveis:
   • HOME = c:\Source
   • SDKS_HOME = c:\SDKs
   • TOOLS_HOME = c:\Tools
   • JAVA_HOME = %SDKS_HOME%\j2sdk-1.4.2_05
   • ANT_HOME = %TOOLS_HOME%\apache-ant-1.6.2
   • CATALINA_HOME = %TOOLS_HOME%\jakarta-tomcat-5.0.28
   • MYSQL_HOME = %TOOLS_HOME%\mysql
   • Adicione à variável PATH: %JAVA_HOME%\bin;%ANT_HOME%\bin;%CATALINA_HOME%\bin;%MYSQL_HOME%\bin

Você agora já pode abrir a linha de comandos e digitar "java -version", "ant -version" ou "mysql" e não ter nenhum erro.

Dicas Adicionais [#4]

• Eu utilizo Cygwin no Windows para rodar o Ant e fazer todas as coisas necessárias em linhas de comando. Eu o instalo em %TOOLS_HOME%\cygwin. No meu arquivo %HOME%\.profile, adiciono os seguintes itens, que podem ser úteis:

alias ls="ls -CF --color"
alias ll='ls -la'
alias tstart=$CATALINA_HOME/bin/startup.bat
alias tstop=$CATALINA_HOME/bin/shutdown.bat

• Eu uso Eclipse em Windows para edição de arquivos .java. Eu o instalo em %TOOLS_HOME%\eclipse. Eu ainda utilizo Ant para construção e publicação, mas as versões em CVS do AppFuse e StrutsResume ainda contém os arquivos .classpath e .project para o Eclipse. Adicionalmente, AppFuse possui arquivos de projetos para Intellij's IDEA (versão 4.5+). Para ver como se pode rodar o Ant no Eclipse, veja meu Como rodar o Ant no Eclipse.

Se você está começando a trabalhar com um novo cliente, ainda recomento para você fazer o seguinte para ajudar seu processo de desenvolvimento a se tornar mais eficiente. A maioria de meus clientes nos últimos anos não tiveram isto em nenhum lugar, por isso estou recomendando isso aqui.

1. Instale um sistema de controle de versão. Eu prefiro CVS porque já sou mais acostumado a ele. Um bom addon é CVS Spam para notificações de check-in formatadas em HTML.
2. Instale um sistema de rastreamento de bugs. Escolhas populares (free) são o Bugzilla e Scarab. O melhor que já vi é o JIRA (demo), mas ainda não convenci um cliente a pagar U$800 por ele.
3. Instale um Wiki. Meu favorito é o JSPWiki - o qual este site utiliza. Você pode também baixar este template se você gostar.
4. Instale uma development box para hospedar o sistema de controle de versões, o sistema de rastreamento de bugs e o wiki. Instale o Tomcat nesta box e Anthill para testes automatizados (rodo tanto o AppFuse quanto Struts-Resume no Anthill em casa).
5. (opcional) Instale Roller e o utilize para relatar o status diário e edições. Isto vai permitir a seu cliente (ou supervisor) acompanhar o seu progresso.