Introducere în Apache Maven 2, Partea 2 - Instalarea Maven

În acest articol se va descrie cum de instalat Apache Maven pe computer-ul dvs. Mai jos sînt enumerate instrucţiunile care trebuiesc urmate:

1. Verificaţi instalarea Java - Încredinţaţi-vă că aveţi instalată cel puţin Java 5. Atît Java 5 cît şi Java 6 se potrivesc, dar cel mai bine e să aveţi ultima versiune disponibilă. Pentru a verifica ce versiune de Java aveţi instalată puteţi rula următoarea comandă:

   C:\>java -version
   java version "1.5.0_18"
   Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_18-b02)
   Java HotSpot(TM) Client VM (build 1.5.0_18-b02, mixed mode, sharing)

2. Descărcaţi Maven - Puteţi descărca Maven de pe pagina oficiala a proiectului Apache Maven http://maven.apache.org/download.html. Aveţi grijă să alegeţi ultima versiune disponibilă.
3. Instalaţi Maven - După ce l-aţi descărcat, alegeţi o locaţie şi despachetaţi fişierul arhivat descărcat. Apoi veţi avea nevoie să definiţi 2 variabile de sistem: PATH şi M2_HOME. Dacă lucraţi pe Windows, o puteţi face cu următoarele comenzi:

   set M2_HOME=c:\apache-maven-2.1.0
   set PATH=%PATH%;%M2_HOME%\bin

   Rularea acestor comenzi în linia de comandă vă va permite să rulaţi Maven doar în sesiunea curentă, pentru a evita setarea lor de fiecare dată, le puteţi seta în Control Panel ca Environment Variables.
   
   Dacă lucraţi pe un sistem de operare din familia Unix, atunci puteţi folosi următoarele comenzi:

   export M2_HOME=/usr/local/apache-maven-2.1.0
   export PATH=${M2_HOME}/bin:${PATH}

4. Testaţi instalarea - După ce aţi instalat Maven, îl puteţi testa rulînd mvn -version din linia de comandă pentru a vedea versiunea acestuia. Dacă instalarea a fost OK, atunci va trebui să vedeţi ceva de genul acesta:

   C:\>mvn -version
   Apache Maven 2.1.0 (r755702; 2009-03-18 21:10:27+0200)
   Java version: 1.5.0_18
   Java home: C:\Program Files\Java\jdk1.5.0_18\jre
   Default locale: ro_RO, platform encoding: Cp1250
   OS name: "windows xp" version: "5.1" arch: "x86" Family: "windows"

   Dacă nu puteţi vizualiza acest mesaj sau sistemul de operare nu poate găsi comanda mvn atunci ar trebui să verificaţi încă o dată dacă variabilele PATH şi M2_HOME sînt setate corect. [Click mai jos pentru a citi articolul în întregime]
5. Setarea de Proxy - Dacă aveţi acces direct la internet puteţi omite acest pas. Doar cei care folosesc un proxy pentru ieşirea în internet au nevoie să urmeze instrucţiunile de mai jos. Deoarece Maven are nevoie de Internet atunci cînd lucrează în modul cel mai optim, este nevoie de a-l configura pentru a şti ce proxy aveţi dvs. Pentru aceasta creaţi (sau dacă există deja modificaţi) fişierul <user_home>/.m2/settings.xml cu următorul conţinut:

   <settings xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
             http://maven.apache.org/xsd/settings-1.0.0.xsd">
     <proxies>
       <proxy>
         <id>myproxy</id>
         <active>true</active>
         <protocol>http</protocol>
         <host>proxy.somewhere.com</host>
         <port>8080</port>
         <username>proxyuser</username>
         <password>somepassword</password>
       </proxy>
     </proxies>
   </settings>
   

   Fişierul <user_home>/.m2/settings.xml conţine setările specifice utilizatorului respectiv pentru autentificare, repositorii (repositories) şi alte lucruri care pot modifica comportamentul Maven.
   
   Notă: Vom utiliză syntaxa <user_home> pentru a ne referi la directorul de pornire al utilizatorului. În sistemele de operare din familia Unix, directorul de pornire a utilizatorului este /home/USERNAME sau ~. În Windows XP directorul de pornire al utilizatorului este C:\Documents and Settings\USERNAME. De acum înainte dvs. trebuie să interpretaţi locaţiile de genul <user_home>/.m2/settings.xml în dependenţă de sistemul dvs. de operare.
6. Ştergerea (uninstall) Maven - Dacă doriţi să ştergeţi Maven de pe computer-ul dvs, atunci va trebui să ştergeţi directorul unde a-ţi instalat Maven şi să eliminaţi variabilele de sistem. De asemenea va fi nevoie să ştergeţi şi directorul <user_home>/.m2 care reprezintă repositorul local Maven.
   
   Aici încheiem acest articol. În următorul post vom descrie Project Object Model (POM).