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 the 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:

1. 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:
2. 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:
3. Assuming you accept the license agreement, click on the appropriate installation image, and follow the instructions to install the image on your computer.

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:

1. 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.

   
2. Download the appropriate image.

   Sometimes, but not usually, 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:

   • 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)

   If you are unsure, stick with the main download site even if it is slow.

3. After downloading, install eclipse on your computer. This involves extracting the downloaded eclipse archive to some location 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

1. 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
2. Double-click on the icon to launch eclipse. This may take a few minutes.
3. A window will pop up offering you a choice of workspace name. Go ahead and use the default.
4. 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 called subversive, and it is installed as follows:

1. From Help drag and select Install New Software:
2. Click on the down-arrow next to the Add button, and select the Luna site:

   Note: The position of this particular entry may be different for you. Be sure to pick the one that matches what is highlighted below.

   
3. A menu of available software is shown, organized by category. Click on the Collaboration category: and it will expand to a long list:
4. Scroll down that list and find the box marked Subversion SVN Team Provider, check it, and click Next:
5. You're almost there: when asked, agree to the license agreement, click Next and finally Finish.
6. 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.

1. When we last left our story, you installed subversive and then eclipse restarted itself. You should see a new welcome page about subversive:
2. Click on the X to close the welcome window.
3. Click on the Window toolbar menu, drag to Open Perspective and then choose Other...:
4. Choose SVN Repository Exploring: and click OK.
5. This should bring up the menu shown below, offering you a choice of connectors. You should choose SVN Kit 1.8.3 as indicated below:

   Note that the position of the entry you want may be different in the menu you see.

   
6. Check the box for the entry, and click on Finish.
7. 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:
8. 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.

9. 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.