Wiki source code of Building WOLips
Version 60.1 by pyu on 2006/10/08 07:22
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Prior to building WOLips, you will want to get your dependencies installed properly. Check out the [[Installing WOLips]] page for information on the dependencies for WOLips. | ||
| 2 | |||
| 3 | WOLips is now located in Subversion at ##objectstyle.org##. The CVS repository at sourceforge is now deprecated. | ||
| 4 | |||
| 5 | The subversion repository path is https:~/~/svn.objectstyle.org/repos/woproject | ||
| 6 | |||
| 7 | == Installing Subclipse (the Subversion plugins) == | ||
| 8 | |||
| 9 | 1. Help=>Software Updates=>Find and Install ... | ||
| 10 | 1. Add New Remote Site | ||
| 11 | 11. Name = Subclipse | ||
| 12 | 11. URL = http:~/~/subclipse.tigris.org/update_1.0.x | ||
| 13 | 1. Select the site, select all the plugins available, and install them | ||
| 14 | |||
| 15 | == Checking out and Building from the Commandline == | ||
| 16 | |||
| 17 | 1. Checkout the ##trunk/woproject## folder from Subversion | ||
| 18 | 1. ##cd woproject## | ||
| 19 | 1. ##ant## | ||
| 20 | 1. The first build will fail out telling you that it couldn't find ##wobuild.properties## ~-~- That's OK | ||
| 21 | 1. Edit ##,,/Library/wobuild.properties,,## | ||
| 22 | 1. Add a line: ##eclipse.home=/path/to/your/eclipse## | ||
| 23 | 1. ant again and it should succeed this time | ||
| 24 | 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.// | ||
| 25 | 1. The build went into ##temp/dist## | ||
| 26 | 1. Profit | ||
| 27 | 1. [[Installing WOLips]] | ||
| 28 | |||
| 29 | == Checking out and Building inside of Eclipse for Deployment == | ||
| 30 | |||
| 31 | 1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View | ||
| 32 | 1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject## | ||
| 33 | 1. Right-click (or equiv) on the ##build.xml## inside of the "woproject" project and Run As=>Ant Build ... | ||
| 34 | 1. Switch to the Properties tab and check for the definition of eclipse.home in the Properties list | ||
| 35 | 1. If ##eclipse.home## does not exist, uncheck "Use global properties" and then click "Add Property" | ||
| 36 | 1. In the Add Property dialog, make the name ##eclipse.home##, click Add Variable, select ##eclipse.home## from the list, and click OK | ||
| 37 | 1. Click Apply to save your changes | ||
| 38 | 1. Run | ||
| 39 | 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. | ||
| 40 | 1. [[Installing WOLips]] | ||
| 41 | |||
| 42 | == Checking out and Building inside of Eclipse for Development (PDE) == | ||
| 43 | |||
| 44 | 1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View | ||
| 45 | 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]]. | ||
| 46 | |||
| 47 | == An approach to setting up the development and test environment for WOLips Plugin. == | ||
| 48 | |||
| 49 | In order to do WOLips Plugin development you will need two eclipse environments: Development and Test. | ||
| 50 | |||
| 51 | 1. Follow the Checking out and Building inside of Eclipse for Deployment in you primary Eclipse installation (i.e. /Application/eclipse) and workspace. This will be you development environment. | ||
| 52 | 1. the ##temp/dist## folder is your Local Site for the Test Environment. | ||
| 53 | 1. Create a second copy of "clean" Eclipse under /Users/<me>/Developer/eclipse (this could be any where). This will be your Test Environment. | ||
| 54 | 1. In the test environment, follow the [[Installing WOLips]] instructions, using your ##temp/dist## directory as the Local Site. Install the plugins. | ||
| 55 | 1. Use the Test environment to exercise/test the changes from your locally modified Plugin. | ||
| 56 | |||
| 57 | 1. When you need to repeat the process, shut down the Test Environment, delete the 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.** |