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