Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 79.1
edited by Paul Hoadley
on 2025/01/30 02:09
Change comment: Updates with JVM options required beyond Java 8.
To version 77.1
edited by Paul Hoadley
on 2023/12/25 09:20
Change comment: Updates and simplifies these instructions.

Summary

Details

Page properties
Content
... ... @@ -1,31 +1,31 @@
1 1  (% class="auto-cursor-target" %)
2 -You should be able to get a "Hello, World!" Wonder application running using [[Maven>>https://maven.apache.org]] in about 10 minutes.
2 +You should be able to get a "Hello, World!" Wonder application running using Maven in about 10 minutes.
3 3  
4 -(% id="HAssumptions" class="auto-cursor-target" %)
4 +(% class="auto-cursor-target" %)
5 5  = Assumptions =
6 6  
7 7  We're going to make a few assumptions to keep this page brief:
8 8  
9 9  1. You are running macOS X. You can probably get a WebObjects development environment up on a different OS, but we won't cover that here.
10 -1. You have Java installed. Any version will do. People are running WebObjects on Java 21 in production.
11 -1. You have Eclipse and WOLips installed. Install the [[latest version of Eclipse>>https://www.eclipse.org/downloads/packages/]], along with the [[latest WOLips>>https://github.com/wocommunity/wolips]] if you haven't already.
10 +1. You have Java installed. //We are actually going to assume you're using Java 8//, but only because it's just marginally easier to launch the application under Java 8. People are running WebObjects on Java 21 in production.
11 +1. You have Eclipse and WOLips installed. Eclipse versions as recent as 2023-09 have been shown to be just fine, albeit with a slightly modified WOLips. Again we won't cover any of that here.
12 12  
13 -(% id="HSetup" class="auto-cursor-target" %)
13 +(% class="auto-cursor-target" %)
14 14  = Setup =
15 15  
16 16  (% class="auto-cursor-target" %)
17 -You need to install Maven:
17 +You need to install Maven. [[Download the latest version of Maven>>https://maven.apache.org/download.cgi]] from Apache.
18 18  
19 19  (% class="auto-cursor-target" %)
20 20  {{{$ cd ~/Applications
21 -$ curl -O https://dlcdn.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.zip
22 -$ unzip apache-maven-3.9.9-bin.zip
23 -$ ln -s apache-maven-3.9.9 apache-maven
21 +$ curl -O https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.zip
22 +$ unzip apache-maven-3.9.6-bin.zip
23 +$ ln -s apache-maven-3.9.6 apache-maven
24 24  }}}
25 25  
26 -Add ##bin## to your path in your shell's startup file, say ##~~/.zshrc##:
26 +Add ##bin## to your path in your shell's startup file, say ##~~/.zshrc##.
27 27  
28 -{{{PATH=$PATH:/Users/paulh/Applications/apache-maven-3.9.9/bin
28 +{{{PATH=$PATH:/Users/paulh/Applications/apache-maven-3.9.6/bin
29 29  }}}
30 30  
31 31  (% class="auto-cursor-target" %)
... ... @@ -37,13 +37,13 @@
37 37  }}}
38 38  
39 39  (% class="auto-cursor-target" %)
40 -Finally, add ##~~/.m2/settings.xml##:
40 +Finally, add ~~/.m2/settings.xml:
41 41  
42 42  (% class="auto-cursor-target" %)
43 43  {{{<settings xmlns="http://maven.apache.org/POM/4.0.0"
44 - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
45 - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
46 - http://maven.apache.org/xsd/settings-1.0.0.xsd">
44 + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
45 + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
46 + http://maven.apache.org/xsd/settings-1.0.0.xsd">
47 47   <profiles>
48 48   <profile>
49 49   <id>wocommunity</id>
... ... @@ -79,7 +79,7 @@
79 79  </settings>
80 80  }}}
81 81  
82 -(% id="HCreateanewapplicationproject" class="auto-cursor-target" %)
82 +(% class="auto-cursor-target" %)
83 83  = Create a new application project =
84 84  
85 85  (% class="auto-cursor-target" %)
... ... @@ -100,17 +100,10 @@
100 100  Define value for property 'version' 1.0-SNAPSHOT: : 0.1-SNAPSHOT
101 101  Define value for property 'package' example.app: : example.app.foo}}}
102 102  
103 +(% class="auto-cursor-target" %)
104 +You can enter your own values if you like, but remember to stick with Java 1.8 for the moment. Hit 'Y' to confirm when requested.
103 103  
104 -You can enter any version of Java. You should definitely change ##WonderVersion## from 7.2 → 7.4. Hit 'Y' to confirm when requested.
105 -
106 -(% class="box infomessage" %)
107 -(((
108 -If you enter a ##JavaVersion## greater than 1.8 (there are people using Java 21 in production, for example: enter ##21##), you need to add the following line to build.properties:
109 -\\##jvmOptions=~-~-add-exports java.base/sun.security.action=ALL-UNNAMED ~-~-add-exports java.base/sun.util.calendar=ALL-UNNAMED##
110 -)))
111 -
112 -
113 -(% id="HBuildandlaunchtheapplication" class="auto-cursor-target" %)
106 +(% class="auto-cursor-target" %)
114 114  = Build and launch the application =
115 115  
116 116  (% class="auto-cursor-target" %)
... ... @@ -131,7 +131,7 @@
131 131  
132 132  >Hello WOnder world!
133 133  
134 -(% id="HImportyourprojectintoEclipse" class="auto-cursor-target" %)
127 +(% class="auto-cursor-target" %)
135 135  = Import your project into Eclipse =
136 136  
137 137  (% class="auto-cursor-target" %)
... ... @@ -141,14 +141,5 @@
141 141  1. Using the file browser, find the top-level "Foo" folder containing the project you created above, click Open.
142 142  1. Ensure ##pom.xml## is checked and click Finish.
143 143  
144 -(% class="box infomessage" %)
145 -(((
146 -As above, if you're using Java beyond Java 8, you need to add the following to the launch configuration under Arguments > VM arguments:
147 -\\##~-~-add-exports java.base/sun.security.action=ALL-UNNAMED ~-~-add-exports java.base/sun.util.calendar=ALL-UNNAMED##
148 -)))
149 -
150 -
151 -
152 -
153 153  (% class="auto-cursor-target" %)
154 154  You're done.
settings.xml
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +1.9 KB
Content
... ... @@ -1,0 +1,73 @@
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>