Building WOLips

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

##svn co https:~/~/svn.objectstyle.org/repos/woproject/trunk .##

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

22

1. Edit ##,,/Library/wobuild.properties,,##

23

1. Add a line: ##eclipse.home=/path/to/your/eclipse##

24

1. ant again and it should succeed this time

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.//

26

1. The build went into ##temp/dist##

27

1. Profit

28

1. [[Installing WOLips]]

29

30

== Checking out and Building inside of Eclipse for Deployment ==

31

32

1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View

33

1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject##

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"

37

1. In the Add Property dialog, make the name ##eclipse.home##, click Add Variable, select ##eclipse.home## from the list, and click OK

38

1. Click Apply to save your changes

39

1. Run

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.

41

1. [[Installing WOLips]]

42

43

== Checking out and Building inside of Eclipse for Development (PDE) ==

44

45

1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View

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]].

47

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

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.**

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

69