Skip to Content

Changes for page Quick Start

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

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 in about 10 minutes.
2 +You should be able to get a "Hello, World!" Wonder application running using [[Maven>>https://maven.apache.org]] in about 10 minutes.
3 3  
4 -(% class="auto-cursor-target" %)
4 +(% id="HAssumptions" 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. //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.
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.
12 12  
13 -(% class="auto-cursor-target" %)
13 +(% id="HSetup" class="auto-cursor-target" %)
14 14  = Setup =
15 15  
16 16  (% class="auto-cursor-target" %)
17 -You need to install Maven. [[Download the latest version of Maven>>https://maven.apache.org/download.cgi]] from Apache.
17 +You need to install Maven:
18 18  
19 19  (% class="auto-cursor-target" %)
20 20  {{{$ cd ~/Applications
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
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
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.6/bin
28 +{{{PATH=$PATH:/Users/paulh/Applications/apache-maven-3.9.9/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 -(% class="auto-cursor-target" %)
82 +(% id="HCreateanewapplicationproject" class="auto-cursor-target" %)
83 83  = Create a new application project =
84 84  
85 85  (% class="auto-cursor-target" %)
... ... @@ -100,10 +100,17 @@
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.
105 105  
106 -(% class="auto-cursor-target" %)
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" %)
107 107  = Build and launch the application =
108 108  
109 109  (% class="auto-cursor-target" %)
... ... @@ -124,7 +124,7 @@
124 124  
125 125  >Hello WOnder world!
126 126  
127 -(% class="auto-cursor-target" %)
134 +(% id="HImportyourprojectintoEclipse" class="auto-cursor-target" %)
128 128  = Import your project into Eclipse =
129 129  
130 130  (% class="auto-cursor-target" %)
... ... @@ -134,5 +134,14 @@
134 134  1. Using the file browser, find the top-level "Foo" folder containing the project you created above, click Open.
135 135  1. Ensure ##pom.xml## is checked and click Finish.
136 136  
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 +
137 137  (% class="auto-cursor-target" %)
138 138  You're done.
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>