1 Configuração do Ambiente
O manual descreve como configurar o ambiente exigido pelo MDArte e, em linhas gerais, como são instalados pacotes envolvidos.
Para cada tópico a seguir são descritos procedimentos específicos para ambientes Linux e Windows (com base no XP).
1.1 Java Development Kit (JDK)
A devida utilização do MDArte exige a instalação do pacote JDK, preferivelmente a versão Sun/Oracle 1.5 por algumas limitações na geração de Web Services.
Após realizar a instalação do pacote, a variável de ambiente JAVA_HOME deve apontar para o diretório do JDK instalado.
|
Linux Para tanto, abra o arquivo localizado em /home/usuario/.bashrc e acrescente a variável, como no exemplo a seguir.
Lembrando que para as alterações terem efeito, é preciso reabrir o terminal. |
Windows
|
2.1 JBoss
O JBoss consiste do servidor de aplicações utilizado para rodar os projetos web gerados. O MDArte suporta um conjunto de versões, contudo recomendamos o uso do jboss-4.0.5.GA, que consiste em uma versão 4 bem testada e corrigida.
Após realizar a instalação do pacote, a variável de ambiente JAVA_HOME deve apontar para o diretório do JDK instalado.
|
Linux Para tanto, abra o arquivo localizado em /home/usuario/.bashrc e acrescente a variável, como no exemplo a seguir.
Lembrando que para as alterações terem efeito, é preciso reabrir o terminal. |
Windows
|
3.1 Maven
O Maven é a principal ferramenta utilizada pelo MDArte. Ele é responsável pela automação e gerenciamento de projetos, incluindo suas dependências. O MDArte tem maior compatibilidade com o Maven-1.0.2, sendo que apenas o Maven 1.x deve utilizado, pois o Maven 2.x possui estruturação bem distinta.
Após realizar a instalação do pacote, a variável de ambiente MAVEN_HOME deve apontar para o diretório do JDK instalado.
|
Linux Para tanto, abra o arquivo localizado em /home/usuario/.bashrc e acrescente a variável, como no exemplo a seguir.
Lembrando que para as alterações terem efeito, é preciso reabrir o terminal. |
Windows
|
Parte do gerenciamento de dependências é feito a partir da definição de repositórios remotos que podem ser consultados caso a dependência não seja encontrada localmente. Assim, crie o arquivo que deve conter as configurações apropriadas.
- Linux
- Crie o arquivo em
/home/usuario/build.properties - Windows
- Crie o arquivo em
C:\Documents and Settings\usuario\build.properties
Altere-o como a seguir (leia mais).
| maven.repo.remote=http://146.164.34.92/repositorio/ |
O Maven também permite referênciar mais de um repositório. Para tanto, o valor de maven.repo.remote deve conter as URLs separadas por vírgulas. Caso seu computador esteja se conectando a internet através de um proxy, ele deve ser configurado no mesmo arquivo, conforme o exemplo a seguir (leia mais).
| maven.proxy.host=<PROXY_IP> maven.proxy.port=<PROXY_PORTA> maven.proxy.username=<PROXY_USUARIO> maven.proxy.password=<PROXY_SENHA> maven.proxy.ntlm.host=<NTLM_IP> maven.proxy.ntlm.domain=<NTLM_DOMINIO> |
2 Instalação do Plugin do MDArte
O Plugin do MDArte consiste do componente responsável por gerar a estrutura inicial de um projeto. Ele deve ser utilizado apenas para a criação de projetos do zero.
Tendo o ambiente configurado, o plugin deve ser instalado a partir da execução do comando maven, que faz o download (caso necessário) do pacote JAR e o deixa pronto para uso.
O comando exato depende da versão do plugin a ser utilizado, contudo pode ser exemplicado como:
| maven plugin:download -DgroupId=andromda -DartifactId=maven-andromdapp-plugin-coppetec -Dversion=3.1.1.3.4.16-RC2 |
A partir do exemplo é possível verificar que a versão 3.1.1.3.4.16-RC2 está sendo utilizada, contudo ela pode ser substituida por qualquer versão de interesse. Sempre que possível, utilize a última versão disponível.