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 78.1
edited by Paul Hoadley
on 2023/12/25 10:19
Change comment: Deleted attachment "settings.xml"

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. 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 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.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 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" %)
... ... @@ -100,16 +100,9 @@
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 113  (% id="HBuildandlaunchtheapplication" class="auto-cursor-target" %)
114 114  = Build and launch the application =
115 115  
... ... @@ -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.