Changes for page Quick Start

Last modified by Paul Hoadley on 2025/01/30 02:09

From version 63.1
edited by Ramsey Gurley
on 2015/05/01 13:23
Change comment: There is no comment for this version
To version 60.1
edited by Lachlan Deck
on 2011/08/20 19:56
Change comment: There is no comment for this version

Summary

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 ==
... ... @@ -48,13 +48,14 @@
48 48  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:
49 49  
50 50  {{noformat}}
51 -mvn wobootstrap:install -DwebObjectsLibFolder=/Library/WebObjects/lib -DwebObjectsVersion=5.4.3
52 52  
51 +mvn wobootstrap:install
52 +
53 53  {{/noformat}}
54 54  
55 55  **NOTE**: WebObjects must be installed.
56 56  
57 -**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.
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,6 +67,7 @@
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 +
70 70  mvn archetype:generate -DarchetypeArtifactId=erxapplication-archetype \
71 71   -DarchetypeGroupId=org.objectstyle.woproject.maven2 \
72 72   -DarchetypeVersion=2.1
... ... @@ -75,11 +75,11 @@
75 75  
76 76  The maven-archetype-plugin will ask the required information to create the new project.
77 77  
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]].
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]].
79 79  
80 80  **NOTE**: You can use archetypes within Eclipse as described [[here>>doc:documentation.Maven Create WO Application Project||anchor="m2eclipse"]].
81 81  
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"]].
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"]].
83 83  
84 84  == Step 5: Importing the Project into Eclipse ==
85 85  
... ... @@ -102,6 +102,7 @@
102 102  Now, building your project with Maven is easy. Go to the project folder on Terminal and execute:
103 103  
104 104  {{noformat}}
106 +
105 105  mvn clean package
106 106  
107 107  {{/noformat}}
... ... @@ -111,6 +111,7 @@
111 111  To install your project into your local repository:
112 112  
113 113  {{noformat}}
116 +
114 114  mvn clean install
115 115  
116 116  {{/noformat}}