Skip to Content

Changes for page maven-wobootstrap-plugin

Last modified by Lachlan Deck on 2011/08/16 18:43
From version 14.1
edited by Henrique Prange
on 2008/04/23 14:58
Change comment: There is no comment for this version
To version 20.2
edited by Lachlan Deck
on 2011/08/16 18:43
Change comment: Changed document parent to [xwiki:WOL.Home.WOProject-Maven.WebHome].

Summary

Details

Page properties
Parent
... ... @@ -1,0 +1,1 @@
1 +WOL.Home.WOProject-Maven.WebHome
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.hprange
1 +XWiki.ldeck
Content
... ... @@ -1,6 +1,6 @@
1 1  == Introduction ==
2 2  
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).
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 (% style="color: red;" %)**(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 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  
... ... @@ -12,9 +12,9 @@
12 12  
13 13  The wobootstrap plug-in has 2 goals:
14 14  
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.**
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>>url:http://maven.apache.org/plugins/maven-install-plugin/||shape="rect"]] goal, but the wobootstrap provides all the required information to install the jars.
16 16  
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.**
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>>url:http://maven.apache.org/plugins/maven-deploy-plugin/||shape="rect"]] goal.
18 18  
19 19  == Usage ==
20 20  
... ... @@ -41,8 +41,49 @@
41 41  
42 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 43  
44 +
45 +
46 +{{tip title="Using the full identifier"}}
47 +There are two reasons for needing to specify the complete identifier of the wobootstrap plugin:
48 +
49 +* You want to use a specific version
50 +* You have an environment out of your control and you cannot adjust the pluginGroups in the settings.xml file.
51 +
52 +{{code 0="bash"}}
53 +
54 +##
55 +## Usage: <groupId>:<artifactId>[:<version>]:<goal>
56 +## where goal is either install or deploy, for example.
57 +##
58 +mvn org.objectstyle.woproject.maven2:maven-wobootstrap-plugin[:<version>]:<goal>
59 +
60 +{{/code}}
61 +{{/tip}}
62 +
63 +=== Custom WebObjects Location ===
64 +
65 +You can set 2 parameters to customize the mechanism used by this plug-in to locate WebObjects libraries:
66 +
67 +* **webObjectsLibFolder** (optional): The folder containing the WebObjects jars. If you provide a folder without the correct WebObjects libraries, the goal will succeed, but no libraries will be installed or deployed.
68 +* **webObjectsVersion** (optional): The version of the WebObjects jars.
69 +
70 +These configurations are optional, but you have to provide both if you want to customize the search for WebObjects libraries.
71 +
72 +{{noformat}}
73 +
74 +mvn wobootstrap:install -DwebObjectsLibFolder=/a_path_to_webobjects/lib \
75 + -DwebObjectsVersion=5.3.3
76 +
77 +{{/noformat}}
78 +
79 +You can use these parameters with both goals: install and deploy.
80 +
81 +{{warning title="Installing the right jars!"}}
82 +Do **not** link to or install the WebObjects jars located inside {{code language="none"}}/System/Library/Frameworks{{/code}} or {{code language="none"}}/Library/Frameworks{{/code}}. If you're installing an older version of WebObjects you must obtain the jars that the WebObjects installer had previously installed into {{code language="none"}}/Library/WebObjects/lib{{/code}}. For example, the jar {{code language="none"}}/Library/WebObjects/lib/JavaWebObjects.jar{{/code}} has the complete set of resources and files included for the dependency JavaWebObjects whereas {{code language="none"}}/System/Library/Frameworks/JavaWebObjects.framework/Resources/Java/javawebobjects.jar{{/code}} does not.
83 +{{/warning}}
84 +
44 44  == Tips ==
45 45  
46 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 47  
48 -See the solution [[here>>http://maven.apache.org/plugins/maven-deploy-plugin/faq.html]].
89 +See the solution [[here>>url:http://maven.apache.org/plugins/maven-deploy-plugin/faq.html||shape="rect"]].
XWiki.XWikiComments[0]
Date
... ... @@ -1,0 +1,1 @@
1 +2011-08-09 08:02:52.0
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.marius
Comment
... ... @@ -1,0 +1,10 @@
1 +mvn wobootstrap:install fails with
2 +
3 +[INFO] Error building POM (may not be this project's POM).
4 + Project ID: null:maven-wobootstrap-plugin:maven-plugin:null
5 + Reason: Cannot find parent: org.objectstyle.woproject.maven2:maven2 for project: null:maven-wobootstrap-plugin:maven-plugin:null for project null:maven-wobootstrap-plugin:maven-plugin:null
6 + [INFO] Error building POM (may not be this project's POM).
7 +
8 +Project ID: null:maven-wobootstrap-plugin:maven-plugin:null
9 +
10 +Reason: Cannot find parent: org.objectstyle.woproject.maven2:maven2 for project: null:maven-wobootstrap-plugin:maven-plugin:null for project null:maven-wobootstrap-plugin:maven-plugin:null