Download the Eclipse Installer. Eclipse is hosted on many mirrors around the world. A page, with the label eclipse downloads, will be displayed in your browser. In the first section, find the text Download Now: Eclipse SDK 3.2, Windows (120 MB) Click the icon to the left of this text, or the part of the text labeled Eclipse SDK 3.2 If you are using a Mac, it should sense it and display Mac.
This page tells you how to download and install Java 8 and Eclipse on Mac OS X, and how to configure Eclipse.
Installing Java 8
Go to the Oracle website. You'll see something like this:
Scroll down until you see a heading beginning 'Java SE 8u65/8u66.' On the right, you'll see a Download button under the JDK header. Click it. The next screen will look like this:
Click the radio button next to 'Accept License Agreement' and then click on jdk-8u65-macosx-x64.dmg. You'll be asked whether to save the file that is going to be downloaded; click on Save File.
Open your Downloads folder, and double-click on jdk-8u65-macosx-x64.dmg. You'll see this window:
Double-click on the package icon, and follow the instructions to install. When the installation has completed, click on Done. At this point, you may close up the window and drag jdk-8u65-macosx-x64.dmg to the Trash.
Installing Eclipse
If you already have Eclipse installed on your Mac, you need to get rid of it. To do so, first quit Eclipse if you're currently running it. Then, go to your workspace folder (probably in Documents/workspace) and save anything there that you want to keep, because you're about to get rid of this folder. Next, drag the workspace folder to the Trash.
Go to your Applications folder. One way to get there is, from the Finder, type command-shift-A. You'll a folder named eclipse in there; drag the eclipse folder to the Trash. If you have an Eclipse icon in your dock, remove it from the dock.
Now you're ready to download and install the newest version of Eclipse. Go to this website. You'll see a window like this:
Scroll down until you see 'Eclipse IDE for Java Developers' and click where it says 64 bit under Mac OS X.
You will see this window:
Click on the yellow download button. If asked, click on 'Open with Archive Utility (default)' and then click OK. The download might take a few minutes. You should not feel compelled to donate.
After the download completes, folders should automatically expand. If they don't, double-click on the .tar file. When that's done, you should see a folder named eclipse in your Downloads folder. When you open your Downloads folder, if you see Applications under the Favorites on the left side of the window, you should drag the eclipse folder into Applications. If you don't see Applications, then open a new window for Applications (from the Finder, command-shift-A), and drag the eclipse folder into Applications.
Open your Applications folder, and then open the eclipse folder. You'll see an item named Eclipse; if you like, drag its icon into the dock so that you'll be able to launch Eclipse easily.
Launch Eclipse. If you're asked whether you want to open it, of course you do; click Open. You'll see a window like this:
It will have your user name rather than mine (scot). Select where you want your workspace to be; I recommend the default of your Documents folder. Click the checkbox for using this location as the default, and then click OK.
You'll see a window like this:
Click on the Workbench arrow in the upper right that I've circled. You shouldn't see this screen again, even if you quit Eclipse and relaunch it.
You'll get an empty workbench like this:
We won't be using the 'Task List' and 'Connect Mylyn' windows. Click the 'x' on each to close it. Press the mouse on the Window menu item, then choose 'Perspective', and finally choose 'Save Perspective as...'. Enter 'cs10' for the name of this perspective and press return. Your workbench will now look like this:
You have now installed Eclipse!
Configuring Eclipse
You don't have to configure Eclipse the way I do, but you'll probably avoid some confusion if you do. Here's how.
In the Eclipse menu bar, click on the Eclipse menu and then on 'Preferences...'. You'll see a window with two panes. On the left pane is a list of types of things you can configure.
Click on the triangle to the left of General. Then click on the triangle to the left of Appearance. Then click on 'Colors and Fonts.' You should see a window like this:
In the window in the middle, click on the triangle next to Java. Then double-click on 'Java Editor Text Font':
You'll see this window:
On the right, where you can select the size, click 12. Then close this window by clicking on the window's close button.
Close up the General preferences by clicking on the triangle to the left of General. Click the triangle next to Java and then click the triangle next to 'Code Style.' Then click Formatter. Here's what you should see:
Click the button that says 'New...'. You'll see a window such as this one:
You can type in any profile name you like. I used 'CS 10':
Click OK.
You should see a window like this:
Change the tab size to 2:
You'll see that the indentation size automatically changes as well.
Click on 'Blank Lines,' and after 'Between import groups' and 'Before declarations of the same kind,' change the values 1 to 0:
Click on 'Control Statements,' and check the first four boxes as I've done here:
Click OK.
Now click on triangles to close up Java. Click on the triangle next to Run/Debug, and then click on Console:
Click on the green color sample next to 'Standard In text color.' You'll get a color picker:
Slide the slider on the right down, so that you get a dark green. (You're at Dartmouth. What other color could you possibly want?)
Close the color picker window by clicking its close button, and click OK again to close the Preferences window.
And you're done!
Install Python before installing Eclipse.
You may want to print these instructions before proceeding, so that you can refer to them while downloading and installing Eclipse. Or, just keep this document in your browser. You should read each step completely before performing the action that it describes. This document shows downloading and installing Eclipse (Luna). You should download and install the latest version of Eclipse. The current latest (as of Fall 2018) is Eclipse 2018-09.
Eclipse: Luna
The Eclipse download requires about 200 MB of disk space; keep it on your machine, in case you need to re-install Eclipse. When installed, Eclipse requires an additional 200 MB of disk space.
Downloading
- Click Eclipse
The following page will appear in your browser. In this handout we will download Eclipse Standard 4.4 for Mac OS. The version you should download is Eclipse IDE for Eclipse Committers.
It is critical that Java, Python, and Eclipse are either all 32 Bit or are all 64 Bit (and only if your Machine/OS supports 64 Bit): I think it easiest on Macs to use 64 Bit for everything.
- Click the 64-bit after Mac Cocoa for your machine, to the right of Eclipse Standard 4.4 (right under Eclipse Luna R Packages).
You will see the following page (don't worry about the name of the institution to the right of the big downward pointing arrow).
- Click the big downward pointing arrow underneath the Download eclipse-standard-luna-R-macosx-cocoa-x86_64.tar.gz from: The site named here, in purple to the right of the arrow: [United States] ibiblio (http) is the random one chosen by the download page this time; yours may differ.
If you see the following pop-up window
ensure the Save File radio button is depressed and click OK.
This file should start downloading in your standard download folder. This file is about 200 Mb so it might take a while to download fully if you are on a slow internet connection (it took me a few minutes over a cable modem). Don't worry about the exact time as long as the download continues to make steady progress.
After the download has finished, terminate the window browsing the Eclipse download.
- Move this file to a more permanent location, so that you can install Eclipse (and reinstall it later, if necessary).
- Start the Installing instructions directly below.
Installing (for Python)
Download Eclipse For Mac 64 Bit
Python and Java should be installed before installing EclipseEclipse Programming Software
- Unzip eclipse-standard-luna-R-macosx-cocoa-x86_64.tar.gz by double-clicking it.
Unzipping this file creates a folder named eclipse; unzipping 200 MB can take a few minutes. You can leave this folder here or move it elsewhere on your hard disk.
- Create an alias on the desktop to to the eclipse file in this eclipse folder:
On the Mac, you can- Control-click the file eclipse.exe
- Select the Make Alias option.
- Move it to the desktop.
Now you are ready to perform a one-time only setup of Eclipse on your machine.
- Double-click the alias to Eclipse that you just created above.
If the following pop-up window appears
click Open.
The following splash screen will appear
and then a Workspace Launcher pop-up window will appear.
In the Workspace text box, your name should appear between /Users and /Documents, instead of ellenolshansky (I did this on my wife's Mac).
Leave unchecked the Use this as the default and do not ask again box. Although you will use this same workspace for the entire quarter (checking projects in and out of it), it is best to see this Workspace Launcher pop-up window each time you start Eclipse, to remind you where your workspace is located.
In fact, it is a good idea to create on your desktop an alias to your workspace folder; but you must click OK (see below) before Eclipse creates this folder and you can alias it.
- Click OK.
Progress bars will appear as Eclipse loads.
Eventually the Eclipse workbench will appear with a Welcome tab covering it.
- Terminate (click X on) the Welcome tab.
You will not see the Welcome tab when you start Eclipse again, after this first time.
- Click Help (on the far right of the top toolbar) and then click Install New Software... in its pull-down menu, as shown below.
The Install pop-up window will appear.
- Enter the text (or cut/paste from this document) http://pydev.org/updates into the Work with text box and press Enter (if that doesn't work, try http://www.pydev.org/updates).
In a few seconds the information under Name should change from
There is no site selected to Pending toSelect only the top PyDev checkbox; do NOT select the PyDev Mylyn Integration (optional) box.
Check before proceeding that the Install pop-up window appears as - Click Next >
A new Install pop-up window will appear.
- Click Next >
A new Install pop-up window will appear.
Selecet the I accept the terms of the license agreement radio button, so the window appears as
- Click Finish
An Installing Software pop-up window will appear. During installation, it will show the various operations it is performing and a progress bar for each one. Because the installer is fetching various files online, this process might take a few minutes.
The installation will pause, and a Selection Needed pop-up window appears.
- Check the box labeled Brainwy Software; Pydev; Brainwy.
Check before proceeding that the Install pop-up window appears as
- Click OK
The installation will finish (showing the final progress bars).
A Software Updates pop-up window will appear.
- Click Yes
Eclipse will terminate and restart. As you did in step 3, click OK to the Workspace Launcher pop-up window.
- Click Eclipse (to the right of Apple logo on the far left of the top tool bar), and then click Preferences in its pull-down menu, as shown below.
- Drill down to select the interpreter:
- Disclose PyDev by clicking the triangle in front of PyDev or double-clicking PyDev (after the triangle).
- Disclose Interpreters by clicking the triangle in front of Interpreters or double-clicking Interpreters (after the triangle).
- Select Python - Interpreter.
- Click New... at the top-right of the top window
A Select Interpreter pop-up window appears.
Type python34 in the Interpreter Name text box.
Type (or cut/paste) //usr/local/bin/python3 in the Interpreter Executable text box (or browse to this file).
The Select Interpreter pop-up window should appear as - Click OK.
A Selection needed pop-up window will appear.
Ensure that a check appears in all four checkboxes.
- Click OK.
The Preferences pop-up window will be changed to
- Click OK.
A Progress Information pop-up window will appear.
During installation, it will show the various operations it is performing and a progress bar for each one. Eventually the installation will terminate.
- Click Window (to the left of Help on the far right of the top tool bar), hover over Open Perspective in the pull-down menu and then click Other... in the next pull-down menu.
The Open Perspective pop-up window will appear.
- Double-click PyDev (third from the bottom)
The label on Eclipse will change from Java - Eclipse to PyDev - Eclipse, and the Package Explorer in the upper-left tab will change to PyDev Package Explorer, and a PyDev icon will appear to the right of the Java icon.
- Right-click the Java icon to the left of the PyDev icon and select close
The Eclipse workbench will now have only the PyDev icon here and will look like
- Download the courselib.zip file.
In the pop-window that appears
ensure the Save File radio button is depressed and click OK.
- Locate the workspace folder created in step 3 (see /Users/yourname/Documents/workspace) and copy the courselib.zip file into this workspace and unzip it there, producing the courselib folder; it should should contain a bunch of Python module files (ending in .py). From time to time you will be asked to put other course-specific Python module files into this courselib folder; these modules will be usable in all Python projects in Eclipse.
- Inform Eclipse to use the courselib folder in all Python projects.
- Select Eclipse | Preferences.
- Disclose PyDev by clicking the triangle in front of PyDev or double-clicking PyDev (after the triangle).
- Disclose Interpreters by clicking the triangle in front of Interpreters or double-clicking Interpreters (after the triangle).
- Select Python - Interpreter.
- Click the Libraries tab (leftmost, above the bottom pane)
- Click the New Folder button (topmost, right of the bottom pane)
- Browse to the courselib folder (added above) in the Browse for Folder pop-up window (/Users/yourname/documents/workspace/courselib).
- Click the courselib folder selected, and then click OK
- Click Apply (you will see some progress bars)
The < />< />< b=' /> pop-up window should now appear asNotice a fifth entry (ending in courselib appears at the bottom of the bottom pane named System PYTHONPATH
< />< /> - Cick OK
- Terminate (click X on) the Eclipse window.