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 63.1
edited by Ramsey Gurley
on 2015/05/01 13:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ldeck
1 +XWiki.ramsey
Content
... ... @@ -1,35 +1,36 @@
1 1  == Outline ==
2 2  
3 -== Step 1: Installing Maven ==
3 +== Step 0: Install latest Java ==
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 +If you're on a Mac, it's using old and busted Java 6. Update that to Java 8.
6 6  
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:
7 +== Step 1: Installing Maven ==
9 9  
10 -{{noformat}}
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:
11 11  
12 -sudo port install maven3
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}}
13 13  
14 -{{/noformat}}
22 +Then in your bash profile, make your path look something like:
15 15  
16 -In future, to keep this up to date:
24 +export PATH=/usr/local/apache-maven/bin:$PATH
17 17  
18 -{{noformat}}
26 +And tell maven where your non-mac Java home is located
19 19  
20 -sudo port upgrade maven3
28 +export JAVA_HOME=$(/usr/libexec/java_home)
21 21  
22 -{{/noformat}}
30 +You should now be able to do
23 23  
24 -Don't forget to install maven_select:
32 +mvn -version
25 25  
26 -{{noformat}}
27 -
28 -sudo port install maven_select
29 -
30 -{{/noformat}}
31 -{{/tip}}
32 -
33 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.
34 34  
35 35  == Step 2: Configuring your Maven Settings ==
... ... @@ -47,14 +47,13 @@
47 47  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:
48 48  
49 49  {{noformat}}
51 +mvn wobootstrap:install -DwebObjectsLibFolder=/Library/WebObjects/lib -DwebObjectsVersion=5.4.3
50 50  
51 -mvn wobootstrap:install
52 -
53 53  {{/noformat}}
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.
57 +**See** the [[doc:maven-wobootstrap-plugin]] documentation for more information and options for specifying a specific version.
58 58  
59 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.
60 60  
... ... @@ -67,7 +67,6 @@
67 67  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:
68 68  
69 69  {{noformat}}
70 -
71 71  mvn archetype:generate -DarchetypeArtifactId=erxapplication-archetype \
72 72   -DarchetypeGroupId=org.objectstyle.woproject.maven2 \
73 73   -DarchetypeVersion=2.1
... ... @@ -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]].
78 +**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]].
80 80  
81 81  **NOTE**: You can use archetypes within Eclipse as described [[here>>doc: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"]].
82 +**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"]].
84 84  
85 85  == Step 5: Importing the Project into Eclipse ==
86 86  
... ... @@ -103,7 +103,6 @@
103 103  Now, building your project with Maven is easy. Go to the project folder on Terminal and execute:
104 104  
105 105  {{noformat}}
106 -
107 107  mvn clean package
108 108  
109 109  {{/noformat}}
... ... @@ -113,7 +113,6 @@
113 113  To install your project into your local repository:
114 114  
115 115  {{noformat}}
116 -
117 117  mvn clean install
118 118  
119 119  {{/noformat}}