Changes for page Building WOLips

Summary

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

Details

Page properties

Author

...	...	@@ -1,1 +1,1 @@
1		-XWiki.probert
	1	+XWiki.kiddyr

Content

...	...	@@ -26,6 +26,7 @@
26	26	1. Select "Maven Integration for Eclipse"
27	27	1. Click "Next>"
28	28	1. Click "Finish"
	29	+(//What is the m2eclipse plugin a prerequisite for? Nothing below refers to it....//)
29	29
30	30	== Checking out and Building from the Commandline ==
31	31
...	...	@@ -36,11 +36,40 @@
36	36	1. The first build will fail out telling you that it couldn't find {{code language="none"}}wobuild.properties{{/code}} – That's OK
37	37	1. Edit {{code language="none"}}~/Library/wobuild.properties{{/code}}
38	38	1. Add a line: {{code language="none"}}eclipse.home=/path/to/your/eclipse{{/code}}
39		-1. Call ant with the build.version argument:
40		-11. {{code}}ant -Dbuild.version=3.7.SomeNumber{{/code}}If you get the error {{code language="none"}}'build.xml:73: taskdef A class needed by class org.apache.velocity.anakia.AnakiaTask cannot be found: org/jdom/JDOMException'{{/code}}, you can do one of two things. You can build with {{code language="none"}}-Dno.docs=true{{/code}} to skip the javadoc step, or (untested) you can drop {{code language="none"}}jdom-b8.jar{{/code}} from {{code language="none"}}woproject/projects/lib{{/code}} into your {{code language="none"}}ANT_HOME/lib{{/code}} folder.
	40	+1. (((
	41	+Call ant with the build.version argument:
	42	+
	43	+{{code}}
	44	+ant -Dbuild.version=x.y.z
	45	+{{/code}}
	46	+
	47	+1. If you get the error
	48	+
	49	+{{code language="none"}}
	50	+'build.xml:73: taskdef A class needed by class org.apache.velocity.anakia.AnakiaTask cannot be found: org/jdom/JDOMException'
	51	+{{/code}}, you can do one of two things. You can build with
	52	+
	53	+{{code language="none"}}
	54	+-Dno.docs=true
	55	+{{/code}} to skip the javadoc step, or (untested) you can drop
	56	+
	57	+{{code language="none"}}
	58	+jdom-b8.jar
	59	+{{/code}} from
	60	+
	61	+{{code language="none"}}
	62	+woproject/projects/lib
	63	+{{/code}} into your
	64	+
	65	+{{code language="none"}}
	66	+ANT_HOME/lib
	67	+{{/code}} folder.
	68	+)))
41	41	1. The build went into {{code language="none"}}temp/dist{{/code}}
42	42	1. Profit
43	43
	72	+(Successfully built on Ubuntu 14.04 LTS with eclipse 4.4.1, using "ant -Dbuild.version=4.4.1" as the build command. - 2015/03/12 - ray@ganymede.org with an OMG thanks to stefan.klein@buero-sde.de.)
	73	+
44	44	== Checking out and Building inside of Eclipse for Deployment ==
45	45
46	46	1. Add the wolips Git repository [[https:~~/~~/github.com/wolips/wolips/>>url:https://github.com/wolips/wolips/||shape="rect"]] in the Git Perspective's Repository View
...	...	@@ -77,32 +77,41 @@
77	77	1. Copy the necessary plugins from your machine to the Eclipse installation on the server. In this example it has been copied to /usr/local/eclipse
78	78	The currently required plugins for a deployment build are
79	79	~* JProfiler (Update Site: [[http:~~/~~/wocommunity.org/documents/tools/jprofiler6/>>url:http://wocommunity.org/documents/tools/jprofiler6/||shape="rect"]])
80		- ~* JRebel (Update Site : [[http:~~/~~/www.zeroturnaround.com/update-site/>>url:http://www.zeroturnaround.com/update-site/||shape="rect"]])
	110	+ ~* JRebel (Update Site : [[http:~~/~~/www.zeroturnaround.com/update-site/>>url:http://www.zeroturnaround.com/update-site/||shape="rect"]])
81	81	1. Create a new job in Jenkins to build WOLips. You can use the [[following sample config>>url:https://github.com/wocommunity/JenkinsJobs/tree/master/WOLips||shape="rect"]] or you can add a new job with the following configuration:
82	82	11. Project Name: WOLips
83	83	11. Git Repositories: git:~/~/github.com/wolips/wolips.git
84	84	11. Use update: Checked
85	85	11. Poll SCM: 59 * * * * //(59 can be replaced with any number between 0 and 59)//
86		-1. Add the following build tasks to the job {{code title="Execute Shell"}}
	116	+1. (((
	117	+Add the following build tasks to the job
	118	+
	119	+{{code title="Execute Shell"}}
87	87	echo build.version=3.7.${BUILD_NUMBER} > build.properties
88	88	echo eclipse.home=/usr/local/eclipse >> build.properties
89	89	echo user.home=${WORKSPACE} >> build.properties
90		-{{/code}} {{code title="Invoke Ant"}}
	123	+
	124	+{{/code}}
	125	+
	126	+{{code title="Invoke Ant"}}
91	91	Targets: dist
92		-{{/code}} 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
93	93
94		-{{code title="Execute Shell"}}
	129	+{{/code}}
95	95
	131	+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
	132	+
	133	+{{code title="Execute Shell"}}
96	96	rm -fr /usr/local/www/apache22/data/wolips/*
97	97	/bin/cp -prv ${WORKSPACE}/wolips/temp/dist/ /usr/local/www/apache22/data/wolips/
98	98
99	99	{{/code}}
	138	+)))
100	100
101	101	== Preparation for building WOLips on Windows operating systems (NT 5.0 and higher) ==
102	102
103	103	For building WOLips on Windows operating systems, some minor changes have to be made. Instead of following and solving the build errors, you may follow the steps described below.
104	104
105		-1. Install the [[BuildingWOLips-Prerequisites>>doc:||anchor="BuildingWOLips-Prerequisites"]]. Do also follow the [[BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment>>doc:||anchor="BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment"]] section, but don't run the build until the changes described below have been made.
	144	+1. Install the [[BuildingWOLips-Prerequisites>>doc:||anchor="BuildingWOLips-Prerequisites"]]. Do also follow the [[BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment>>doc:||anchor="BuildingWOLips-CheckingoutandBuildinginsideofEclipseforDeployment"]]section, but don't run the build until the changes described below have been made.
106	106	1. Set the VMs encoding to MacRoman
107	107	1*. Right click on {{code language="none"}}build.xml{{/code}} -> Properties -> JRE -> VM arguments
108	108	1**. -Dfile.encoding=MacRoman