Skip to Content

Wiki source code of Getting started

Version 14.1 by Lachlan Deck on 2009/09/01 15:08
Show last authors
1 == Outline ==
2
3 {{toc style="disc" indent="20px"}}{{/toc}}
4
5 == Introduction ==
6
7 This guide is aimed at those who'd like to set up a local wolips development environment utilising maven and scm (git, svn).
8
9 == Install Maven ==
10
11 You can download and install maven for most platforms [[here>>http://maven.apache.org/download]].
12
13 {{tip title="Mac Tip"}}
14
15 install macports [http://www.macports.org/install.php], then on the terminal
16 {noformat}sudo port install maven2{noformat}
17
18 In future, to keep this up to date:
19 {noformat}sudo port upgrade maven2{noformat}
20
21 {{/tip}}
22
23 == Download Eclipse ==
24
25 Eclipse can be downloaded and installed from [[www.eclipse.org/downloads/>>http://www.eclipse.org/downloads/]]. For mac it's just a simple matter of unpacking the zip file downloaded into /Applications or /Users/youraccount/Applications.
26
27 {{tip title="Which one do I choose?"}}
28
29 Eclipse Classic (161MB) is a popular choice among WO developers.
30 However, the more lightweight Eclipse IDE for Java Developers (91MB) should work.
31
32 {{/tip}}
33
34 == Launch Eclipse ==
35
36 Open eclipse by double clicking on the application icon (from where you installed it).
37 [[image:LaunchEclipse.png]]
38
39 Eclipse will then ask you for the location of a 'workspace' which is where eclipse will store its metadata.
40 [[image:LaunchEclipseWorkspace.png]]
41
42 == Install Eclipse plugins ==
43
44 Various plugins have prerequisites, and some are just useful anyway, so here's a suggested order of installing some useful plugins when setting up a brand new eclipse environment.
45
46 ==== Step 1 - Choose the menu item: Help > install new software... ====
47
48 [[image:install_menu.png]]
49
50 This will open the install window:
51 [[image:install_window.png]]
52
53 ==== Step 2 - install the testNG plugin (for a simple example) ====
54
55 ===== a) Click the "Add..." button to define the update site, fill in the details, click OK. =====
56
57 [[image:addsite_testng.png]]
58
59 ===== b) Tick the plugin fragments to install =====
60
61 [[image:fragments_testng.png]]
62
63 ===== c) Click next repeatedly, confirming license agreements, finally clicking "Finish" to install. =====
64
65 ===== d) after the software plugin has installed, it will prompt you for a restart of eclipse. Click Yes. =====
66
67 [[image:install_restart.png]]
68
69 ===== e) after eclipse has restarted, continue... =====
70
71 ==== Step 3 - install Groovy ====
72
73 Repeat step 2 with the following detail changes:
74 Site name: Groovy-dev
75 Site location: http:~/~/dist.codehaus.org/groovy/distributions/updateDev/
76
77 ==== Step 4 - Install subversive connectors ====
78
79 Repeat step 2 with the following detail changes:
80 Site name: Subversive-connectors
81 Site location: http:~/~/community.polarion.com/projects/subversive/download/eclipse/2.0/galileo-site/
82 Fragments selected: 'Subversive SVN Connectors', 'SVNKit 1.3 Implementation (Optional)'
83
84 [[image:fragments_subversive.png]]
85
86 ===== Step 5 - Install egit =====
87
88 Repeat step 2 with the following detail changes:
89 Site name: egit
90 Site location: http:~/~/www.jgit.org/updates
91
92 ===== Step 6 - Install m2eclipse =====
93
94 Repeat step 2 with the following detail changes:
95 Site name: m2eclipse
96 Site location: http:~/~/m2eclipse.sonatype.org/update-dev/
97 Fragments selected: all fragments of 'Maven Integration'
98 [[image:fragments_m2eclipse.png]]
99
100 ===== Step 6 - Install WOLips =====
101
102 Choose an update site that's appropriate for the version of Eclipse you're running. The update site for Eclipse 3.5 is as follows. (Ask on the mailing list for future versions if it's not been updated here).
103
104 Repeat step 2 with the following detail changes:
105 Site name: WOLips//3//5
106 Site location: http:~/~/webobjects.mdimension.com/wolips/eclipse_3_5/
107 Fragments selected: all fragments of 'Maven Integration'
108 [[image:fragments_wolips.png]]
109
110 == Configuring Eclipse ==
111
112 ==== wolips binding validation ====
113
114 [[image:wolips_bindingsvalidation.png]]
115
116 ==== wolips spaces around html tags (off) ====
117
118 [[image:wolips_nospaces.png]]
119
120 ==== wolips launching ====
121
122 As of this writing, wolips has forgotten to set the key "-WOHost" with value "localhost". Add it.
123 I also untick a few things that don't need to be specifically ticked so that your project's properties are used (as you're mimicking the deployment env locally)
124 [[image:wolips_launching.png]]
125
126 ==== Set the default jvm ====
127
128 [[image:prefs_jvm.png]]
129
130 ==== Java typing prefs ====
131
132 [[image:prefs_java_typing.png]]
133
134 ==== Java Templates prefs ====
135
136 [[image:prefs_java_teplates.png]]
137
138 ==== Run / Debug prefs ====
139
140 I'll have 4 spaces per tab rather than 8 thanks!
141 And I prefer to kill the console buffer manually rather than lose messages that might be important.
142 [[image:prefs_console.png]]
143
144 ==== Launch configurations ====
145
146 I don't like them disappearing on me when I close / delete projects
147 [[image:prefs_launchconfig.png]]
148
149 ==== Lines numbers please ====
150
151 [[image:prefs_linenumbers.png]]
152
153 ==== UTF-8 Thanks ====
154
155 [[image:prefs_utf8.png]]