Skip to Content

Changes for page Building WOLips

Last modified by Johann Werner on 2015/02/13 01:40
From version 131.2
edited by Bastian Triller
on 2023/11/13 11:55
Change comment: Updated the relative links.
To version 128.1
edited by Pascal Robert
on 2012/02/11 08:50
Change comment: There is no comment for this version

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,0 @@
1 -Home
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.btriller
1 +XWiki.probert
Tags
... ... @@ -1,1 +1,0 @@
1 -wikitodo|favourite
Content
... ... @@ -3,16 +3,16 @@
3 3  {{/tip}}
4 4  
5 5  {{note}}
6 -The following instructions about building WOLips are fine if you need to build a distribution of WOLips. However, they aren't so great if you're debugging WOLips. Instructions on how to do that are posted here [[doc:WOL.Debugging WOLips]].
6 +The following instructions about building WOLips are fine if you need to build a distribution of WOLips. However, they aren't so great if you're debugging WOLips. Instructions on how to do that are posted here [[doc:Debugging WOLips]].
7 7  {{/note}}
8 8  
9 -Prior to building WOLips, you will want to get your dependencies installed properly. Check out the [[doc:WOL.Installing WOLips]] page for information on the dependencies for WOLips.
9 +Prior to building WOLips, you will want to get your dependencies installed properly. Check out the [[doc:Installing WOLips]] page for information on the dependencies for WOLips.
10 10  
11 11  (% style="color: rgb(0,0,0);" %)**Prerequisites**
12 12  
13 13  ==== Install eGit or another Git client ====
14 14  
15 -See [[Getting Started With Git>>doc:WEB.Home.Getting Started.Getting Started with Git.WebHome]] for information on how to obtain a Git client.
15 +See [[Getting Started With Git>>doc:WEB.Getting Started with Git]] for information on how to obtain a Git client.
16 16  
17 17  ==== Install the m2eclipse plugin (Eclipse 3.5 instructions) ====
18 18  
... ... @@ -26,7 +26,6 @@
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....//)
30 30  
31 31  == Checking out and Building from the Commandline ==
32 32  
... ... @@ -37,30 +37,11 @@
37 37  1. The first build will fail out telling you that it couldn't find {{code language="none"}}wobuild.properties{{/code}} – That's OK
38 38  1. Edit {{code language="none"}}~/Library/wobuild.properties{{/code}}
39 39  1. Add a line: {{code language="none"}}eclipse.home=/path/to/your/eclipse{{/code}}
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"}}'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
50 -
51 -{{code language="none"}}-Dno.docs=true{{/code}} to skip the javadoc step, or (untested) you can drop
52 -
53 -{{code language="none"}}jdom-b8.jar{{/code}} from
54 -
55 -{{code language="none"}}woproject/projects/lib{{/code}} into your
56 -
57 -{{code language="none"}}ANT_HOME/lib{{/code}} folder.
58 -)))
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.
59 59  1. The build went into {{code language="none"}}temp/dist{{/code}}
60 60  1. Profit
61 61  
62 -(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.)
63 -
64 64  == Checking out and Building inside of Eclipse for Deployment ==
65 65  
66 66  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
... ... @@ -75,7 +75,7 @@
75 75  == Checking out and Building inside of Eclipse for Development (PDE) ==
76 76  
77 77  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
78 -1. You can select individual plugins you would like to work on by browsing to {{code language="none"}}trunk/woproject/wolips/{{/code}} in the Subversion repository and checking out the plugins you are interested in. To checkout complete sets of plugins, you could also use the [[doc:WOL.Eclipse Team Project Set]].
58 +1. You can select individual plugins you would like to work on by browsing to {{code language="none"}}trunk/woproject/wolips/{{/code}} in the Subversion repository and checking out the plugins you are interested in. To checkout complete sets of plugins, you could also use the [[doc:Eclipse Team Project Set]].
79 79  
80 80  == An approach to setting up the development and test environment for WOLips Plugin. ==
81 81  
... ... @@ -84,7 +84,7 @@
84 84  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.
85 85  1. the {{code language="none"}}temp/dist{{/code}} folder is your Local Site for the Test Environment.
86 86  1. Create a second copy of "clean" Eclipse under /Users/<me>/Developer/eclipse (this could be any where). This will be your Test Environment.
87 -1. In the test environment, follow the [[doc:WOL.Installing WOLips]] instructions, using your {{code language="none"}}temp/dist{{/code}} directory as the Local Site. Install the plugins.
67 +1. In the test environment, follow the [[doc:Installing WOLips]] instructions, using your {{code language="none"}}temp/dist{{/code}} directory as the Local Site. Install the plugins.
88 88  1. Use the Test environment to exercise/test the changes from your locally modified Plugin.
89 89  
90 90  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.
... ... @@ -97,41 +97,32 @@
97 97  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
98 98   The currently required plugins for a deployment build are
99 99   ~* JProfiler (Update Site: [[http:~~/~~/wocommunity.org/documents/tools/jprofiler6/>>url:http://wocommunity.org/documents/tools/jprofiler6/||shape="rect"]])
100 - ~* JRebel (Update Site : [[http:~~/~~/www.zeroturnaround.com/update-site/>>url:http://www.zeroturnaround.com/update-site/||shape="rect"]])
80 + ~* JRebel (Update Site : [[http:~~/~~/www.zeroturnaround.com/update-site/>>url:http://www.zeroturnaround.com/update-site/||shape="rect"]])
101 101  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:
102 102  11. Project Name: WOLips
103 103  11. Git Repositories: git:~/~/github.com/wolips/wolips.git
104 104  11. Use update: Checked
105 105  11. Poll SCM: 59 * * * * //(59 can be replaced with any number between 0 and 59)//
106 -1. (((
107 -Add the following build tasks to the job
108 -
109 -{{code title="Execute Shell"}}
86 +1. Add the following build tasks to the job {{code title="Execute Shell"}}
110 110  echo build.version=3.7.${BUILD_NUMBER} > build.properties
111 111  echo eclipse.home=/usr/local/eclipse >> build.properties
112 112  echo user.home=${WORKSPACE} >> build.properties
113 -
114 -{{/code}}
115 -
116 -{{code title="Invoke Ant"}}
90 +{{/code}} {{code title="Invoke Ant"}}
117 117  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
118 118  
119 -{{/code}}
120 -
121 -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
122 -
123 123  {{code title="Execute Shell"}}
95 +
124 124  rm -fr /usr/local/www/apache22/data/wolips/*
125 125  /bin/cp -prv ${WORKSPACE}/wolips/temp/dist/ /usr/local/www/apache22/data/wolips/
126 126  
127 127  {{/code}}
128 -)))
129 129  
130 130  == Preparation for building WOLips on Windows operating systems (NT 5.0 and higher) ==
131 131  
132 132  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.
133 133  
134 -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.
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.
135 135  1. Set the VMs encoding to MacRoman
136 136  1*. Right click on {{code language="none"}}build.xml{{/code}} -> Properties -> JRE -> VM arguments
137 137  1**. -Dfile.encoding=MacRoman