Skip to Content

Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09
From version 26.1
edited by Lachlan Deck
on 2008/11/23 16:15
Change comment: Adding warning about installing the right jars
To version 45.1
edited by Henrique Prange
on 2008/05/01 18:05
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ldeck
1 +XWiki.hprange
Content
... ... @@ -2,16 +2,6 @@
2 2  
3 3  Downloading and installing the latest version of [[Maven>>http://maven.apache.org/download]] is the first step to start using this tool.
4 4  
5 -{{tip title="Mac Tip"}}
6 -
7 - install macports [http://www.macports.org/install.php], then on the terminal
8 - {noformat}sudo port install maven2{noformat}
9 -
10 - In future, to keep this up to date:
11 - {noformat}sudo port upgrade maven2{noformat}
12 -
13 -{{/tip}}
14 -
15 15  **NOTE**: It is very helpful if you understand some Maven concepts before continue with this tutorial. See [[General Maven Documentation]] for more information.
16 16  
17 17  == Step 2: Configuring your Maven Settings ==
... ... @@ -22,19 +22,14 @@
22 22  
23 23  {{noformat}}
24 24  
25 -<settings xmlns="http://maven.apache.org/POM/4.0.0"
26 - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
27 - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
28 - http://maven.apache.org/xsd/settings-1.0.0.xsd">
15 +<settings>
16 + ...
29 29   <pluginGroups>
30 30   <pluginGroup>org.objectstyle.woproject.maven2</pluginGroup>
31 31   </pluginGroups>
20 + ...
32 32   <profiles>
33 33   <profile>
34 - <id>woproject</id>
35 - <activation>
36 - <activeByDefault>true</activeByDefault>
37 - </activation>
38 38   <pluginRepositories>
39 39   <pluginRepository>
40 40   <id>mdimension.releases</id>
... ... @@ -62,9 +62,10 @@
62 62   <enabled>true</enabled>
63 63   </snapshots>
64 64   </pluginRepository>
65 - </pluginRepositories>
50 + <pluginRepositories>
66 66   </profile>
67 67   </profiles>
53 + ...
68 68  </settings>
69 69  
70 70  {{/noformat}}
... ... @@ -83,12 +83,6 @@
83 83  
84 84  **NOTE**: WebObjects must be installed. See the [[maven-wobootstrap-plugin]] documentation for more information. See [[Maven Introduction to Repositories>>http://maven.apache.org/guides/introduction/introduction-to-repositories.html]] if you want more information about Maven repositories.
85 85  
86 -{{warning title="Installing the right jars!"}}
87 -
88 -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.
89 -
90 -{{/warning}}
91 -
92 92  == Step 4: Creating a WebObjects Project ==
93 93  
94 94  Archetypes are the fast way to create a new project using Maven. WOProject provides one archetype to create WebObjects Application. Execute the following command to generate a basic WebObjects project:
... ... @@ -97,7 +97,7 @@
97 97  
98 98  mvn archetype:generate -DarchetypeArtifactId=woapplication-archetype \
99 99   -DarchetypeGroupId=org.objectstyle.woproject.maven2 \
100 - -DarchetypeVersion=2.0.16 \
80 + -DarchetypeVersion=2.0.14 \
101 101   -DarchetypeRepository=http://webobjects.mdimension.com/maven2/releases
102 102  
103 103  {{/noformat}}
... ... @@ -106,8 +106,6 @@
106 106  
107 107  **NOTE**: You can use archetype catalogs to reduce the number of properties to set while creating a project. See the documentation of [[woapplication-archetype]].
108 108  
109 -**NOTE**: You can use archetypes within Eclipse as described [[here>>Maven Create WO Application Project||anchor="m2eclipse"]].
110 -
111 111  == Step 5: Importing the Project into Eclipse ==
112 112  
113 113  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.
... ... @@ -115,9 +115,9 @@
115 115  {{note title="Warning"}}
116 116  
117 117  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:
118 -# Use the [mvn eclipse:eclipse|http://maven.apache.org/plugins/maven-eclipse-plugin/] goal to update your .classpath file.
119 -# Use the [m2eclipse|http://m2eclipse.codehaus.org/] plug-in for Eclipse.
120 -# Use the [q4e|http://code.google.com/p/q4e/] plug-in for Eclipse.
96 +# Use the mvn eclipse:eclipse goal to update your .classpath file.
97 +# Use the m2eclipse plug-in for Eclipse.
98 +# Use the q4e plug-in for Eclipse.
121 121  
122 122  {{/note}}
123 123  
... ... @@ -127,7 +127,7 @@
127 127  
128 128  == Step 6: Building WebObjects Applications with Maven ==
129 129  
130 -Now, building your project with Maven is easy. Go to the project folder on Terminal and execute:
108 +Now, building your project with Maven is easy. Point to the project folder on Terminal and execute:
131 131  
132 132  {{noformat}}
133 133