Changes for page Quick Start
Last modified by Paul Hoadley on 2025/01/30 02:09
From version 62.1
edited by Ramsey Gurley
on 2015/04/30 21:14
on 2015/04/30 21:14
Change comment:
There is no comment for this version
To version 67.1
edited by Lachlan Deck
on 2016/01/13 15:21
on 2016/01/13 15:21
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. ramsey1 +XWiki.ldeck - Content
-
... ... @@ -1,34 +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 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 + 3 3 == Step 1: Installing Maven == 4 4 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. 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. 6 6 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: 33 +(a) You can use MacPorts ([[https:~~/~~/www.macports.org>>url:https://www.macports.org||shape="rect"]]) to install: 9 9 10 -{{noformat}} 11 -sudo port install maven3 35 +{{code title="MacPorts usage" theme="Emacs" language="bash"}} 36 +$ sudo port install maven3 37 +{{/code}} 12 12 13 - {{/noformat}}39 +(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]): 14 14 15 -In future, to keep this up to date: 41 +{{code title="Homebrew usage" theme="Emacs" language="bash"}} 42 +$ brew install maven 43 +{{/code}} 16 16 17 -{{noformat}} 18 -sudo port upgrade maven3 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: 19 19 20 -{{/noformat}} 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}} 21 21 22 - Don'tforgettoinstallmaven_select:58 +Then in your bash profile, ensure your path and java home are updated: 23 23 24 -{{noformat}} 25 -sudo port install maven_select 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}} 26 26 27 -{{/noformat}} 28 -{{/tip}} 67 + 29 29 30 - **NOTE**: Itisveryhelpfulif you understandsome Mavenconceptsbeforecontinuingwith thistutorial. See [[doc:GeneralMavenDocumentation]]for more information.69 +Whichever installation approach you've taken, you should now be able to do 31 31 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 + 32 32 == Step 2: Configuring your Maven Settings == 33 33 34 34 Advanced users can skip this step, but it's highly recommended. ... ... @@ -37,6 +37,8 @@ 37 37 38 38 **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. 39 39 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 + 40 40 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. 41 41 42 42 == Step 3: Installing WebObjects Libraries ==