Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 78.1
edited by Paul Hoadley
on 2023/12/25 10:19
Change comment: Deleted attachment "settings.xml"
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
... ... @@ -7,8 +7,8 @@
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 13  (% id="HSetup" class="auto-cursor-target" %)
14 14  = Setup =
... ... @@ -18,14 +18,14 @@
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 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" %)
... ... @@ -100,9 +100,16 @@
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  
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 +
106 106  (% id="HBuildandlaunchtheapplication" class="auto-cursor-target" %)
107 107  = Build and launch the application =
108 108  
... ... @@ -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.