Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 67.1
edited by Lachlan Deck
on 2016/01/13 15:21
Change comment: There is no comment for this version
To version 62.1
edited by Ramsey Gurley
on 2015/04/30 21:14
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ldeck
1 +XWiki.ramsey
Content
... ... @@ -1,82 +1,34 @@
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"]])
1 +== Outline ==
3 3  
4 -**Steps 0-2** (as elaborated below)
5 -
6 -0. Install Java 8
7 -~1. Install Maven 3
8 -2. Update ~~/.m2/settings.xml to include the wocommunity repo
9 -
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 via Help > Install New Software.... (See [[http:~~/~~/www.eclipse.org/m2e/>>url:http://www.eclipse.org/m2e/||shape="rect"]])
14 -5. Install [[doc: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 -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 -
29 29  == Step 1: Installing Maven ==
30 30  
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.
5 +Downloading and installing the latest version of [[Maven>>url:http://maven.apache.org/download||shape="rect"]] is the first step to start using this tool.
32 32  
33 -(a) You can use MacPorts ([[https:~~/~~/www.macports.org>>url:https://www.macports.org||shape="rect"]]) to install:
7 +{{tip title="Mac Tip"}}
8 +install macports [[http:~~/~~/www.macports.org/install.php>>url:http://www.macports.org/install.php||shape="rect"]], then on the terminal:
34 34  
35 -{{code title="MacPorts usage" theme="Emacs" language="bash"}}
36 -$ sudo port install maven3
37 -{{/code}}
10 +{{noformat}}
11 +sudo port install maven3
38 38  
39 -(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]):
13 +{{/noformat}}
40 40  
41 -{{code title="Homebrew usage" theme="Emacs" language="bash"}}
42 -$ brew install maven
43 -{{/code}}
15 +In future, to keep this up to date:
44 44  
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:
17 +{{noformat}}
18 +sudo port upgrade maven3
46 46  
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}}
20 +{{/noformat}}
57 57  
58 -Then in your bash profile, ensure your path and java home are updated:
22 +Don't forget to install maven_select:
59 59  
60 -{{code title="~~/.bash_profile" theme="Emacs" linenumbers="true" language="text"}}
61 -...
62 -export PATH=/usr/local/apache-maven/bin:$PATH
63 -export JAVA_HOME=$(/usr/libexec/java_home)
64 -...
65 -{{/code}}
24 +{{noformat}}
25 +sudo port install maven_select
66 66  
67 -
27 +{{/noformat}}
28 +{{/tip}}
68 68  
69 -Whichever installation approach you've taken, you should now be able to do
30 +**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
70 70  
71 -$ mvn -version
72 -
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 -
80 80  == Step 2: Configuring your Maven Settings ==
81 81  
82 82  Advanced users can skip this step, but it's highly recommended.
... ... @@ -85,8 +85,6 @@
85 85  
86 86  **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.
87 87  
88 -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
89 -
90 90  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.
91 91  
92 92  == Step 3: Installing WebObjects Libraries ==