Changes for page Building WOLips

Last modified by Johann Werner on 2015/02/13 01:40

From version 51.1
edited by Pascal Robert
on 2012/02/11 08:50
Change comment: There is no comment for this version
To version 57.1
edited by wessman
on 2011/06/23 19:25
Change comment: Updated WOLips 3.6 update site to the new, valid location

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.probert
1 +XWiki.wessman
Content
... ... @@ -1,6 +1,7 @@
1 1  {{tip title="Not Required!"}}
2 -You do not have to build WOLips to use it. It is easily available via Eclipse's Software Update functionality. The update site is: [http://wocommunity.org/wolips/3.7/stable/]
3 3  
3 +You do not have to build WOLips to use it. It is easily available via Eclipse's Software Update functionality. The update site is: [http://webobjects.mdimension.com/hudson/job/WOLips36Stable/lastSuccessfulBuild/artifact/site/]
4 +
4 4  {{/tip}}
5 5  
6 6  {{note}}
... ... @@ -11,14 +11,20 @@
11 11  
12 12  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.
13 13  
14 -{{color value="#000000"}}
15 -{*}Prerequisites{*}
16 -{{/color}}
15 +WOLips is now located in Subversion at ##objectstyle.org##. The CVS repository at sourceforge is now deprecated.
17 17  
18 -==== Install eGit or another Git client ====
17 +The subversion repository path is [[https://svn.objectstyle.org/repos/woproject]]
19 19  
20 -See [[Getting Started With Git>>documentation:Getting Started with Git]] for information on how to obtain a Git client.
19 +== Prerequisites ==
21 21  
21 +==== Install Subclipse (the Subversion plugins) ====
22 +
23 +1. Help=>Software Updates=>Find and Install ...
24 +1. Add New Remote Site
25 +11. Name = Subclipse
26 +11. URL = [[http://subclipse.tigris.org/update_1.0.x]]
27 +1. Select the site, select all the plugins available, and install them
28 +
22 22  ==== Install the m2eclipse plugin (Eclipse 3.5 instructions) ====
23 23  
24 24  1. Help > Install New Software
... ... @@ -35,19 +35,13 @@
35 35  == Checking out and Building from the Commandline ==
36 36  
37 37  1. Checkout the ##trunk/woproject## folder from Subversion
38 -##git clone## ##[[git://github.com/wolips/wolips.git]]## woproject
45 +##svn co## ##[[https://svn.objectstyle.org/repos/woproject/trunk]]## ##.##
39 39  1. ##cd woproject##
40 40  1. ##ant##
41 41  1. The first build will fail out telling you that it couldn't find ##wobuild.properties## ~-~- That's OK
42 42  1. Edit ##/Library/wobuild.properties##
43 43  1. Add a line: ##eclipse.home=/path/to/your/eclipse##
44 -1. Call ant with the build.version argument:
45 -
46 -{{code}}
47 -ant -Dbuild.version=3.7.SomeNumber
48 -{{/code}}
49 -
50 -1.
51 +1. ant again and it should succeed this time
51 51  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.//
52 52  1. The build went into ##temp/dist##
53 53  1. Profit
... ... @@ -54,7 +54,8 @@
54 54  
55 55  == Checking out and Building inside of Eclipse for Deployment ==
56 56  
57 -1. Add the wolips Git repository [[https://github.com/wolips/wolips/]] in the Git Perspective's Repository View
58 +1. Add the wolips SVN repository [[https://svn.objectstyle.org/repos/woproject]] in the SVN Perspective's Repository View
59 +1. In SVN perspective, browse WOLips repository on HEAD, checkout ##trunk/woproject##
58 58  1. Right-click (or equiv) on the ##build.xml## inside of the "woproject" project and Run As=>Ant Build ...
59 59  1. Switch to the Properties tab and check for the definition of eclipse.home in the Properties list
60 60  1. If ##eclipse.home## does not exist, uncheck "Use global properties" and then click "Add Property"
... ... @@ -65,7 +65,7 @@
65 65  
66 66  == Checking out and Building inside of Eclipse for Development (PDE) ==
67 67  
68 -1. Add the wolips Git repository [[https://github.com/wolips/wolips/]] in the Git Perspective's Repository View
70 +1. Add the wolips SVN repository [[https://svn.objectstyle.org/repos/woproject]] in the SVN Perspective's Repository View
69 69  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]].
70 70  
71 71  == An approach to setting up the development and test environment for WOLips Plugin. ==
... ... @@ -80,27 +80,23 @@
80 80  
81 81  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.
82 82  
83 -== Building WOLips with Jenkins Continuous Build server ==
85 +== Building WOLips with Hudson Continuous Build server ==
84 84  
85 85  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.
86 86  
87 -1. Install Eclipse 3.7. You need it to be able to build WOLips.
88 -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
89 -The currently required plugins for a deployment build are
90 - JProfiler (Update Site:&nbsp;[[http://wocommunity.org/documents/tools/jprofiler6/]])
91 - JRebel (Update Site :&nbsp;[[http://www.zeroturnaround.com/update-site/]])
92 -1. Create a new job in Jenkins to build WOLips. You can use the [[following sample config>>https://github.com/wocommunity/JenkinsJobs/tree/master/WOLips]]&nbsp;or you can add a new job with the following configuration:
93 -11. Project Name: WOLips
94 -11. Git Repositories:&nbsp;git:~/~/github.com/wolips/wolips.git
95 -11. Use update: Checked
96 -11. Poll SCM: 59 * ** * ** //(59 can be replaced with any number between 0 and 59)//
89 +1. Add a new job with the following configuration
90 +Project Name: WOLips
91 +Subversion: [[http://svn.objectstyle.org/repos/woproject/trunk/woproject]]
92 +Local module directory (optional): wolips
93 +Use update: Checked
94 +Poll SCM: 59 * ** * ** //(59 can be replaced with any number between 0 and 59)//
97 97  1. Add the following build tasks to the job
98 98  
99 99  {{code title="Execute Shell"}}
100 100  
101 -echo build.version=3.7.${BUILD_NUMBER} > build.properties
102 -echo eclipse.home=/usr/local/eclipse >> build.properties
103 -echo user.home=${WORKSPACE} >> build.properties
99 +echo build.version=3.4.${SVN_REVISION} > wolips/build.properties
100 +echo eclipse.home=/usr/local/eclipse >> wolips/build.properties
101 +echo user.home=${WORKSPACE} >> wolips/build.properties
104 104  
105 105  {{/code}}
106 106  
... ... @@ -119,6 +119,12 @@
119 119  
120 120  {{/code}}
121 121  
120 +1. Copy eclipse with the necessary plugins installed to your build server. In this example it has been copied to /usr/local/eclipse
121 +The currently required plugins for a deployment build are
122 +1*. JProfiler ([[Update Site>>http://webobjects.mdimension.com/jprofiler6/]])
123 +1*. m2Eclipse Maven ([[Update Site>>http://m2eclipse.sonatype.org/sites/m2e]])
124 +1*. JRebel ([[Update Site>>http://www.zeroturnaround.com/update-site/]])
125 +
122 122  == Preparation for building WOLips on Windows operating systems (NT 5.0 and higher) ==
123 123  
124 124  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.