Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 60.1
edited by Lachlan Deck
on 2011/08/20 19:56
Change comment: There is no comment for this version
To version 59.1
edited by Lachlan Deck
on 2011/08/20 19:56
Change comment: Updating archetypeVersion to use for quick start. Adding reminder about installing maven_select.

Summary

Details

Page properties
Content
... ... @@ -2,45 +2,38 @@
2 2  
3 3  == Step 1: Installing Maven ==
4 4  
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.
5 +Downloading and installing the latest version of [[Maven>>http://maven.apache.org/download]] is the first step to start using this tool.
6 6  
7 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:
9 9  
10 -{{noformat}}
11 -
9 +install macports [http://www.macports.org/install.php], then on the terminal:
10 +{noformat}
12 12  sudo port install maven3
12 +{noformat}
13 13  
14 -{{/noformat}}
15 -
16 16  In future, to keep this up to date:
17 -
18 -{{noformat}}
19 -
15 +{noformat}
20 20  sudo port upgrade maven3
17 +{noformat}
21 21  
22 -{{/noformat}}
23 -
24 24  Don't forget to install maven_select:
25 -
26 -{{noformat}}
27 -
20 +{noformat}
28 28  sudo port install maven_select
22 +{noformat}
29 29  
30 -{{/noformat}}
31 31  {{/tip}}
32 32  
33 -**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
26 +**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[General Maven Documentation]] for more information.
34 34  
35 35  == Step 2: Configuring your Maven Settings ==
36 36  
37 37  Advanced users can skip this step, but it's highly recommended.
38 38  
39 -[[doc:Quick Start Maven Settings Configuration Guide]]
32 +[[Quick Start Maven Settings Configuration Guide]]
40 40  
41 -**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.
34 +**NOTE for those who know what to do**: You can download the complete and most recent settings.xml [[here>>^settings.xml]] and install it to /.m2/settings.xml.
42 42  
43 -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.
36 +See [[Maven Settings Reference>>http://maven.apache.org/settings.html]] if you want more information about additional options for the settings.xml file.
44 44  
45 45  == Step 3: Installing WebObjects Libraries ==
46 46  
... ... @@ -54,12 +54,14 @@
54 54  
55 55  **NOTE**: WebObjects must be installed.
56 56  
57 -**See** the [[maven-wobootstrap-plugin>>doc:maven-wobootstrap-plugin]] documentation for more information and options for specifying a specific version.
50 +**See** the [[maven-wobootstrap-plugin>>maven-wobootstrap-plugin]] documentation for more information and options for specifying a specific version.
58 58  
59 -**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.
52 +**See** [[Maven Introduction to Repositories>>http://maven.apache.org/guides/introduction/introduction-to-repositories.html]] if you want more information about Maven repositories.
60 60  
61 61  {{warning title="Installing the right jars!"}}
62 -Do **not** link to or install the WebObjects jars located inside {{code language="none"}}/System/Library/Frameworks{{/code}} or {{code language="none"}}/Library/Frameworks{{/code}}. If you're installing an older version of WebObjects you must obtain the jars that the WebObjects installer had previously installed into {{code language="none"}}/Library/WebObjects/lib{{/code}}. For example, the jar {{code language="none"}}/Library/WebObjects/lib/JavaWebObjects.jar{{/code}} has the complete set of resources and files included for the dependency JavaWebObjects whereas {{code language="none"}}/System/Library/Frameworks/JavaWebObjects.framework/Resources/Java/javawebobjects.jar{{/code}} does not.
55 +
56 +Do *not* link to or install the WebObjects jars located inside {{/System/Library/Frameworks}} or {{/Library/Frameworks}}. If you're installing an older version of WebObjects you must obtain the jars that the WebObjects installer had previously installed into {{/Library/WebObjects/lib}}. For example, the jar {{/Library/WebObjects/lib/JavaWebObjects.jar}} has the complete set of resources and files included for the dependency JavaWebObjects whereas {{/System/Library/Frameworks/JavaWebObjects.framework/Resources/Java/javawebobjects.jar}} does not.
57 +
63 63  {{/warning}}
64 64  
65 65  == Step 4: Creating a WebObjects or Wonder Project ==
... ... @@ -76,11 +76,11 @@
76 76  
77 77  The maven-archetype-plugin will ask the required information to create the new project.
78 78  
79 -**NOTE**: You can use archetype catalogs to reduce the number of properties to set while creating a project. See the documentation of [[woapplication-archetype>>doc:woapplication-archetype]].
74 +**NOTE**: You can use archetype catalogs to reduce the number of properties to set while creating a project. See the documentation of [[woapplication-archetype>>woapplication-archetype]].
80 80  
81 -**NOTE**: You can use archetypes within Eclipse as described [[here>>doc:documentation.Maven Create WO Application Project||anchor="m2eclipse"]].
76 +**NOTE**: You can use archetypes within Eclipse as described [[here>>documentation:Maven Create WO Application Project||anchor="m2eclipse"]].
82 82  
83 -**NOTE:** You can see the list of available archetypes in the following location: [[http:~~/~~/wo-repository.moleque.com.br/nexus/content/groups/public/org/objectstyle/woproject/maven2/>>url:http://wo-repository.moleque.com.br/nexus/content/groups/public/org/objectstyle/woproject/maven2/||shape="rect"]].
78 +**NOTE:* You can see the list of available archetypes in the following location: [[http://wo-repository.moleque.com.br/nexus/content/groups/public/org/objectstyle/woproject/maven2/]].**
84 84  
85 85  == Step 5: Importing the Project into Eclipse ==
86 86  
... ... @@ -87,16 +87,17 @@
87 87  The new project is ready to be imported into Eclipse workspace. Use the Eclipse's import wizard (File > Import...) and choose the option "Existing Projects into Workspace". Select the root directory of your new project and finish the import wizard.
88 88  
89 89  {{note title="Warning"}}
85 +
90 90  As Maven takes care of the dependency management, you must use a mechanism to add the jars to your Eclipse build path. There are 3 options:
87 +# Use the [mvn eclipse:eclipse|http://maven.apache.org/plugins/maven-eclipse-plugin/] goal to update your .classpath file.
88 +# Use the [m2eclipse|http://m2eclipse.codehaus.org/] plug-in for Eclipse.
89 +# Use the [q4e|http://code.google.com/p/q4e/] plug-in for Eclipse.
91 91  
92 -1. Use the [[mvn eclipse:eclipse>>url:http://maven.apache.org/plugins/maven-eclipse-plugin/||shape="rect"]] goal to update your .classpath file.
93 -1. Use the [[m2eclipse>>url:http://m2eclipse.codehaus.org/||shape="rect"]] plug-in for Eclipse.
94 -1. Use the [[q4e>>url:http://code.google.com/p/q4e/||shape="rect"]] plug-in for Eclipse.
95 95  {{/note}}
96 96  
97 97  After adding the project dependencies to your Eclipse build path, WOLips can build the project and you will be able to start developing and running the application.
98 98  
99 -**NOTE**: This tutorial assumes you have chosen the option 2. You can find more information about IDE integration [[here>>doc:General Maven Documentation||anchor="IDE Integration"]].
95 +**NOTE**: This tutorial assumes you have chosen the option 2. You can find more information about IDE integration [[here>>General Maven Documentation||anchor="IDE Integration"]].
100 100  
101 101  == Step 6: Building WebObjects Applications with Maven ==
102 102  
... ... @@ -118,4 +118,4 @@
118 118  
119 119  {{/noformat}}
120 120  
121 -This will install your project into {{code language="none"}}~/.m2/repository/your/project/groupId/artifactId/version/...{{/code}}
117 +This will install your project into ##/.m2/repository/your/project/groupId/artifactId/version/...##