Skip to Content

Changes for page Building WOLips

Last modified by Johann Werner on 2015/02/13 01:40
From version 57.1
edited by wessman
on 2011/06/23 19:25
Change comment: Updated WOLips 3.6 update site to the new, valid location
To version 58.1
edited by Pascal Robert
on 2010/10/03 00:40
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.wessman
1 +XWiki.probert
Content
... ... @@ -1,9 +7,3 @@
1 -{{tip title="Not Required!"}}
2 -
3 -You do not have to build WOLips to use it. It is easily available via Eclipse's Software Update functionality. The update site is: [http://webobjects.mdimension.com/hudson/job/WOLips36Stable/lastSuccessfulBuild/artifact/site/]
4 -
5 -{{/tip}}
6 -
7 7  {{note}}
8 8  
9 9  The following instructions about building WOLips are fine if you need to build a distribution of WOLips. However, they aren't so great if you're debugging WOLips. Instructions on how to do that are posted here [Debugging WOLips].
... ... @@ -14,7 +14,7 @@
14 14  
15 15  WOLips is now located in Subversion at ##objectstyle.org##. The CVS repository at sourceforge is now deprecated.
16 16  
17 -The subversion repository path is [[https://svn.objectstyle.org/repos/woproject]]
11 +The subversion repository path is https:~/~/svn.objectstyle.org/repos/woproject
18 18  
19 19  == Prerequisites ==
20 20  
... ... @@ -23,15 +23,15 @@
23 23  1. Help=>Software Updates=>Find and Install ...
24 24  1. Add New Remote Site
25 25  11. Name = Subclipse
26 -11. URL = [[http://subclipse.tigris.org/update_1.0.x]]
20 +11. URL = http:~/~/subclipse.tigris.org/update_1.0.x
27 27  1. Select the site, select all the plugins available, and install them
28 28  
29 29  ==== Install the m2eclipse plugin (Eclipse 3.5 instructions) ====
30 30  
31 -1. Help > Install New Software
32 -1. Click "Add..."
25 +1. Help -> Install New Software
26 +1. Click "Add..."
33 33  11. Name = M2Eclipse
34 -11. Location = [[http://m2eclipse.sonatype.org/update/]]
28 +11. Location = http:~/~/m2eclipse.sonatype.org/update/
35 35  11. Click "OK"
36 36  1. Expand "Maven Integration"
37 37  1. Select "Maven Embedder"
... ... @@ -42,20 +42,20 @@
42 42  == Checking out and Building from the Commandline ==
43 43  
44 44  1. Checkout the ##trunk/woproject## folder from Subversion
45 -##svn co## ##[[https://svn.objectstyle.org/repos/woproject/trunk]]## ##.##
39 +##svn co https:~/~/svn.objectstyle.org/repos/woproject/trunk .##
46 46  1. ##cd woproject##
47 47  1. ##ant##
48 48  1. The first build will fail out telling you that it couldn't find ##wobuild.properties## ~-~- That's OK
49 -1. Edit ##/Library/wobuild.properties##
43 +1. Edit ##,,/Library/wobuild.properties,,##
50 50  1. Add a line: ##eclipse.home=/path/to/your/eclipse##
51 51  1. ant again and it should succeed this time
52 -11. If you get the error ##'build.xml:73: taskdef A class needed by class org.apache.velocity.anakia.AnakiaTask cannot be found: org/jdom/JDOMException'##, you can do one of two things. You can build with ##Dno.docs=true## to skip the javadoc step, or (untested) you can drop ##jdom-b8.jar## from ##woproject/projects/lib## into your ##ANT//HOME/lib//##// folder.//
46 +11. If you get the error ##'build.xml:73: taskdef A class needed by class org.apache.velocity.anakia.AnakiaTask cannot be found: org/jdom/JDOMException'##, you can do one of two things. You can build with ##-Dno.docs=true## to skip the javadoc step, or (untested) you can drop ##jdom-b8.jar## from ##woproject/projects/lib## into your ##ANT//HOME/lib//##// folder.//
53 53  1. The build went into ##temp/dist##
54 54  1. Profit
55 55  
56 56  == Checking out and Building inside of Eclipse for Deployment ==
57 57  
58 -1. Add the wolips SVN repository [[https://svn.objectstyle.org/repos/woproject]] in the SVN Perspective's Repository View
52 +1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View
59 59  1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject##
60 60  1. Right-click (or equiv) on the ##build.xml## inside of the "woproject" project and Run As=>Ant Build ...
61 61  1. Switch to the Properties tab and check for the definition of eclipse.home in the Properties list
... ... @@ -67,7 +67,7 @@
67 67  
68 68  == Checking out and Building inside of Eclipse for Development (PDE) ==
69 69  
70 -1. Add the wolips SVN repository [[https://svn.objectstyle.org/repos/woproject]] in the SVN Perspective's Repository View
64 +1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View
71 71  1. You can select individual plugins you would like to work on by browsing to ##trunk/woproject/wolips/## in the Subversion repository and checking out the plugins you are interested in. To checkout complete sets of plugins, you could also use the [[Eclipse Team Project Set]].
72 72  
73 73  == An approach to setting up the development and test environment for WOLips Plugin. ==
... ... @@ -80,7 +80,7 @@
80 80  1. In the test environment, follow the [[Installing WOLips]] instructions, using your ##temp/dist## directory as the Local Site. Install the plugins.
81 81  1. Use the Test environment to exercise/test the changes from your locally modified Plugin.
82 82  
83 -1. When you need to repeat the process, shut down the Test Environment, delete the org.objectstyle. files in the features and plugins directories under the /Users/<me>/Developer/eclipse directory. Change the source code in the primary environment and build. (Each build took 3 min 37 seconds on my Mac Book Pro 17"). Once the build is done, then reinstall the plugin in the Test Environment. The Local Site should still be selected.
77 +1. When you need to repeat the process, shut down the Test Environment, delete the org.objectstyle.** files in the features and plugins directories under the /Users/<me>/Developer/eclipse directory. Change the source code in the primary environment and build. (Each build took 3 min 37+ seconds on my Mac Book Pro 17"). Once the build is done, then reinstall the plugin in the Test Environment. The Local Site should still be selected.**
84 84  
85 85  == Building WOLips with Hudson Continuous Build server ==
86 86  
... ... @@ -87,11 +87,11 @@
87 87  Hudson is a Java base continuous build server that allows you to build and test your project automatically. It can be easily configured to build WOLips in a few simple steps.
88 88  
89 89  1. Add a new job with the following configuration
90 -Project Name: WOLips
91 -Subversion: [[http://svn.objectstyle.org/repos/woproject/trunk/woproject]]
92 -Local module directory (optional): wolips
93 -Use update: Checked
94 -Poll SCM: 59 * ** * ** //(59 can be replaced with any number between 0 and 59)//
84 + Project Name: WOLips
85 + Subversion: http:~/~/svn.objectstyle.org/repos/woproject/trunk/woproject
86 + Local module directory (optional): wolips
87 + Use update: Checked
88 + Poll SCM: 59 * ** * ** //(59 can be replaced with any number between 0 and 59)//
95 95  1. Add the following build tasks to the job
96 96  
97 97  {{code title="Execute Shell"}}
... ... @@ -119,32 +119,45 @@
119 119  
120 120  1. Copy eclipse with the necessary plugins installed to your build server. In this example it has been copied to /usr/local/eclipse
121 121  The currently required plugins for a deployment build are
122 -1*. JProfiler ([[Update Site>>http://webobjects.mdimension.com/jprofiler6/]])
123 -1*. m2Eclipse Maven ([[Update Site>>http://m2eclipse.sonatype.org/sites/m2e]])
124 -1*. JRebel ([[Update Site>>http://www.zeroturnaround.com/update-site/]])
125 125  
117 +*
118 +** JProfiler
119 +** m2Eclipse Maven
120 +
126 126  == Preparation for building WOLips on Windows operating systems (NT 5.0 and higher) ==
127 127  
128 128  For building WOLips on Windows operating systems, some minor changes have to be made. Instead of following and solving the build errors, you may follow the steps described below.
129 129  
130 -1. Install the [[BuildingWOLips-Prerequisites>>||anchor="BuildingWOLips-Prerequisites"]]. Do also follow the [[BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment>>||anchor="BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment"]] section, but don't run the build until the changes described below have been made.
125 +1. Install the [[||anchor="BuildingWOLips-Prerequisites"]]. Do also follow the [[||anchor="BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment"]] section, but don't run the build until the changes described below have been made.
131 131  1. Set the VMs encoding to MacRoman
132 -1*. Right click on ##build.xml## > Properties > JRE > VM arguments
133 -1**. Dfile.encoding=MacRoman
127 +
128 +*
129 +** Right click on ##build.xml## -> Properties -> JRE -> VM arguments
130 +*** --Dfile.encoding=MacRoman--
131 +
134 134  1. Edit ##woproject/wolips/goodies/plugins/build.xml##
135 -1*. Comment out the subsequent lines (mac goodies)
136 -1**. <ant dir="org.objectstyle.wolips.goodies.core.mac" target="all" />
137 -1**. <ant dir="org.objectstyle.wolips.goodies.ui.mac" target="all" />
138 -1**. <ant dir="org.objectstyle.wolips.goodies.core.mac" target="dist" />
139 -1**. <ant dir="org.objectstyle.wolips.goodies.ui.mac" target="dist" />
133 +
134 +*
135 +** Comment out the subsequent lines (mac goodies)
136 +*** <ant dir="org.objectstyle.wolips.goodies.core.mac" target="all" />
137 +*** <ant dir="org.objectstyle.wolips.goodies.ui.mac" target="all" />
138 +*** <ant dir="org.objectstyle.wolips.goodies.core.mac" target="dist" />
139 +*** <ant dir="org.objectstyle.wolips.goodies.ui.mac" target="dist" />
140 +
140 140  1. Edit ##woproject/wolips/features/build.xml##
141 -1*. Comment out the subsequent lines (mac features)
142 -1**. <ant dir="org.objectstyle.wolips.goodies.mac.feature" target="all" />
143 -1**. <ant dir="org.objectstyle.wolips.goodies.mac.feature" target="dist" />
142 +
143 +*
144 +** Comment out the subsequent lines (mac features)
145 +*** <ant dir="org.objectstyle.wolips.goodies.mac.feature" target="all" />
146 +*** <ant dir="org.objectstyle.wolips.goodies.mac.feature" target="dist" />
147 +
144 144  1. Edit ##woproject/wolips/build.xml## (you may skip this one if you've got JProfiler installed)
145 -1*. Comment out the subsequent lines
146 -1**. <ant dir="jprofiler" target="all" />
147 -1**. <ant dir="jprofiler" target="dist" />
149 +
150 +*
151 +** Comment out the subsequent lines
152 +*** <ant dir="jprofiler" target="all" />
153 +*** <ant dir="jprofiler" target="dist" />
154 +
148 148  1. Run the build
149 149  
150 150  == Installing from a Local Build ==