By Jonathon Lundy, Ron Cytron, and Logan Sorrentino
Revised 2015 by Ron Cytron
Eclipse is an
Integrated Development Environment, or IDE,
which is software that provides all the essential tools you will need for
editing, running, and debugging your Java programs.
Eclipse and all of the supporting software are already
installed on lab computers, but you should install it on your own
computer as well, for convenience and flexibility.
We have yet to meet a computer that could not host eclipse. The instructions
below have been tested and should work for you. Should you run into problems,
please contact the instructor.
- Installing the Java Development Kit (JDK)
- Both eclipse and the code you develop require installation of
Java programming language.
It is likely your computer already has a suitable installation of Java, but
just in case, please follow the following steps to ensure that
version 1.7 of the language is installed:
- Open the Java SE (Standard Edition) downloads page. You should see
a screen such as the one below, and you want to click on the downloads button
shown in the red box:
- After clicking on that button, you will see a page with choices for
your installation. The table you see should look like the one below, and
you most likely want one of the two choices shown in a red box, depending
on whether you have a Mac or you are running Windows on a PC:
- Assuming you accept the license agreement, click on the appropriate
installation image, and follow the instructions to install the image on your
If you run into any problems with this, you are advised to skip this step and
try installing eclipse without prior installation of Java. This may well
work for you. If you run into problems, please see a TA or the instructor.
For example, if you have a Mac, then the installation of Java may require
the most recent release of their operating system. Don't worry: you already
have Java on your Mac and eclipse should install fine.
- Installing eclipse
Carefully follow the steps below to install eclipse and the extra components
we need for our course:
- Open the eclipse downloads page. You will see the choices shown below, and you should choose the
version shown inside the red box.
Because I generated this image on my Mac,
the choices are for a Mac, but the page should offer you the choices
appropriate for your computer.
- Download the appropriate image.
I have seen the main download site
(the one indicated with
take a long time, up to 40 minutes,
to provide the image you need. You are welcome to choose one of the
mirrior sites listed, but those offer you the full range of images.
Be sure to pick the right one:
If you are unsure, stick with the main download site
even if it is slow.
- The image should be Eclipse IDE for Java Developers
- The image should be appropriate for your computer:
- Operating system (Windows, Mac)
- Architecture (32 or 64 bit)
- After downloading, install eclipse on your
computer. This involves extracting the downloaded eclipse archive to
on your computer. Most likely, if you double click the installed file, your
computer will know what to do, and the results will most likely remain in
your Downloads folder, or wherever the archive was saved.
It would be a good idea to move it from Downloads in case that
folder gets wiped out subsequently:
Whether your computer is a Mac or a PC running Windows,
please arrange for the eclipse
folder to be extracted and placed on your desktop,
not in your program files folder.
We have seen problems where Windows will block connections coming
from applications installed in the program files folder.
Also if you need help, it's easier for
us to find eclipse on your desktop.
- Launching eclipse the first time
- Inside the eclipse folder you placed on your desktop, there
should be an executable file that will cause eclipse to run.
It may be named eclipse.exe or Eclipse.app and its
icon looks like
- Double-click on the icon to launch eclipse. This may take a few minutes.
- A window will pop up offering you a choice of workspace name. Go ahead
and use the default.
- You should (after some more delay) see a welcome screen for eclipse:
Close that welcome message by clicking on its X in the tab.
- Installing subversive
Our next step is to install the software that lets us obtain and submit
our work for this semester. The component is
and it is installed as follows:
- From Help drag and select Install New Software:
- Click on the down-arrow next to the Add button, and select the
Luna site (picture may say kepler, but choose luna):
- A menu of available software is shown, organized by category. Click
on the Collaboration category:
and it will expand to a long list:
- Scroll down that list and find the box
marked Subversion SVN Team Provider, check it, and click Next:
- You're almost there: when asked, agree to the license agreement, click
Next and finally Finish.
- Eclipse will ask you if it's OK to restart. Click on Yes.
Before you can begin with our coursework, there is one more
step you must complete, so please continue.
- Installing the connector
- Because of the way software is licensed, the component needed to
communicate with a server is installed separately. Follow the instructions
below to install the connector.
When we last left our story, you installed subversive and then
eclipse restarted itself. You should see a new welcome page about
- Click on the X to close the welcome window.
- Click on the Window toolbar menu, drag to Open
Perspective and then choose Other...:
- Choose SVN Repository Exploring:
and click OK.
- This should bring up the menu shown below, offering you a choice
You should pick the SVN Kit entry that has the
most recent revision number.
Do not pick any of the JavaHL entries.
The picture below is out of date. There was a time when we needed
1.3.8, but you should pick the most recent version you see. In the picture
below, that would be 1.7.9.
Note that the position of the entry you want may be different in the menu
- Check the box for the entry, and click on Finish.
- You should see the following window pop up, with both entries selected
as shown below. Click to select them if they are not already selected:
- From here, agree to license specifications as needed, click on Next, and Finish when offered those choices.
You may be challenged at some points to assert your agreement to the
installation. Say OK as needed.
- When asked about restarting eclipse, say Yes.
OK things should work for you now. Try to load a repository as directed in
one of your assignments, such as Lab 0.
Last modified 15:48:19 CST 10 January 2015
by Ron K. Cytron