-
Notifications
You must be signed in to change notification settings - Fork 16
Expand file tree
/
Copy pathBioJava3_Eclipse_with_SVN.html
More file actions
224 lines (168 loc) · 8.71 KB
/
BioJava3_Eclipse_with_SVN.html
File metadata and controls
224 lines (168 loc) · 8.71 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
<h2 id="prerequisite">Prerequisite</h2>
<ul>
<li>Make sure you have a copy of the latest eclipse (Galileo)</li>
</ul>
<!-- -->
<ul>
<li>Make sure you have Java 1.6 installed. (if you are on OSX 10.4.x,
install <a href="http://landonf.bikemonkey.org/static/soylatte/">soylatte</a>)</li>
</ul>
<!-- -->
<ul>
<li>Install the <a href="http://eclipse.org/m2e/">m2eclipse</a> Maven eclipse
plugin (previously hosted by
<a href="http://m2eclipse.sonatype.org/">Sonatype</a>). Be sure to include SCM
integration, offered through the m2eclipse-extras package.</li>
</ul>
<!-- -->
<ul>
<li>Install <a href="http://www.eclipse.org/subversive/">Subversive</a> through
eclipse update site (it’s the official eclipse plugin), or install
<a href="http://subclipse.tigris.org/">subclipse</a> plugin for subversion
instead (latest versions: 1.8.16 and 1.6.18).</li>
</ul>
<h2 id="installation">Installation</h2>
<ul>
<li>In the SVN Repository Exploring view: Right click on the folder
<i>/biojava/biojava-live/trunk</i> and select Check Out as Maven
project</li>
</ul>
<h2 id="details-for-specific-eclipse-versions">Details for specific Eclipse Versions</h2>
<h3 id="update-for-eclipse-juno-i-use-juno-sr1october-2012">Update for Eclipse Juno (I use Juno SR1)(October 2012)</h3>
<p>There used to be some conflicts with SVN connectors, but thank God,
things are good now. Now, it’s as simple as this:</p>
<ul>
<li>From Help menu select “Install new software…”</li>
<li>select the Juno update site option (Juno -
<a href="http://download.eclipse.org/releases/juno">http://download.eclipse.org/releases/juno</a>)</li>
<li>Check “m2e - Maven Integration for Eclipse”, and “Subversive SVN
Team Provider”</li>
<li>Go through the regular process (next, accept, & restart)</li>
<li>After installing both plugins, from File menu, select import…</li>
</ul>
<p><img src="Importing Maven Project.png" alt="" title="Importing Maven Project.png" /></p>
<ul>
<li>“Checkout Maven Projects from SCM” looks like this.</li>
</ul>
<p><img src="Checkout Maven Project through SCM.png" alt="" title="Checkout Maven Project through SCM.png" /></p>
<ul>
<li>beside the <strong>SCM URL</strong> label, there is a drop down box for SCM type,
and a text field for URL. In the first time, the drop down box will
be empty…</li>
<li>you will find a small line below containing “Find more SCM
connectors in the m2e Marketplace”. Click m2e Marketplace.</li>
<li>In the “m2e team providers” section, select “m2e-Subversive”,</li>
</ul>
<p><img src="M2E Subversive Handler.png" alt="" title="M2E Subversive Handler.png" /></p>
<p>then the next/accept/etc. process.</p>
<p><img src="M2E Subversive Handler1.png" alt="" title="M2E Subversive Handler1.png" /></p>
<ul>
<li>When you start first call to SVN-based operation, eclipse will show
you a window asking you to choose a connector. The safest way is to
select SVNkit (pure java implementation). This choice will not
install any conflicting binaries to your system, also, being
Java-based, it is OS independent.. you will keep your head from all
hassle related to win32/64 compatibility and such stuff.</li>
<li>congratulations! Everything is ready now. Go back to the “Checkout
Maven Projects from SCM”, you will see an SVN option in the dropdown
box. Select it, key in the URl, and import (here I use the
developer’s access URL, which might be different from yours).</li>
</ul>
<p><img src="Checkout Maven Project through SCM (populated).png" alt="" title="Checkout Maven Project through SCM (populated).png" /></p>
<hr />
<h3 id="update-for-eclipse-helios-sr2-may-2011">Update for Eclipse Helios SR2 (May 2011)</h3>
<p>The above plugins are still available and work fine, however, below are
the few important particulars.</p>
<ul>
<li>Use update URLs from the plugins web site, do not use Eclipse market
place, as in that case you will have to install all the components
of the plugin manually and it will be very easy to forget to install
something important, besides it does not always work.</li>
</ul>
<!-- -->
<ul>
<li>Make sure you have full JDK 1.6 installed, JRE will not be
sufficient (some <em>Maven</em> plugins will not work)</li>
</ul>
<!-- -->
<ul>
<li>After JDK installation point Eclipse to the JDK location. For this
edit <em>eclipse.ini</em> found in the Eclipse root directory. Insert <em>-vm</em>
keyword with the location of your JDK and make sure that this
keyword precedes <em>-vmargs</em> (!) for example</li>
</ul>
<p><code class="highlighter-rouge"> -vm</code><br />
<code class="highlighter-rouge"> C:/Java/jdk1.6.23/bin</code><br />
<code class="highlighter-rouge"> -vmargs</code><br />
<code class="highlighter-rouge"> -Xms40m</code><br />
<code class="highlighter-rouge"> -Xmx512m</code></p>
<ul>
<li>If you work on any other operating system but win32, you will have
to install JavaHL library for the <em>subclipse</em> plugin manually. More
information about it can be found here:
<a href="http://subclipse.tigris.org/wiki/JavaHL"><a href="http://subclipse.tigris.org/wiki/JavaHL">http://subclipse.tigris.org/wiki/JavaHL</a></a></li>
</ul>
<!-- -->
<ul>
<li>When adding the URL of BioJava development repository do not add the
actual folder you want to check out, otherwise you may not be able
to checkout it as maven project. For example if you want to checkout</li>
</ul>
<p><code class="highlighter-rouge">svn+ssh://dev.open-bio.org/home/svn-repositories/biojava/biojava-live/trunk/</code></p>
<p>use</p>
<p><code class="highlighter-rouge">svn+ssh://dev.open-bio.org/home/svn-repositories/biojava/biojava-live</code></p>
<p>as the repository URL and then navigate to trunk in the Eclipse SVN
explorer.</p>
<h3 id="eclipse-indigo-august-29th-2011">Eclipse Indigo (August 29th 2011)</h3>
<p>I downloaded the Eclipse j2ee version (OSX Lion) and used the Eclipse
Marketplace to find and install the following plugins:</p>
<p>from Eclipse Marketplace:</p>
<p><code class="highlighter-rouge">- Subclipse </code><br />
<code class="highlighter-rouge">- Maven Integration for Eclipse</code><br />
<code class="highlighter-rouge">- Maven Integration for Eclipse WTP (probably not needed, but I do a lot of web stuff, so I added it)</code><br />
<code class="highlighter-rouge">- m2e-subclipse (SCM connector, bring Maven and subclipse together)</code></p>
<p>from Yoxos Marketplace</p>
<p><code class="highlighter-rouge">- SvnKit Client Adapter (needs to be enabled in Preferences->Team->SVN, SVN Interface ->SVNKit, Pure Java )</code></p>
<p>To check out BioJava you can do: new -> Maven ->checkout project from
SCM, add biojava URL to …/biojava-live/trunk, press finish</p>
<p>A useful blog article providing more help for how to install Maven is
here:
<a href="http://www.shareyourwork.org/roller/ralphsjavablog/entry/eclipse_indigo_maven_and_svn">1</a></p>
<p>Here some instructions for where to find the various eclipse plugins:
<a href="https://wiki.openmrs.org/display/docs/Step+by+Step+Installation+for+Developers">2</a> –<a href="User:Andreas" title="wikilink">Andreas</a>
04:43, 30 August 2011 (UTC)</p>
<h2 id="anonymous-access-with-git">Anonymous access with Git</h2>
<p>In the past, anonymous access to BioJava source code via SVN has been
problematic. Alternatively, you can retrieve the source code from the
read-only <a href="https://github.com/biojava">BioJava github mirror</a> using
Eclipse.</p>
<p><em>Requirements:</em></p>
<ul>
<li>Java 6 (1.6) JDK</li>
<li>Eclipse Indigo (3.7) or greater</li>
<li>m2eclipse (Eclipse <a href="http://download.eclipse.org/technology/m2e/releases">update
site</a>)</li>
<li>EGit (pre-installed with Indigo)</li>
<li>Maven SCM Handler for EGit (m2e-egit) from Eclipse Marketplace</li>
</ul>
<p><em>Additional setup:</em></p>
<ul>
<li>Edit your eclipse.ini file to use the Java JDK as your VM
(instructions above, required for Maven)</li>
<li>If necessary, <a href="http://wiki.eclipse.org/EGit/User_Guide#Setting_up_the_Home_Directory_on_Windows">set the HOME environment
variable</a>
(required for EGit)</li>
</ul>
<p><em>Import the BioJava Maven project from Git (<a href="http://stackoverflow.com/questions/4869815/importing-a-maven-project-into-eclipse-from-git">StackOverflow
answer</a>):</em></p>
<ul>
<li>Open the Git Repository perspective</li>
<li>Clone the BioJava git repository
(http://github.com/biojava/biojava.git)</li>
<li>Expand the cloned repository, right-click “Working directory”, and
pick “Import Maven Projects…”</li>
<li>Open the Java perspective</li>
<li>Select all of the projects, right-click and choose “Team > Share
Project”, select “Git”, and check the “Use or create repository in
parent folder of project” box</li>
</ul>