Skip to Content

Changes for page Building WOLips

Last modified by Johann Werner on 2015/02/13 01:40
From version 42.1
edited by Ramsey Gurley
on 2011/04/23 18:18
Change comment: There is no comment for this version
To version 43.1
edited by mark_ritchie
on 2009/09/08 23:55
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.ramsey
1 +XWiki.mark_ritchie
Content
... ... @@ -8,7 +8,7 @@
8 8  
9 9  WOLips is now located in Subversion at ##objectstyle.org##. The CVS repository at sourceforge is now deprecated.
10 10  
11 -The subversion repository path is [[https://svn.objectstyle.org/repos/woproject]]
11 +The subversion repository path is https:~/~/svn.objectstyle.org/repos/woproject
12 12  
13 13  == Prerequisites ==
14 14  
... ... @@ -17,15 +17,15 @@
17 17  1. Help=>Software Updates=>Find and Install ...
18 18  1. Add New Remote Site
19 19  11. Name = Subclipse
20 -11. URL = [[http://subclipse.tigris.org/update_1.0.x]]
20 +11. URL = http:~/~/subclipse.tigris.org/update_1.0.x
21 21  1. Select the site, select all the plugins available, and install them
22 22  
23 23  ==== Install the m2eclipse plugin (Eclipse 3.5 instructions) ====
24 24  
25 -1. Help > Install New Software
26 -1. Click "Add..."
25 +1. Help -> Install New Software
26 +1. Click "Add..."
27 27  11. Name = M2Eclipse
28 -11. Location = [[http://m2eclipse.sonatype.org/update/]]
28 +11. Location = http:~/~/m2eclipse.sonatype.org/update/
29 29  11. Click "OK"
30 30  1. Expand "Maven Integration"
31 31  1. Select "Maven Embedder"
... ... @@ -36,20 +36,21 @@
36 36  == Checking out and Building from the Commandline ==
37 37  
38 38  1. Checkout the ##trunk/woproject## folder from Subversion
39 -##svn co## ##[[https://svn.objectstyle.org/repos/woproject/trunk]]## ##.##
39 +##svn co https:~/~/svn.objectstyle.org/repos/woproject/trunk .##
40 40  1. ##cd woproject##
41 41  1. ##ant##
42 42  1. The first build will fail out telling you that it couldn't find ##wobuild.properties## ~-~- That's OK
43 -1. Edit ##/Library/wobuild.properties##
43 +1. Edit ##,,/Library/wobuild.properties,,##
44 44  1. Add a line: ##eclipse.home=/path/to/your/eclipse##
45 45  1. ant again and it should succeed this time
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.//
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.//
47 47  1. The build went into ##temp/dist##
48 48  1. Profit
49 +1. [[Installing WOLips]]
49 49  
50 50  == Checking out and Building inside of Eclipse for Deployment ==
51 51  
52 -1. Add the wolips SVN repository [[https://svn.objectstyle.org/repos/woproject]] in the SVN Perspective's Repository View
53 +1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View
53 53  1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject##
54 54  1. Right-click (or equiv) on the ##build.xml## inside of the "woproject" project and Run As=>Ant Build ...
55 55  1. Switch to the Properties tab and check for the definition of eclipse.home in the Properties list
... ... @@ -58,10 +58,11 @@
58 58  1. Click Apply to save your changes
59 59  1. Run
60 60  1. Once it is complete, you may need to right-click=>refresh your project and you will have a ##temp/dist## folder with the plugin site in it.
62 +1. [[Installing WOLips]]
61 61  
62 62  == Checking out and Building inside of Eclipse for Development (PDE) ==
63 63  
64 -1. Add the wolips SVN repository [[https://svn.objectstyle.org/repos/woproject]] in the SVN Perspective's Repository View
66 +1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View
65 65  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]].
66 66  
67 67  == An approach to setting up the development and test environment for WOLips Plugin. ==
... ... @@ -74,7 +74,7 @@
74 74  1. In the test environment, follow the [[Installing WOLips]] instructions, using your ##temp/dist## directory as the Local Site. Install the plugins.
75 75  1. Use the Test environment to exercise/test the changes from your locally modified Plugin.
76 76  
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.
79 +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.**
78 78  
79 79  == Building WOLips with Hudson Continuous Build server ==
80 80  
... ... @@ -81,11 +81,11 @@
81 81  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.
82 82  
83 83  1. Add a new job with the following configuration
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)//
86 + Project Name: WOLips
87 + Subversion: http:~/~/svn.objectstyle.org/repos/woproject/trunk/woproject
88 + Local module directory (optional): wolips
89 + Use update: Checked
90 + Poll SCM: 59 * ** * ** //(59 can be replaced with any number between 0 and 59)//
89 89  1. Add the following build tasks to the job
90 90  
91 91  {{code title="Execute Shell"}}
... ... @@ -113,43 +113,7 @@
113 113  
114 114  1. Copy eclipse with the necessary plugins installed to your build server. In this example it has been copied to /usr/local/eclipse
115 115  The currently required plugins for a deployment build are
116 -1*. JProfiler ([[Update Site>>http://webobjects.mdimension.com/jprofiler6/]])
117 -1*. m2Eclipse Maven ([[Update Site>>http://m2eclipse.sonatype.org/sites/m2e]])
118 -1*. JRebel ([[Update Site>>http://www.zeroturnaround.com/update-site/]])
119 119  
120 -== Preparation for building WOLips on Windows operating systems (NT 5.0 and higher) ==
121 -
122 -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.
123 -
124 -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. Set the VMs encoding to MacRoman
126 -1*. Right click on ##build.xml## > Properties > JRE > VM arguments
127 -1**. Dfile.encoding=MacRoman
128 -1. Edit ##woproject/wolips/goodies/plugins/build.xml##
129 -1*. Comment out the subsequent lines (mac goodies)
130 -1**. <ant dir="org.objectstyle.wolips.goodies.core.mac" target="all" />
131 -1**. <ant dir="org.objectstyle.wolips.goodies.ui.mac" target="all" />
132 -1**. <ant dir="org.objectstyle.wolips.goodies.core.mac" target="dist" />
133 -1**. <ant dir="org.objectstyle.wolips.goodies.ui.mac" target="dist" />
134 -1. Edit ##woproject/wolips/features/build.xml##
135 -1*. Comment out the subsequent lines (mac features)
136 -1**. <ant dir="org.objectstyle.wolips.goodies.mac.feature" target="all" />
137 -1**. <ant dir="org.objectstyle.wolips.goodies.mac.feature" target="dist" />
138 -1. Edit ##woproject/wolips/build.xml## (you may skip this one if you've got JProfiler installed)
139 -1*. Comment out the subsequent lines
140 -1**. <ant dir="jprofiler" target="all" />
141 -1**. <ant dir="jprofiler" target="dist" />
142 -1. Run the build
143 -
144 -== Installing from a Local Build ==
145 -
146 -1. If you made changes locally, Eclipse will not automatically install your changed plugins if the version number is the same. You have two options - either uninstall WOLips or cheat and increment the WOLips build version prior to building your local copy. To uninstall WOLips, just delete all org.objectstyle features and plug ins from your eclipse folder. To increment the build server version, open buildserver.version in your projects folder and increment the last number. Note that you will now be "competing" with version numbers from the official build server, so the next official build will not install because you already used the next number, but sometimes it's a quick hack to force an update if you're lazy :-)
147 -1. Assuming you now have your build versions under control, you should follow the instructions for [[Building WOLips]]
148 -1. Launch Eclipse
149 -1. Select the menu: Help->Software Updates.
150 -1. Click on the 'Available Software' tab at the top of the window.
151 -1. Click on the 'Add Site...' button. This will bring up a dialog box.
152 -1. Click on the 'Local...' button on the dialog box.
153 -1. Browse to and select your workspace/projects/temp/dist folder or your woproject/temp/dist folder (depending on whether you checked out in eclipse or command line). Check the box next to it.
154 -1. If you updated the version number in your local copy (instead of uninstalling), you must now click on the 'Installed Software' tab at the top of the window and click on the 'Update...' button.
155 -1. Then continue, and just keep selecting the "Yes"/"OK"/"Approve"/etc buttons
119 +*
120 +** JProfiler
121 +** m2Eclipse Maven