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

== Prerequisites ==

==== Install Subclipse (the Subversion plugins) ====

10

11

1. Help=>Software Updates=>Find and Install ...

12

1. Add New Remote Site

13

11. Name = Subclipse

14

11. URL = http:~/~/subclipse.tigris.org/update_1.0.x

15

1. Select the site, select all the plugins available, and install them

16

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"

1. Click "Next>"

1. Click "Finish"

== Checking out and Building from the Commandline ==

30

31

1. Checkout the ##trunk/woproject## folder from Subversion

32

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

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

36

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

37

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

38

1. ant again and it should succeed this time

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

40

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

41

1. Profit

42

1. [[Installing WOLips]]

43

44

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

45

46

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

47

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

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"

51

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

52

1. Click Apply to save your changes

53

1. Run

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.

55

1. [[Installing WOLips]]

56

57

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

58

59

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

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

61

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

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

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