Wiki source code of Building WOLips
Version 68.1 by Quinton Dolan on 2008/06/26 03:37
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
51.1 | 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. |
| |
39.1 | 2 | |
| |
57.1 | 3 | WOLips is now located in Subversion at ##objectstyle.org##. The CVS repository at sourceforge is now deprecated. |
| |
51.1 | 4 | |
| |
58.1 | 5 | The subversion repository path is https:~/~/svn.objectstyle.org/repos/woproject |
| |
57.1 | 6 | |
| |
66.1 | 7 | == Installing Subclipse (the Subversion plugins) == |
| |
51.1 | 8 | |
| |
56.1 | 9 | 1. Help=>Software Updates=>Find and Install ... |
| 10 | 1. Add New Remote Site | ||
| 11 | 11. Name = Subclipse | ||
| |
58.1 | 12 | 11. URL = http:~/~/subclipse.tigris.org/update_1.0.x |
| |
56.1 | 13 | 1. Select the site, select all the plugins available, and install them |
| 14 | |||
| |
39.1 | 15 | == Checking out and Building from the Commandline == |
| 16 | |||
| |
51.1 | 17 | 1. Checkout the ##trunk/woproject## folder from Subversion |
| |
62.1 | 18 | ##svn co https:~/~/svn.objectstyle.org/repos/woproject/trunk .## |
| |
51.1 | 19 | 1. ##cd woproject## |
| 20 | 1. ##ant## | ||
| 21 | 1. The first build will fail out telling you that it couldn't find ##wobuild.properties## ~-~- That's OK | ||
| |
58.1 | 22 | 1. Edit ##,,/Library/wobuild.properties,,## |
| |
51.1 | 23 | 1. Add a line: ##eclipse.home=/path/to/your/eclipse## |
| |
52.1 | 24 | 1. ant again and it should succeed this time |
| |
58.1 | 25 | 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.// |
| |
51.1 | 26 | 1. The build went into ##temp/dist## |
| |
39.1 | 27 | 1. Profit |
| |
60.1 | 28 | 1. [[Installing WOLips]] |
| |
39.1 | 29 | |
| 30 | == Checking out and Building inside of Eclipse for Deployment == | ||
| 31 | |||
| |
58.1 | 32 | 1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View |
| |
57.1 | 33 | 1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject## |
| |
51.1 | 34 | 1. Right-click (or equiv) on the ##build.xml## inside of the "woproject" project and Run As=>Ant Build ... |
| 35 | 1. Switch to the Properties tab and check for the definition of eclipse.home in the Properties list | ||
| 36 | 1. If ##eclipse.home## does not exist, uncheck "Use global properties" and then click "Add Property" | ||
| |
60.1 | 37 | 1. In the Add Property dialog, make the name ##eclipse.home##, click Add Variable, select ##eclipse.home## from the list, and click OK |
| |
51.1 | 38 | 1. Click Apply to save your changes |
| |
39.1 | 39 | 1. Run |
| |
51.1 | 40 | 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. |
| |
60.1 | 41 | 1. [[Installing WOLips]] |
| |
39.1 | 42 | |
| 43 | == Checking out and Building inside of Eclipse for Development (PDE) == | ||
| 44 | |||
| |
58.1 | 45 | 1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View |
| |
51.1 | 46 | 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]]. |
| |
39.1 | 47 | |
| |
51.1 | 48 | == An approach to setting up the development and test environment for WOLips Plugin. == |
| 49 | |||
| 50 | In order to do WOLips Plugin development you will need two eclipse environments: Development and Test. | ||
| 51 | |||
| 52 | 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. | ||
| 53 | 1. the ##temp/dist## folder is your Local Site for the Test Environment. | ||
| 54 | 1. Create a second copy of "clean" Eclipse under /Users/<me>/Developer/eclipse (this could be any where). This will be your Test Environment. | ||
| 55 | 1. In the test environment, follow the [[Installing WOLips]] instructions, using your ##temp/dist## directory as the Local Site. Install the plugins. | ||
| 56 | 1. Use the Test environment to exercise/test the changes from your locally modified Plugin. | ||
| 57 | |||
| |
60.1 | 58 | 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.** |
| |
62.1 | 59 | |
| 60 | == Building WOLips with Hudson Continuous Build server == | ||
| 61 | |||
| 62 | 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. | ||
| 63 | |||
| 64 | 1. Add a new job with the following configuration | ||
| 65 | Project Name: WOLips | ||
| 66 | Subversion: http:~/~/svn.objectstyle.org/repos/woproject/trunk/woproject | ||
| 67 | Local module directory (optional): wolips | ||
| 68 | Use update: Checked | ||
| |
68.1 | 69 | Poll SCM: 59 * ** * ** //(59 can be any number between 1 and 59)// |
| |
62.1 | 70 | 1. Add the following build tasks to the job |
| 71 | |||
| 72 | {{code title="Execute Shell"}} | ||
| 73 | |||
| 74 | echo build.version=3.4.${SVN_REVISION} > wolips/build.properties | ||
| 75 | echo eclipse.home=/usr/local/eclipse >> wolips/build.properties | ||
| 76 | echo user.home=${WORKSPACE} >> wolips/build.properties | ||
| 77 | |||
| 78 | {{/code}} | ||
| 79 | |||
| 80 | {{code title="Invoke Ant"}} | ||
| 81 | |||
| 82 | Targets: dist | ||
| 83 | |||
| 84 | {{/code}} | ||
| 85 | |||
| 86 | 1. Copy eclipse with the necessary plugins installed to your build server. In this example it has been copied to /usr/local/eclipse | ||
| 87 | The currently required plugins for a deployment build are | ||
| 88 | |||
| 89 | * | ||
| 90 | ** JProfiler | ||
| 91 | ** m2Eclipse Maven |