Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 69.1
edited by Ray Kiddy
on 2022/06/25 01:49
Change comment: add wuestion in re error
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
Parent
... ... @@ -1,1 +1,0 @@
1 -WOProject-Maven
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kiddyr
1 +XWiki.ramsey
Content
... ... @@ -1,85 +1,34 @@
1 -(% class="auto-cursor-target" %)
2 -\\
1 +== Outline ==
3 3  
4 -{{tip title="2016 QuickStart"}}
5 -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"]])
6 -
7 -**Steps 0-2** (as elaborated below)
8 -
9 -0. Install Java 8 (or Java 11 ?)
10 -~1. Install Maven 3
11 -2. Update ~~/.m2/settings.xml to include the wocommunity repo
12 -
13 -**Steps 3–6**
14 -
15 -3. Install Eclipse 4.5 for Committers ([[http:~~/~~/www.eclipse.org/downloads/>>url:http://www.eclipse.org/downloads/||shape="rect"]])
16 -4. Install m2e via Help > Install New Software.... (See [[http:~~/~~/www.eclipse.org/m2e/>>url:http://www.eclipse.org/m2e/||shape="rect"]])
17 -5. Install [[doc:WOLips]]
18 -6. Preferences > Maven > Archetypes, Add Remote Catalog
19 - [[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"]]
20 -
21 -Done. The WebObjects jars are in the wocommunity repo, so no need to do woinstaller.jar hassle.
22 -{{/tip}}
23 -
24 -----
25 -
26 -(% style="color: rgb(0,0,0);font-size: 24.0px;" %)Detailed Instructions...
27 -
28 -(% style="color: rgb(0,0,0);font-size: 20.0px;" %)Step 0: Install latest Java
29 -
30 -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"]]).
31 -
32 32  == Step 1: Installing Maven ==
33 33  
34 -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.
35 35  
36 -(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:
37 37  
38 -{{code language="bash" theme="Emacs" title="MacPorts usage"}}
39 -$ sudo port install maven3
40 -{{/code}}
10 +{{noformat}}
11 +sudo port install maven3
41 41  
42 -(b) Or similarly via Homebrew ([[http:~~/~~/brew.sh>>url:http://brew.sh||shape="rect"]]):
13 +{{/noformat}}
43 43  
44 -{{code language="bash" theme="Emacs" title="Homebrew usage"}}
45 -$ brew install maven
46 -{{/code}}
15 +In future, to keep this up to date:
47 47  
48 -(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
49 49  
50 -{{code language="bash" theme="Emacs" title="Manual install"}}
51 -$ sudo su
52 -$ cd /usr/local/
53 -$ curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
54 -$ tar -xzf apache-maven-3.3.3-bin.tar.gz
55 -$ ln -s apache-maven-3.3.3 apache-maven
56 -$ exit
57 -$ cd ~/
58 -$ vi .bash_profile
59 -{{/code}}
20 +{{/noformat}}
60 60  
61 -Then in your bash profile, ensure your path and java home are updated:
22 +Don't forget to install maven_select:
62 62  
63 -{{code language="text" theme="Emacs" title="~~/.bash_profile" linenumbers="true"}}
64 -...
65 -export PATH=/usr/local/apache-maven/bin:$PATH
66 -export JAVA_HOME=$(/usr/libexec/java_home)
67 -...
68 -{{/code}}
24 +{{noformat}}
25 +sudo port install maven_select
69 69  
70 -\\
27 +{{/noformat}}
28 +{{/tip}}
71 71  
72 -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.
73 73  
74 -$ mvn -version
75 -
76 -**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.
77 -
78 -**NOTE 2**: You might also like to install bash completion utilities:
79 -
80 -* 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"]]).
81 -* 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"]]).
82 -
83 83  == Step 2: Configuring your Maven Settings ==
84 84  
85 85  Advanced users can skip this step, but it's highly recommended.
... ... @@ -88,8 +88,6 @@
88 88  
89 89  **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.
90 90  
91 -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
92 -
93 93  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.
94 94  
95 95  == Step 3: Installing WebObjects Libraries ==
... ... @@ -103,13 +103,6 @@
103 103  
104 104  **NOTE**: WebObjects must be installed.
105 105  
106 -
107 -\\[[https:~~/~~/repo.maven.apache.org/maven2>>url:https://repo.maven.apache.org/maven2||shape="rect"]]
108 -
109 -{{{NOTE: [ERROR] No plugin found for prefix 'wobootstrap' in the current project and in the plugin groups [org.apache.maven.plugins, org.codehaus.mojo] available from the repositories [local (/home/ray/.m2/repository), central ()] > [Help 1]}}}
110 -
111 -What does one do about this error? rrk (ray at ganymede.org) 2022 06-24
112 -
113 113  **See** the [[doc:maven-wobootstrap-plugin]] documentation for more information and options for specifying a specific version.
114 114  
115 115  **See** [[Maven Introduction to Repositories>>url:http://maven.apache.org/guides/introduction/introduction-to-repositories.html||shape="rect"]] if you want more information about Maven repositories.
settings.xml
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.XWikiGuest
Size
... ... @@ -1,1 +1,0 @@
1 -1.9 KB
Content
... ... @@ -1,73 +1,0 @@
1 -<settings xmlns="http://maven.apache.org/POM/4.0.0"
2 - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3 - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
4 - http://maven.apache.org/xsd/settings-1.0.0.xsd">
5 - <pluginGroups>
6 - <pluginGroup>org.objectstyle.woproject.maven2</pluginGroup>
7 - </pluginGroups>
8 -
9 - <profiles>
10 - <profile>
11 - <id>default</id>
12 - <activation>
13 - <activeByDefault>true</activeByDefault>
14 - </activation>
15 - <repositories>
16 - <repository>
17 - <id>wocommunity.releases</id>
18 - <name>WOCommunity Releases Repository</name>
19 - <url>
20 - http://maven.wocommunity.org/content/groups/public
21 - </url>
22 - <releases>
23 - <enabled>true</enabled>
24 - </releases>
25 - <snapshots>
26 - <enabled>false</enabled>
27 - </snapshots>
28 - </repository>
29 - <repository>
30 - <id>wocommunity.snapshots</id>
31 - <name>WOCommunity Snapshots Repository</name>
32 - <url>
33 - http://maven.wocommunity.org/content/groups/public-snapshots
34 - </url>
35 - <releases>
36 - <enabled>false</enabled>
37 - </releases>
38 - <snapshots>
39 - <enabled>true</enabled>
40 - </snapshots>
41 - </repository>
42 - </repositories>
43 - <pluginRepositories>
44 - <pluginRepository>
45 - <id>wocommunity.releases</id>
46 - <name>WOCommunity Releases Repository</name>
47 - <url>
48 - http://maven.wocommunity.org/content/groups/public
49 - </url>
50 - <releases>
51 - <enabled>true</enabled>
52 - </releases>
53 - <snapshots>
54 - <enabled>false</enabled>
55 - </snapshots>
56 - </pluginRepository>
57 - <pluginRepository>
58 - <id>wocommunity.snapshots</id>
59 - <name>WOCommunity Snapshots Repository</name>
60 - <url>
61 - http://maven.wocommunity.org/content/groups/public-snapshots
62 - </url>
63 - <releases>
64 - <enabled>false</enabled>
65 - </releases>
66 - <snapshots>
67 - <enabled>true</enabled>
68 - </snapshots>
69 - </pluginRepository>
70 - </pluginRepositories>
71 - </profile>
72 - </profiles>
73 -</settings>