Changes for page Building WOLips

Summary

• Page properties (2 modified, 0 added, 0 removed)

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.mschrag
	1	+XWiki.mark_ritchie

Content

...	...	@@ -1,121 +1,115 @@
1		-== WOLips Dependencies ==
	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	2
3		-Recent version of WOLips in CVS have more extensive dependencies than before. Before building or installing WOLips, you will need to download and install the following plugins and features:
	3	+WOLips is now located in Subversion at ##objectstyle.org##. The CVS repository at sourceforge is now deprecated.
4	4
5		-1. [[EMF>>http://eclipse.org/downloads/download.php?file=/tools/emf/downloads/drops/2.1.0/R200507070200/emf-sdo-xsd-SDK-2.1.0.zip]]
6		-1. [[GEF>>http://www.eclipse.org/downloads/download.php?file=/tools/gef/downloads/drops/R-3.1-200507071758/GEF-SDK-3.1.zip]]
7		-1. [[JEM>>http://www.eclipse.org/downloads/download.php?file=/tools/ve/downloads/drops/R-1.1-200507221721/JEM-SDK-1.1.zip]]
8		-1. [[WTP>>http://www.eclipse.org/downloads/download.php?file=/webtools/downloads/drops/R-0.7-200507290654/wtp-sdk-0.7.zip]]
	5	+The subversion repository path is https:~/~/svn.objectstyle.org/repos/woproject
9	9
	7	+== Prerequisites ==
	8	+
	9	+==== 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 Embedder"
	26	+1. Select "Maven Integration for Eclipse"
	27	+1. Click "Next>"
	28	+1. Click "Finish"
	29	+
10	10	== Checking out and Building from the Commandline ==
11	11
12		-1. cvs --d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/woproject login--
13		-11. username = anonymous
14		-11. no password
15		-1. cvs --d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/woproject co woproject--
16		-1. cd woproject/projects
17		-1. ant
18		-1. The first build will fail out telling you that it couldn't find wobuild.properties ~-~- That's OK
19		-1. Edit ,,/Library/wobuild.properties,,
20		-1. Add a line eclipse.home=/path/to/your/eclipse
	32	+1. Checkout the ##trunk/woproject## folder from Subversion
	33	+##svn co https:~/~/svn.objectstyle.org/repos/woproject/trunk .##
	34	+1. ##cd woproject##
	35	+1. ##ant##
	36	+1. The first build will fail out telling you that it couldn't find ##wobuild.properties## ~-~- That's OK
	37	+1. Edit ##,,/Library/wobuild.properties,,##
	38	+1. Add a line: ##eclipse.home=/path/to/your/eclipse##
21	21	1. ant again and it should succeed this time
22		-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.//
23		-1. The build went into temp/dist
	40	+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.//
	41	+1. The build went into ##temp/dist##
24	24	1. Profit
25	25	1. [[Installing WOLips]]
26	26
27	27	== Checking out and Building inside of Eclipse for Deployment ==
28	28
29		-1. install jmechanic plugin from [[The JMechanic Site>>http://sourceforge.net/project/showfiles.php?group_id=68316&release_id=136699]]
30		-11. just untar this into your plugins folder
31		-1. Add the wolips CVS repository
32		-11. host = cvs.sourceforge.net
33		-11. root = /cvsroot/woproject
34		-11. protocol = pserver
35		-11. login = anonymous
36		-11. no password
37		-1. In CVS perspective, browse WOLips repository on HEAD, checkout woproject/projects as "projects"
38		-1. Right-click (or equiv) on the build.xml inside of the "projects" project and Run As=>Ant Build ...
39		-1. Switch to the Classpath tab and "Add Jar"
40		-1. Browse to projects/lib and select jdom-b8.jar
41		-1. Make sure the target is the default ("dist")
	47	+1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View
	48	+1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject##
	49	+1. Right-click (or equiv) on the ##build.xml## inside of the "woproject" project and Run As=>Ant Build ...
	50	+1. Switch to the Properties tab and check for the definition of eclipse.home in the Properties list
	51	+1. If ##eclipse.home## does not exist, uncheck "Use global properties" and then click "Add Property"
	52	+1. In the Add Property dialog, make the name ##eclipse.home##, click Add Variable, select ##eclipse.home## from the list, and click OK
	53	+1. Click Apply to save your changes
42	42	1. Run
43		-1. Once it is complete, you will have to right-click=>refresh the "projects" project and you will have a temp/dist folders with the plugin site in it.
	55	+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.
44	44	1. [[Installing WOLips]]
45	45
46	46	== Checking out and Building inside of Eclipse for Development (PDE) ==
47	47
48		-1. install jmechanic plugin from [[The JMechanic Site>>http://sourceforge.net/project/showfiles.php?group_id=68316&release_id=136699]]
49		-11. just untar this into your plugins folder
50		-1. Add the wolips CVS repository
51		-11. host = cvs.sourceforge.net
52		-11. root = /cvsroot/woproject
53		-11. protocol = pserver
54		-11. login = anonymous
55		-11. no password
56		-1. From the Java perspective, Import=>Team Project Set and select wolips.psf (see below)
57		-1. This will cause a really long checkout and you'll have a TON of build errors ... Don't fret.
58		-1. Copy ##projects/lib/cayenne-1.1RC3-dev.jar## to ##org.objectstyle.wolips.cayenne/lib/cayenne.jar## and refresh the org.objectstyle.wolips.cayenne project
59		-1. Add a classpath variable ANT//HOME that points to ##eclipse/plugins/org.apache.ant##//##1.6.5## (Preferences=>Java=>Build Path=>Classpath Variables, New... name ANT//HOME, Folder... =>youreclipsehome/plugins/org.apache.ant//1.6.5)
60		-1. make ##projects/temp##, ##projects/temp/classes##, and ##projects/temp/doc## folders
61		-1. run ##projects/build.xml## as "Ant Build ...", select the "woenvironment" and "woproject" targets and select Order... and move woenvironment above woproject in the order, Build
62		-1. copy ##projects/temp/build/woproject//$build.version/lib/woproject.jar//##// to ##org.objectstyle.wolips.woproject/lib## and refresh the org.objectstyle.wolips.woproject//
	60	+1. Add the wolips SVN repository https:~/~/svn.objectstyle.org/repos/woproject in the SVN Perspective's Repository View
	61	+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]].
63	63
64		-You should end up with no source or build path errors.
	63	+== An approach to setting up the development and test environment for WOLips Plugin. ==
65	65
66		-Note that there are 16 plugin.xml and feature.xml syntax errors. 14 of them are due to a malformed DTD from the Eclipse Team plugin.
	65	+In order to do WOLips Plugin development you will need two eclipse environments: Development and Test.
67	67
68		-=== wolips.psf ===
	67	+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.
	68	+1. the ##temp/dist## folder is your Local Site for the Test Environment.
	69	+1. Create a second copy of "clean" Eclipse under /Users/<me>/Developer/eclipse (this could be any where). This will be your Test Environment.
	70	+1. In the test environment, follow the [[Installing WOLips]] instructions, using your ##temp/dist## directory as the Local Site. Install the plugins.
	71	+1. Use the Test environment to exercise/test the changes from your locally modified Plugin.
69	69
70		-Save the following into wolips.psf:
	73	+1. When you need to repeat the process, shut down the Test Environment, delete the org.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.**
71	71
72		-{{code value="xml"}}
	75	+== Building WOLips with Hudson Continuous Build server ==
73	73
74		-<?xml version="1.0" encoding="UTF-8"?>
75		-<psf version="2.0">
76		- <provider id="org.eclipse.team.cvs.core.cvsnature">
77		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects,projects"/>
78		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/features/org.objectstyle.wolips.wounit.feature,org.objectstyle.wolips.wounit.feature"/>
79		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.wounit,org.objectstyle.wolips.wounit"/>
80		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.workbenchutilities,org.objectstyle.wolips.workbenchutilities"/>
81		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.woproject.ant,org.objectstyle.wolips.woproject.ant"/>
82		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.woproject,org.objectstyle.wolips.woproject"/>
83		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.wizards,org.objectstyle.wolips.wizards"/>
84		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.variables,org.objectstyle.wolips.variables"/>
85		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.ui,org.objectstyle.wolips.ui"/>
86		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/features/org.objectstyle.wolips.tests.feature,org.objectstyle.wolips.tests.feature"/>
87		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.tests.core,org.objectstyle.wolips.tests.core"/>
88		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.tests,org.objectstyle.wolips.tests"/>
89		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.templateengine,org.objectstyle.wolips.templateengine"/>
90		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.team,org.objectstyle.wolips.team"/>
91		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.targetbuilder,org.objectstyle.wolips.targetbuilder"/>
92		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.source,org.objectstyle.wolips.source"/>
93		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.refactoring,org.objectstyle.wolips.refactoring"/>
94		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.projectbuild,org.objectstyle.wolips.projectbuild"/>
95		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/features/org.objectstyle.wolips.profiling.feature,org.objectstyle.wolips.profiling.feature"/>
96		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.profiling,org.objectstyle.wolips.profiling"/>
97		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.preferences,org.objectstyle.wolips.preferences"/>
98		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.playground.ui,org.objectstyle.wolips.playground.ui"/>
99		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.launching,org.objectstyle.wolips.launching"/>
100		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.jdt,org.objectstyle.wolips.jdt"/>
101		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.jdom,org.objectstyle.wolips.jdom"/>
102		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.goodies.ui.mac,org.objectstyle.wolips.goodies.ui.mac"/>
103		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/features/org.objectstyle.wolips.goodies.mac.feature,org.objectstyle.wolips.goodies.mac.feature"/>
104		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.goodies.core.mac,org.objectstyle.wolips.goodies.core.mac"/>
105		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/features/org.objectstyle.wolips.feature,org.objectstyle.wolips.feature"/>
106		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.documentation,org.objectstyle.wolips.documentation"/>
107		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.doctor.ui,org.objectstyle.wolips.doctor.ui"/>
108		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.doctor.core,org.objectstyle.wolips.doctor.core"/>
109		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/features/org.objectstyle.wolips.devstudio.feature,org.objectstyle.wolips.devstudio.feature"/>
110		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.devstudio,org.objectstyle.wolips.devstudio"/>
111		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.datasets,org.objectstyle.wolips.datasets"/>
112		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.commons,org.objectstyle.wolips.commons"/>
113		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.cayenne.ant,org.objectstyle.wolips.cayenne.ant"/>
114		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.cayenne,org.objectstyle.wolips.cayenne"/>
115		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.ant,org.objectstyle.wolips.ant"/>
116		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips.wodclipse,org.objectstyle.wolips.wodclipse"/>
117		- <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/woproject,woproject/projects/wolips/plugins/org.objectstyle.wolips,org.objectstyle.wolips"/>
118		- </provider>
119		-</psf>
	77	+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.
120	120
	79	+1. Add a new job with the following configuration
	80	+ Project Name: WOLips
	81	+ Subversion: http:~/~/svn.objectstyle.org/repos/woproject/trunk/woproject
	82	+ Local module directory (optional): wolips
	83	+ Use update: Checked
	84	+ Poll SCM: 59 * ** * ** //(59 can be replaced with any number between 0 and 59)//
	85	+1. Add the following build tasks to the job
	86	+
	87	+{{code title="Execute Shell"}}
	88	+
	89	+echo build.version=3.4.${SVN_REVISION} > wolips/build.properties
	90	+echo eclipse.home=/usr/local/eclipse >> wolips/build.properties
	91	+echo user.home=${WORKSPACE} >> wolips/build.properties
	92	+
121	121	{{/code}}
	94	+
	95	+{{code title="Invoke Ant"}}
	96	+
	97	+Targets: dist
	98	+
	99	+{{/code}}
	100	+
	101	+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
	102	+
	103	+{{code title="Execute Shell"}}
	104	+
	105	+rm -fr /usr/local/www/apache22/data/wolips/*
	106	+/bin/cp -prv ${WORKSPACE}/wolips/temp/dist/ /usr/local/www/apache22/data/wolips/
	107	+
	108	+{{/code}}
	109	+
	110	+1. Copy eclipse with the necessary plugins installed to your build server. In this example it has been copied to /usr/local/eclipse
	111	+The currently required plugins for a deployment build are
	112	+
	113	+*
	114	+** JProfiler
	115	+** m2Eclipse Maven