Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 66.1
edited by Ramsey Gurley
on 2015/05/01 21:00
Change comment: There is no comment for this version
To version 65.1
edited by Lachlan Deck
on 2016/01/13 15:15
Change comment: At 2016 Quickstart tip

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ramsey
1 +XWiki.ldeck
Content
... ... @@ -1,38 +1,82 @@
1 -== Outline ==
1 +{{tip title="2016 QuickStart"}}
2 +See ([[http:~~/~~/lists.apple.com/archives/webobjects-dev/2016/Jan/msg00045.html>>url:http://lists.apple.com/archives/webobjects-dev/2016/Jan/msg00045.html||shape="rect"]])
2 2  
3 -== Step 0: Install latest Java ==
4 +**Steps 0-2** (as elaborated below)
4 4  
5 -If you're on a Mac, it's using old and busted Java 6. Update that to Java 8.
6 +0. Install Java 8
7 +~1. Install Maven 3
8 +2. Update ~~/.m2/settings.xml to include the wocommunity repo
6 6  
10 +**Steps 3–6**
11 +
12 +3. Install Eclipse 4.5 for Committers ([[http:~~/~~/www.eclipse.org/downloads/>>url:http://www.eclipse.org/downloads/||shape="rect"]])
13 +4. Install m2e (Help > Install New Software...)
14 +5. Install WOLips
15 +6. Preferences > Maven > Archetypes, Add Remote Catalog
16 + [[http:~~/~~/maven.wocommunity.org/service/local/repositories/snapshots/content/archetype-catalog.xml>>url:http://maven.wocommunity.org/service/local/repositories/snapshots/content/archetype-catalog.xml||shape="rect"]]
17 +
18 +[[url:http://maven.wocommunity.org/service/local/repositories/snapshots/content/archetype-catalog.xml||shape="rect"]]Done. The WebObjects jars are in the wocommunity repo, so no need to do woinstaller.jar hassle.
19 +{{/tip}}
20 +
21 +----
22 +
23 +(% style="color: rgb(0,0,0);font-size: 24.0px;" %)Detailed Instructions...
24 +
25 +(% style="color: rgb(0,0,0);font-size: 20.0px;" %)Step 0: Install latest Java
26 +
27 +If you're on a Mac, it's using old and busted Java 6. Update that to Java 8 ([[http:~~/~~/www.oracle.com/technetwork/java/javase/downloads/index.html>>url:http://www.oracle.com/technetwork/java/javase/downloads/index.html||shape="rect"]]).
28 +
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:
31 +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
33 +(a) You can use MacPorts ([[https:~~/~~/www.macports.org>>url:https://www.macports.org||shape="rect"]]) to install:
34 +
35 +{{code title="MacPorts usage" theme="Emacs" language="bash"}}
36 +$ sudo port install maven3
20 20  {{/code}}
21 21  
22 -Then in your bash profile, make your path look something like:
39 +(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
41 +{{code title="Homebrew usage" theme="Emacs" language="bash"}}
42 +$ brew install maven
43 +{{/code}}
25 25  
26 -And tell maven where your non-mac Java home is located
45 +(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  
47 +{{code title="Manual install" theme="Emacs" language="bash"}}
48 +$ sudo su
49 +$ cd /usr/local/
50 +$ curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
51 +$ tar -xzf apache-maven-3.3.3-bin.tar.gz
52 +$ ln -s apache-maven-3.3.3 apache-maven
53 +$ exit
54 +$ cd ~/
55 +$ vi .bash_profile
56 +{{/code}}
57 +
58 +Then in your bash profile, ensure your path and java home are updated:
59 +
60 +{{code title="~~/.bash_profile" theme="Emacs" linenumbers="true" language="text"}}
61 +...
62 +export PATH=/usr/local/apache-maven/bin:$PATH
28 28  export JAVA_HOME=$(/usr/libexec/java_home)
64 +...
65 +{{/code}}
29 29  
30 -You should now be able to do
67 +
31 31  
32 -mvn -version
69 +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.
71 +$ mvn -version
35 35  
73 +**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.
74 +
75 +**NOTE 2**: You might also like to install bash completion utilities:
76 +
77 +* 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"]]).
78 +* 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"]]).
79 +
36 36  == Step 2: Configuring your Maven Settings ==
37 37  
38 38  Advanced users can skip this step, but it's highly recommended.