Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 63.1
edited by Ramsey Gurley
on 2015/05/01 13:23
Change comment: There is no comment for this version
To version 64.1
edited by Lachlan Deck
on 2016/01/13 14:41
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ramsey
1 +XWiki.ldeck
Content
... ... @@ -6,33 +6,55 @@
6 6  
7 7  == Step 1: Installing Maven ==
8 8  
9 -Downloading and installing the latest version of [[Maven>>url:https://maven.apache.org/download.cgi||shape="rect"]] is the first step to start using this tool. Download the binary tarball, copy it to /usr/local/, unpack it, soft link it and add the path to your bash_profile:
9 +Downloading and installing the latest version of [[Maven>>url:https://maven.apache.org/download.cgi||shape="rect"]] is the first step to start using this tool via one of the following approaches.
10 10  
11 -{{code title="shell"}}
12 -sudo su
13 -cd /usr/local/
14 -curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
15 -tar -xzf apache-maven-3.3.3-bin.tar.gz
16 -ln -s apache-maven-3.3.3 apache-maven
17 -exit
18 -cd ~/
19 -vi .bash_profile
11 +(a) You can use MacPorts ([[https:~~/~~/www.macports.org>>url:https://www.macports.org||shape="rect"]]) to install:
12 +
13 +{{code title="MacPorts usage" theme="Emacs" language="bash"}}
14 +$ sudo port install maven3
20 20  {{/code}}
21 21  
22 -Then in your bash profile, make your path look something like:
17 +(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]):
23 23  
24 -export PATH=/usr/local/apache-maven/bin:$PATH
19 +{{code title="Homebrew usage" theme="Emacs" language="bash"}}
20 +$ brew install maven
21 +{{/code}}
25 25  
26 -And tell maven where your non-mac Java home is located
23 +(c) Or manually by downloading the binary tarball, copying it to /usr/local/, unpacking it, soft linking it and adding the path to your bash_profile:
27 27  
25 +{{code title="Manual install" theme="Emacs" language="bash"}}
26 +$ sudo su
27 +$ cd /usr/local/
28 +$ curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
29 +$ tar -xzf apache-maven-3.3.3-bin.tar.gz
30 +$ ln -s apache-maven-3.3.3 apache-maven
31 +$ exit
32 +$ cd ~/
33 +$ vi .bash_profile
34 +{{/code}}
35 +
36 +Then in your bash profile, ensure your path and java home are updated:
37 +
38 +{{code title="~~/.bash_profile" theme="Emacs" linenumbers="true" language="text"}}
39 +...
40 +export PATH=/usr/local/apache-maven/bin:$PATH
28 28  export JAVA_HOME=$(/usr/libexec/java_home)
42 +...
43 +{{/code}}
29 29  
30 -You should now be able to do
45 +
31 31  
32 -mvn -version
47 +Whichever installation approach you've taken, you should now be able to do
33 33  
34 -**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
49 +$ mvn -version
35 35  
51 +**NOTE 1**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
52 +
53 +**NOTE 2**: You might also like to install bash completion utilities:
54 +
55 +* See this superuser answer for bash-completion installation: ([[http:~~/~~/superuser.com/questions/288438/bash-completion-for-commands-in-mac-os-x>>url:http://superuser.com/questions/288438/bash-completion-for-commands-in-mac-os-x||shape="rect"]]).
56 +* See also the following github repo for maven-bash-completion: ([[https:~~/~~/github.com/juven/maven-bash-completion>>url:https://github.com/juven/maven-bash-completion||shape="rect"]]).
57 +
36 36  == Step 2: Configuring your Maven Settings ==
37 37  
38 38  Advanced users can skip this step, but it's highly recommended.
... ... @@ -41,6 +41,8 @@
41 41  
42 42  **NOTE for those who know what to do**: You can download the complete and most recent settings.xml [[here>>attach:settings.xml]] and install it to ~~/.m2/settings.xml.
43 43  
66 +Download the [[archetype-catalog.xml>>url:http://maven.wocommunity.org/content/groups/public/archetype-catalog.xml||shape="rect"]] and copy it to ~~/.m2/archetype-catalog.xml
67 +
44 44  See [[Maven Settings Reference>>url:http://maven.apache.org/settings.html||shape="rect"]] if you want more information about additional options for the settings.xml file.
45 45  
46 46  == Step 3: Installing WebObjects Libraries ==