Skip to Content

Changes for page maven-wobootstrap-plugin

Last modified by Lachlan Deck on 2011/08/16 18:43
From version 13.1
edited by Ulrich Köster
on 2006/11/07 03:16
Change comment: There is no comment for this version
To version 15.1
edited by Henrique Prange
on 2008/04/23 14:58
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.uli
1 +XWiki.hprange
Content
... ... @@ -1,23 +1,48 @@
1 -== Description ==
1 +== Introduction ==
2 2  
3 -"maven-wobootstrap-plugin" is a plug-in for importing woframeworks into the local maven repository.
3 +The wobootstrap plug-in is used to import the WebObjects libraries to the Maven's local repository or a remote repository for sharing with other developers and projects (for WebObjects version 5.3 and later, the license is now included as part of the Xcode software license. Please review the license in the Xcode installer to verify if you are not breaking the current terms).
4 4  
5 -== Goals ==
5 +This plug-in searches for the WebObjects jars and generates all the required information (groupId, artifactId and version) to import the libraries to the particular repository.
6 6  
7 -=== ##org.objectstyle.woproject.maven2:wobootstrap:bootstrap## ===
7 +The wobootstrap goals usually need to be executed once per WebObjects version.
8 8  
9 -Bootstrap goal for WebObjects projects. Copy all necessary WebObjects jars into local maven repository.
9 +WebObjects 5.2 or later must be installed in order to use the wobootstrap plug-in. The supported platforms include MacOS X, Windows and Linux.
10 10  
11 -For the moment, this goal only works for MacOS X and Windows.
11 +== Goals Overview ==
12 12  
13 -This plug-in only requires to be executed once.
13 +The wobootstrap plug-in has 2 goals:
14 14  
15 -=== Example ===
15 +* **wobootstrap:install* goal is used to import the WebObjects libraries to the local repository. It works in a similar way to the [[install:install-file>>http://maven.apache.org/plugins/maven-install-plugin/]] goal, but the wobootstrap provides all the required information to install the jars.**
16 16  
17 -This goal doesn't need any previous configuration. Just execute the following command:
17 +* **woboostrap:deploy* goal is used to import the WebObjects libraries to the specified remote repository. It works in a similar way to the [[deploy:deploy-file>>http://maven.apache.org/plugins/maven-deploy-plugin/]] goal.**
18 18  
19 +== Usage ==
20 +
21 +=== The wobootstrap:install Mojo ===
22 +
23 +In most cases, wobootstrap:install doesn't need any configuration. It also doesn't need a Maven project to run.
24 +
19 19  {{noformat}}
20 20  
21 -mvn wobootstrap:bootstrap
27 +mvn wobootstrap:install
22 22  
23 23  {{/noformat}}
30 +
31 +=== The wobootstrap:deploy Mojo ===
32 +
33 +The wobootstrap:deploy Mojo is used to install the WebObjects libraries to a remote repository (i.e. managed by an Enterprise Repository Manager). The full usage statement of the wobootstrap:deploy mojo can be described as:
34 +
35 +{{noformat}}
36 +
37 +mvn wobootstrap:deploy -Durl=file://C:\m2-repo \
38 + -DrepositoryId=some.id
39 +
40 +{{/noformat}}
41 +
42 +If the url to deploy is not specified, the goal will fail. The repositoryId points to a server section in the settings.xml file. If you don't specify a repositoryId, Maven will try to extract authentication information using the default id 'remote-repository'.
43 +
44 +== Tips ==
45 +
46 +If the following error happens while using the wobootstrap:deploy goal: "Error deploying artifact: Unsupported Protocol: 'ftp': Cannot find wagon which supports the requested protocol: ftp"
47 +
48 +See the solution [[here>>http://maven.apache.org/plugins/maven-deploy-plugin/faq.html]].