Changes for page Quick Start

Summary

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

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.ramsey
	1	+XWiki.ldeck

Content

...	...	@@ -1,36 +1,35 @@
1	1	== Outline ==
2	2
3		-== Step 0: Install latest Java ==
	3	+== Step 1: Installing Maven ==
4	4
5		-If you're on a Mac, it's using old and busted Java 6. Update that to Java 8.
	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.
6	6
7		-== Step 1: Installing Maven ==
	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:
8	8
9		-Downloading and installing the latest version of [[Maven>>url:https://maven.apache.org/download.cgi||shape="rect"]] is the first step to start using this tool. Download the binary tarball, copy it to /usr/local/, unpack it, soft link it and add the path to your bash_profile:
	10	+{{noformat}}
10	10
11		-{{code title="shell"}}
12		-sudo su
13		-cd /usr/local/
14		-curl -O http://mirror.tcpdiag.net/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
15		-tar -xzf apache-maven-3.3.3-bin.tar.gz
16		-ln -s apache-maven-3.3.3 apache-maven
17		-exit
18		-cd ~/
19		-vi .bash_profile
20		-{{/code}}
	12	+sudo port install maven3
21	21
22		-Then in your bash profile, make your path look something like:
	14	+{{/noformat}}
23	23
24		-export PATH=/usr/local/apache-maven/bin:$PATH
	16	+In future, to keep this up to date:
25	25
26		-And tell maven where your non-mac Java home is located
	18	+{{noformat}}
27	27
28		-export JAVA_HOME=$(/usr/libexec/java_home)
	20	+sudo port upgrade maven3
29	29
30		-You should now be able to do
	22	+{{/noformat}}
31	31
32		-mvn -version
	24	+Don't forget to install maven_select:
33	33
	26	+{{noformat}}
	27	+
	28	+sudo port install maven_select
	29	+
	30	+{{/noformat}}
	31	+{{/tip}}
	32	+
34	34	**NOTE**: It is very helpful if you understand some Maven concepts before continuing with this tutorial. See [[doc:General Maven Documentation]] for more information.
35	35
36	36	== Step 2: Configuring your Maven Settings ==
...	...	@@ -41,8 +41,6 @@
41	41
42	42	**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.
43	43
44		-Download the [[archetype-catalog.xml>>url:http://maven.wocommunity.org/content/groups/public/archetype-catalog.xml||shape="rect"]] and copy it to ~~/.m2/archetype-catalog.xml
45		-
46	46	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.
47	47
48	48	== Step 3: Installing WebObjects Libraries ==
...	...	@@ -50,13 +50,14 @@
50	50	Maven takes control of all your project's dependencies. To develop WebObjects applications, Maven has to reference the WebObjects jars. You have to install the WebObjects libraries into your local repository to accomplish this:
51	51
52	52	{{noformat}}
53		-mvn wobootstrap:install -DwebObjectsLibFolder=/Library/WebObjects/lib -DwebObjectsVersion=5.4.3
54	54
	51	+mvn wobootstrap:install
	52	+
55	55	{{/noformat}}
56	56
57	57	**NOTE**: WebObjects must be installed.
58	58
59		-**See** the [[doc:maven-wobootstrap-plugin]] documentation for more information and options for specifying a specific version.
	57	+**See** the [[maven-wobootstrap-plugin>>doc:maven-wobootstrap-plugin]] documentation for more information and options for specifying a specific version.
60	60
61	61	**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.
62	62
...	...	@@ -69,6 +69,7 @@
69	69	Archetypes are the fast way to create a new project using Maven and WOProject provides various archetypes of its own to get you started with WebObjects, or better, Wonder-based applications. Execute the following command to generate a basic Wonder application project:
70	70
71	71	{{noformat}}
	70	+
72	72	mvn archetype:generate -DarchetypeArtifactId=erxapplication-archetype \
73	73	-DarchetypeGroupId=org.objectstyle.woproject.maven2 \
74	74	-DarchetypeVersion=2.1
...	...	@@ -77,11 +77,11 @@
77	77
78	78	The maven-archetype-plugin will ask the required information to create the new project.
79	79
80		-**NOTE**: You can use archetype catalogs to reduce the number of properties to set while creating a project. See the documentation of [[doc:woapplication-archetype]].
	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]].
81	81
82	82	**NOTE**: You can use archetypes within Eclipse as described [[here>>doc:documentation.Maven Create WO Application Project||anchor="m2eclipse"]].
83	83
84		-**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"]].
	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"]].
85	85
86	86	== Step 5: Importing the Project into Eclipse ==
87	87
...	...	@@ -104,6 +104,7 @@
104	104	Now, building your project with Maven is easy. Go to the project folder on Terminal and execute:
105	105
106	106	{{noformat}}
	106	+
107	107	mvn clean package
108	108
109	109	{{/noformat}}
...	...	@@ -113,6 +113,7 @@
113	113	To install your project into your local repository:
114	114
115	115	{{noformat}}
	116	+
116	116	mvn clean install
117	117
118	118	{{/noformat}}