Changes for page Quick Start

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,26 +1,41 @@
	1	+== Outline ==
	2	+
	3	+{{toc style="disc" indent="20px"}}{{/toc}}
	4	+
1	1	== Step 1: Installing Maven ==
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		-**NOTE**: It is very helpful if you understand some Maven concepts before continue with this tutorial. See [[General Maven Documentation]] for more information.
	9	+{{tip title="Mac Tip"}}
6	6
	11	+ install macports [http://www.macports.org/install.php], then on the terminal
	12	+ {noformat}sudo port install maven2{noformat}
	13	+
	14	+ In future, to keep this up to date:
	15	+ {noformat}sudo port upgrade maven2{noformat}
	16	+
	17	+{{/tip}}
	18	+
	19	+**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[General Maven Documentation]] for more information.
	20	+
7	7	== Step 2: Configuring your Maven Settings ==
8	8
9		-Before start using Maven, you have to configure it in order to use the plug-ins provided by WOProject. General Maven configuration is made in a settings.xml file. This file can be found at .m2 folder in the user home (,,/.m2 on Unix systems and C:ocuments and Settingsserm2 on Windows). If this file doesn't exist yet, just create it.,,
	23	+Before start using Maven, you have to configure it in order to use the plug-ins provided by WOProject. General Maven configuration is made in a settings.xml file. This file can be found in a folder called ##.m2## in each user's home directory (,,/.m2 on Unix systems and C:ocuments and SettingsserNamem2 on Windows). If this file does not yet exist, you can just create it.,,
10	10
11		-You have to define the WOProject plug-in group and the repositories to download the plug-ins. The following snippet shows how to make this configuration:
	25	+You have to define the WOProject plug-in group and the repositories to download the plug-ins. The following xml is sufficient to configure maven for using WOProject-maven plugin:
12	12
13	13	{{noformat}}
14	14
15		-<settings>
16		- ...
	29	+<settings xmlns="http://maven.apache.org/POM/4.0.0"
	30	+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	31	+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
	32	+ http://maven.apache.org/xsd/settings-1.0.0.xsd">
17	17	<pluginGroups>
18	18	<pluginGroup>org.objectstyle.woproject.maven2</pluginGroup>
19	19	</pluginGroups>
20		- ...
21	21	<profiles>
22	22	<profile>
23		- <id>default</id>
	38	+ <id>woproject</id>
24	24	<activation>
25	25	<activeByDefault>true</activeByDefault>
26	26	</activation>
...	...	@@ -51,15 +51,14 @@
51	51	<enabled>true</enabled>
52	52	</snapshots>
53	53	</pluginRepository>
54		- <pluginRepositories>
	69	+ </pluginRepositories>
55	55	</profile>
56	56	</profiles>
57		- ...
58	58	</settings>
59	59
60	60	{{/noformat}}
61	61
62		-**NOTE**: You can download the complete settings.xml [[here>>^settings.xml]]. See [[Maven Settings Reference>>http://maven.apache.org/settings.html]] if you want more information about the settings.xml file.
	76	+**NOTE**: You can download the complete and most recent settings.xml [[here>>^settings.xml]]. See [[Maven Settings Reference>>http://maven.apache.org/settings.html]] if you want more information about additional options for the settings.xml file.
63	63
64	64	== Step 3: Installing WebObjects Libraries ==
65	65
...	...	@@ -73,6 +73,12 @@
73	73
74	74	**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.
75	75
	90	+{{warning title="Installing the right jars!"}}
	91	+
	92	+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.
	93	+
	94	+{{/warning}}
	95	+
76	76	== Step 4: Creating a WebObjects Project ==
77	77
78	78	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:
...	...	@@ -81,7 +81,7 @@
81	81
82	82	mvn archetype:generate -DarchetypeArtifactId=woapplication-archetype \
83	83	-DarchetypeGroupId=org.objectstyle.woproject.maven2 \
84		- -DarchetypeVersion=2.0.15 \
	104	+ -DarchetypeVersion=2.0.16 \
85	85	-DarchetypeRepository=http://webobjects.mdimension.com/maven2/releases
86	86
87	87	{{/noformat}}
...	...	@@ -115,8 +115,18 @@
115	115
116	116	{{noformat}}
117	117
118		-mvn clean install
	138	+mvn clean package
119	119
120	120	{{/noformat}}
121	121
122	122	This goal will generate a WOA package inside the target folder of your project. It also generates two compressed packages: one for woapplication and other for the webserver resources.
	143	+
	144	+To install your project into your local repository:
	145	+
	146	+{{noformat}}
	147	+
	148	+mvn clean install
	149	+
	150	+{{/noformat}}
	151	+
	152	+This will install your project into ##,,/.m2/repository/your/project/groupId/artifactId/version/...,,##