Install Python and Java 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 (Oxygen) on Windows 7 in Summer 2017. You should download and install the latest version of Eclipse. The current latest (as of Summer 2017) is Eclipse (Oxygen).
Eclipse: (Oxygen)
Eclipse User Manual. Release 4.0.1 Page 5 of 66 Eclipse User Manual The Hows and Whys of This Manual Of course you have more exiting things to do than to read this manual. For one thing, you have Eventide’s fabulous new Eclipse Harmonizer brand processor waiting to all those sounds so badly in need of. Effect effecting. Click the big downward pointing arrow underneath the Download eclipse-SDK-4.3-win32.zip from: The site named here, in purple to the right of the arrow: United States Georgia Tech Software Library (http) is the random one chosen by the download page this time. This file should start downloading in your standard download folder.
The Eclipse download requires about 300 MB of disk space; keep it on your machine, in case you need to re-install Eclipse. When installed, Eclipse requires an additional 330 MB of disk space.
Downloading
- Click EclipseThe following page will appear in your browser. In this handout we will download Eclipse IDE for Eclipse Committers for Windows 32 Bit; if your computer uses Windows, continue below; otherwise choose either Mac Cocoa or Linux instead.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 to use 32 Bit for everything.
- Click the 32-Bit (after Windows) to the right of the Eclipse IDE for Eclipse Committers. You will see the following page (don't worry about the name of the institution underneath the orange DOWNLOAD button).
- Click the orange DOWNLOAD button. The site named here, in orange to the right of the button: United States - Columbia University (http) is the random one chosen by the download page this time; yours may differ. This file should start downloading in your standard download folder, while showing a splash screen about donating to Eclipse. This file is about 300 Mb so it might take a while to download fully if you are on a slow internet connection (it took me about 5 minutes over a cable modem). Don't worry about the exact time as long as the download continues to make steady progress. In Chrome progress is shown on the bottom-left of the window, via the iconThe file should appear asTerminate the tab browsing this webpage.
- 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)
Python and Java should be installed before installing Eclipse- Unzip eclipse-committers-oxygen-R-win32.zip, the file that you just downloaded and moved.
On my machine (running Windows 7), I can- Right-click the file.
- Hover over the IZArc command from the menu of options.
- Click Extract Here
If you do not have IZArc or an equivalent unzipping program, here is the web site to download a free copy of IZarc.Unzipping this file creates a folder named eclipse; unzipping 250 MB can take a few minutes. You can leave this folder here or move it elsewhere on your hard disk. I recommend putting the downloaded file and resulting folder in the C:Program Files directory. - Create a shortcut on your desktop to the eclipse.exe file in this eclipse folder:
On most Windows machines, you can- Right-press the file eclipse.exe
- Drag it to the desktop.
- Release the right button.
- Click Create shortcut here
Now you are ready to perform a one-time only setup of Eclipse on your machine. - Double-click the shortcut to Eclipse that you just created above. The following splash screen will appearand 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 OK (see below) before Eclipse creates this folder and you can create a shortcut to it.
- Click Launch. 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 line below this window's blue title eclipse-workspace - Eclipse) 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.Select the I accept the terms of the license agreement radio button, so the window appears as
- Click FinishThe lower right-hand corner of the eclipse-workspace - Eclipse 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 windowClick Install anyway.The installation will finish (the progress bar will disappear).A Software Updates pop-up window will appear.
- Click Restart NowEclipse will terminate and restart. As you did in step 4, terminate (click OK on) the Welcome Tab.
- Click Window (to the left of Help on the far right of the line below this window's blue title eclipse-workspace - Eclipse) 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 -.
- Disclose Interpreters by clicking the + in front of Interpreters or double-clicking Interpreters (after the +); the + changes to a -.
- Select/Click Python - Interpreter.
- Click New... at the top-right of the top windowA Select Interpreter pop-up window appears.Click Browse and the Open pop-up window should show you the folder in which Python was installed (here Python 36-32).Double-click python.exe (or select it and click Open).Change the Name in the Select Interpreter pop-up window to be simply Python36 (or whatever version of Python is installed). The Select Interpreter pop-up window should appear as
- Click OK. A Selection needed pop-up window will appear.Actually, your window should have only the 4 ...AppDataLocal... checkboxes; don't worry if the ...AppDataRoaming... one (4th of 5 in this window) is absent.
- Click OK. The Preferences pop-up window will be changed toOn my system the path to the Python interpreter was so long, not all of it could be seen under Location
- 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 appearsEnsure the 'Public networks, such as those in airports....' checkbox is NOT checked, and then click Allow Access.
- Click Window (to the left of Help on the far right of the line below this window's blue title eclipse-workspace - Eclipse), hover over Perspective then 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 (fourth from the bottom) The Package Explorer in the upper-left tab will change to PyDev Package Explorer, and a Python icon will appear to the right of the Java icon (on the far right).
- Right-click the Java icon to the left of the PyDev icon and select closeThe Eclipse workbench will now have only the PyDev icon here and will look like
- Locate the workspace folder created in step 3 (see C:Usersyournameeclipse-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 (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 (C:Usersyournameeclipse-workspacecourselib).
- Click the courselib folder selected, and then click OK
Notice a sixth entry (C:Usersyournameeclipse-workspacecourselib>) appears in the bottom-right pane named System PYTHONPATH. Reorder with Drag & Drop. - Click Apply (you will see some progress bars)
The < />< />< b=' /> pop-up window should now appear as < />< /> - Cick Apply and Close
- Terminate (click X on) the Eclipse window.
In this guide we show different ways of extending an existing ECL commands functionality, such as:
- Retrieve an existing method of Java Object with get-object | invoke commands
- Create static methods and use it with invoke-static command
- Create your own custom ECL command
Use invoke command to call an existing method of Java object.
Let's say we need to resize a window with given width and height. There is now such a command in ECL script, but we know that there is a corresponding setSize(int width, int height) method for Window Object.
So using get-object and invoke ECL commands we can call this method:
You can define ECL procedure, to make it more convenient:
Create your own custom ECL command
We are going to show how to create custom ECL commands. As an example we create two ECL commands for Eclipse Views. First one will show us all registered views in our Eclipse. And the second one will open specified view by ID.
Import RCPTT sources plugins
First of all you need to import RCPTT sources plugins from RCPTT Git repository
Create Plug-in Project
First of all we'll create new plugin project for our ECL commands called org.eclipse.rcptt.ecl.example.view. You can use any existing plug-in as well.
Define EMF model for ECL command
We need to create two EMF classes to show registered plugins with ECL:
- ShowViews which will be used as an ECL command. This EClass should extend Command EClass from the org.eclipse.rcptt.ecl.core/model/ecl.ecore package
- View which will be used to store view details. It should contains three string properties: id, label and description.
If you're not experienced EMF user you can find detailed instruction on the Define EMF model for ShowViews command page.
Implement ShowViews command
Now we need to implement ECL command. Make sure you have all necessary dependencies:
Implement ICommandService interface
Add new class ShowViewsService which implements org.eclipse.rcptt.ecl.runtime.ICommandService interface as shown below:
As you can see the implementation is very simple. We use platform IViewRegistry to collect details of Eclise Views and store this information using EMF View objects. Then we write collected information to the output pipe. Note that view service will be executed using Eclipse Jobs, so we use Workbench Display to access view info in the UI thread.
Register ECL command implementation
Finally we need to register our service using org.eclipse.rcptt.ecl.core.scriptlet extension point:
- name - name of the EClass which we use for ECL command
- namespace - EMF Package URI
- class - command implementation class. Should implement ICommandService interface
By default name of the command EClass will be transformed to the ECL command name. For example, in our case commands will be named show-views. However you can override this name using friendly_name part of the org.eclipse.rcptt.ecl.core.scriptlet extension point.
Use show-views command
- Let's start new Eclipse instance with the following plugins installed:
- org.eclipse.rcptt.ecl.example.view
- org.eclipse.rcptt.ecl.core
- org.eclipse.rcptt.ecl.parser
- org.eclipse.rcptt.ecl.shell
- org.eclipse.rcptt.ecl.telnet.server
- org.eclipse.rcptt.ecl.telnet.server.ui
- org.eclipse.rcptt.tesla.jface.fragment
- org.eclipse.rcptt.tesla.swt.fragment
- Connect to the ECL telnet server started in this Eclipse (on the 2323 port by default) using any telnet client
- Enter show-views command
- As a result of your command you will see something like this:
Add show-view command
In the previous sections we discussed how to collect information from Eclipse using ECL. Now let's add another command which will open some view by id.
Add ShowView EClass
Create one more EClass called ShowView with one string field id. This is ECL command and should extend Command EClass.
Implement ShowView command
Add ShowViewService java class:
We added this service specially for ShowView command, so we can freely cast specified command to ShowView interface. This allows us to get id of the view we need to open. Next we use Eclipse Platform API to open view by id in the UI thread.
Register ShowView command
Finally we need to register new command through org.eclipse.rcptt.ecl.core.scriptlet extension point:
Use show-view command
Now we can run our plugin and open necessary view by id:
By the way, you can use show-views command to find id of a view you want to open.
Please note that to make your new custom command work you need to include a plugin with your custom command into your AUT configuration.