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 (2021-06) on Windows 10
in Summer 2021.
You should download and install the latest version of Eclipse.
The current latest (as of Summer 2021) is Eclipse 2021-06.
Remember that you must install Python, and Eclipse as 64-bit applications.
In fact, Eclipse can be installed only as a 64-bit application.
The Eclipse download requires about 54 MB of disk space; keep it on your
machine, in case you need to re-install Eclipse.
When installed, Eclipse requires an additional 350 MB of disk space.
- Double-click the icon labeling the file eclipse-inst-win64.exe.
It might take a few seconds to a a few minutes, but watch for the following
Eclipse Installer pop-up window to appear.
It will soon disappear and be replaced by another Eclipse Installer
pop-up window.
Scroll down in this window until you see
Eclipse IDE for Eclipse Committers
- Click on Eclipse IDE for Eclipse Committers.
Another Eclipse Installer pop-up window will appear.
- Click the Install button.
(When I installed Eclipse on my Surface, I was first presented with an
Eclipse Foundation Software User Agreement, on which I
clicked Accept Now.
After installation, there was no Oomph License Confirmation.)
The Eclipse Installer pop-up window will continue to show a green
progress bar
Eventually, an Oomph License Confirmation pop-up window will appear.
- Click the Accept button.
The Eclipse Installer pop-up window will continue to show a green
progress bar
Eventually, the Ecliplse Installer pop-up window will appear.
- Click the Launch button.
The installer will create a shortcut (the "death-star" icon) on your
desktop to the eclipse.exe file in this eclipse folder.
Generally, you will double-click this icon to start Eclipse.
But the Eclipse Installer will automatically start it for you, at which
point the following splash window will appear
and then an Eclipse Launcher pop-up window will appear.
In the Workspace text box, your name should appear between
C:\Users\ and \eclipse-workspace, instead of pattis.
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 a shortcut to your
workspace folder; but you must click Launch (see below) before
Eclipse creates this folder and you can create a shortcut to it.
- Click Launch.
If you have an older version of Eclipse installed, the following pop-up
window will apperar.
If this pop-up window appears, click Continue to update the
workspace for the newer version of Eclipse.
Progress bars will appear on the Splash window as Eclipse loads.
Eventually the Eclipse Workbench will appear.
If it shows as being covered with a Welcome tab,
terminate it by clicking X on the Welcome tab.
You will not see the Welcome tab when you start Eclipse again, after
this first time.
If it further shows a Donate tab,
terminate it by clicking X on the Donate tab.
- Click Help (on the far right of the line below this window's blue
title eclipse-workspace - Eclipse IDE) 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 and ultimately to
Select 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.
Select the I accept the terms of the license agreement radio button,
so the window appears as
- Click Finish
The lower right-hand corner of the eclipse-workspace - Eclipse IDE
window 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.
If you see a Security Warning pop-up window
Click Install anyway.
The installation will finish (the progress bar will disappear).
A Software Updates pop-up window will appear.
- Click Restart Now
Eclipse will terminate and restart.
Once again will show the Eclipse Workbench.
As you did in step 4, if you see a Welcome Tab covering the window,
terminate it by clicking OK on the Welcome Tab.
If a Windows Security Alert pop-up window appears
click Allow Access.
Notice in the upper right-hand corner of the Eclipse Workbench, you should
see the following 2 icons.
- Click the left icon, which displays an Open Perspective pop-up
window.
Click on the "double-snake" Python icon labelled PyDev and then
click on the Open button.
The Eclipse Workbench will now appear as
Repeat this process selecting the "green bug" icon labelled Debug
in the Open Perspective pop-up window.
Now the top-right corner should show four icons:
Next, right-click the "J" icon (the second one) and then click
Close.
Finally, click on the "double-snake" icon.
Now the top-right corner should show three icons:
- Click Window (to the left of Help on the far right of the
line below this window's blue title
eclipse-workspace - Eclipse IDE)
and then click Preferences in its pull-down menu, as shown below.
- Drill down to select the interpreter:
- Disclose PyDev by clicking the > in front of
PyDev or double-clicking PyDev (after the
>); the > changes to a v.
- Disclose Interpreters by clicking the > in front of
Interpreters or double-clicking Interpreters
(after the >); the > changes to a v.
- Select/Click Python - Interpreter.
The Preferences pop-up window should appear as follows.
- Click New... at the top-right of the top pane and then click
Browse for python/pypy.exe.
A Select Interpreter and Open pop-up window appear.
In the Open pop-up window, navigate to that folder in which Python
was installed:
C:\Users\pattis\AppData\Local\Programs\Python\Python39.
Double-click python.exe (or select it and click Open).
Change the Interpreter Name in the Select Interpreter pop-up
window from python to Python39
(or whatever the latest version of Python you have installed).
The Select Interpreter pop-up window should appear as
- Click OK.
A Selection needed pop-up window will appear.
Your window should have all four of these checkboxes checked.
- Click OK.
Click the Libraries tab (2nd one) above the lower pane.
The Preferences pop-up window will appear as
Actually, on my system I had to first shrink the Name tab and then
enlarge the Location tab for the top pane, so that I could see the
entire path to the Python interpreter.
- Click Apply and Close.
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.
If the following pop-up window appears
Ensure the "Public networks, such as those in airports...."
checkbox is NOT checked, and then click Allow Access.
- Locate the workspace folder created in step 5
(see C:\Users\yourname\eclipse-workspace)
and download 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 may be asked to put other course-specific Python
module files into this courselib folder; these modules will be
usable (via import) in all Python projects in Eclipse.
- Inform Eclipse to use the courselib folder in all Python projects.
- Select Window | Preferences.
- Disclose PyDev by clicking the + in front of
PyDev or double-clicking PyDev (after the +); the
+ changes to a -.
- Disclose Interpreters by clicking the + in front of
Interpreters or double-clicking Interpreters
(after the +); the + changes to a -.
- Select Python - Interpreter.
- Click the Libraries tab (2nd 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
(C:\Users\yourname\eclipse-workspace\courselib).
- Click the courselib folder selected, and then click SelectFolder.
Notice a fifth entry
(C:\Users\yourname\eclipse-workspace\courselib)
appears in the bottom-right pane named
System PYTHONPATH. Reorder with Drag & Drop.
- Click Apply (you will see some progress bars).
The pop-up window should now appear as
- Cick Apply and Close.
You will see a brief progress bar on your screen.
- Terminate (click X on) the Eclipse window.
You may see a Confirm Exit pop-up window.
If you do,
Click the Exit button.
Eclipse will terminate.
Eclipse is now installed for Python.
It can be activated by click the Eclipse shortcut icon
which should appear on your desktop.
It's actual name will be Eclipse IDE for Eclipse Committers - 2021-06
but I suggest just renaming it Eclipse.