Eclipse as of today is the industry’s major non-Microsoft software tool platform. The number of companies adopting this platform is a testimonial of the platform’s success.
(Check my previous post for more on the history of Eclipse IDE)
Eclipse has a well-designed, and extensible architecture. What is valuable about Eclipse is that it provides an open source platform for creating an extensible integrated development environment. This platform allows anyone to build tools that integrate seamlessly with the environment and other tools.
The key to the seamless integration of tools with Eclipse is the plug-in. With the exception of a small run-time kernel, everything in Eclipse is a plug-in. This means that a plug-in you develop integrates with Eclipse in exactly the same way as other plug-ins.
Any new person who is introduced to Eclipse in concerned with one important question : How to Install Eclipse Plugins ?
There are lot of useful, high quality third party plugins available and all the plugin installation instructions specify at most 2 ways to install Eclipse Plugins
Normal Ways of Installing Eclipse Plugin
I will take the Eclipse Webtools Plugin to describe the 2 “normal” ways of installing Eclipse Plugins. In the next section I will show how the same can be done in a “easy” way.
This is how the Eclipse SDK folder structure looks like:
After extracting the Webtools package you have this folder hierarchy:
One of the common method of installing is to copy the contents of the “features” into the “features” folder of eclipse, and do the same with the “plugins” folder.
The other way of installing, which Eclipse also recommends is via the Update Manager.
You can choose the components you wish to install, choose the dependent plugins etc. In this process, generally you select the default installation location specified by the wizard.
The advantage with this approach is that when you select a component you are also made aware of the dependent plugins that needs to be installed. For e.g. If I select Web Tools, I am also told to select/install GEF
The disadvantage with this approach is that it never works well in a low bandwidth environment. I have struggled so many times to install via update manager, somewhere its gets stuck and I am left with a partially installed, corrupted environment.
The Easy Way
Now for the “Easy” way of installing Eclipse Plugins. Very few people are aware of this concept and Eclipse somehow doesn’t seem to document this approach anywhere.
This method uses the concept of “Links”. Here is the step by step procedure. (In the explanation I have used the installation of Webtools as the example)
1. Create a folder named links inside the eclipse folder (See Picture below)
2. Create a new file inside this folder and name it as say wtp.link. Note that the file name can be any valid string, but the extension has to be link.
3. Assuming that I have copied the Web tools into D:\thirdparty as shown below,
the contents of wtp.link has to be this:
path=D:/thirdparty/wtp
Points to Note:
- The string should always start with “path=” keyword.
- The path should point to a directory which has a “eclipse” folder which in turn has “features” and “plugins” as sub-folders
- It is recommended to use forward slash ‘/’ in the path (If you want use Backslash, see that you use the escape character i.e. in Windows it should be “\”)
- The file extension should end with “link“
- The file (i.e wtp.link in our example) should exist in the “links” folder.
- It is recommended to create link files only for big plugins/applications. For small plugins you can create just one link file, say misc.link and copy all the small plugins to the path referred by this link.
Restart Eclipse and now all the plugins and feature descriptions should be read from the path referred by the “link” files.
Advantages
Eclipse has a lot of top level and technology projects. To experiment with these projects, the “links” concept comes to the rescue. You can extract the plugin to a “thirdparty” (or a folder of your choice) and just link it within the eclipse installation. My current configuration looks like this:
Eclipse Projects/Third Party Plugins
Corresponding Link files
The “Copy” approach just bloats the eclipse installation and you cannot remove/uninstall the plugin easily. With links approach, you can just remove the “link” file and the plugin is uninstalled !!
The same links directory can be used in another eclipse installation. For e.g. if you are working with Milestone or different version of Eclipse, you can just copy the links folder (containing .link files) and the plugins are installed.
It is very easy to manage different versions of a plugin. If a new version doesn’t work, reverting back to a previous version is pretty easy.
Also, if you use the update feature in Eclipse, you can choose one of the above folders as the installation directory.
Conclusion
This approach seems to work fine in both windows and linux. I am not sure why this approach is not documented in Eclipse. I found out about this when I was using the trial version of RAD (Rational Application Developer). It was used primarily to manage product extensions. I believe the same concept can be used to manage plugins (Install/Uninstall).
Hope this post was useful, if you had any problems using this approach, do leave a comment with the problem description.
Popularity: 100% [?]
{ 15 trackbacks }
{ 76 comments… read them below or add one }
help > software updates > manage configuration then righ click on “Eclipse SDK” add > extension location
it’s kinda faster
Hornburg, yes it might be faster by adding extension location. But if the scenario is working between multiple versions of eclipse and multiple versions of plugin, then u can easily move around the plugins.
If you are doing it one time, I guess the “add extension location” makes more sense.
A visitor pointed me to this article which explains this concept
http://blog.exis.com/colin/archives/2004/12/23/managing-plugins-in-eclipse/
FYI, i am one of the maintainers of an eclipse distros called EasyEclipse which install all its plugins like that.
Philippe, checked EasyEclipse Pretty nice..But I didnt get by what you meant by “that” you use links concept or the Extension location concept ?
Hi,
This is a nice article.
How do I used environment variables in the .link file.
can I use the following
path=${HOME}/plugins
Regards,
Bhaskar
Bhaskar, thatz an interesting question ! I have not used eclipse on unix environment, if it works it will be great. Can u check it and let me know !
I will check on windows,but my feeling is that it might not work otherwise IBM should have used this quirk on their RAD installation
Hi Venu,
I have tested this. This feature is not working.
Regards,
Bhaskar
Thanks Bhaskar, for checking on that..
I guess we have to manage with the “famous” copy paste mechanism
Hi,
This is an excellent article.
It might not be an easier way to install eclipse plugins, but for sure it is a better way to install and maintain eclipse plugins.
Thanks,
William.
Thanks William, i do agree creating and setting up those links is a little pain, but once its in place its not that difficult to move/edit these files
I’ve been using this technique for ages. I discovered it after installing MyEclipseIDE and seeing how it installed.
A couple of slight additions:
* EVERY plugin folder contains the version in its name so I can easily track multiple versions
* I keep a copy of each .link file in the /thirdparty folder so I can quickly select and copy the plugin’s I want and paste them into Eclipse’s /links folder. It also helps prevent typo’s because you only have to get it right once.
* The .link files have the EXACT same name as the plugin folder.
Hope that helps,
-Dave
I don’t completely agree on the first point, its not mandatory for a file name to have version.
Second point regarding keeping the link files in the thirdparty folder is a nice idea
And .link file name can be ANYTHING .. as I have mentioned in the post, it can be any valid file name and it doesn’t need to match the name of any plugin folder
> venukb wrote on August 24, 2006 @ 10:12 am
> you use links concept or the Extension location concept
we use both:
- all plugins are packaged with an eclipseextension
- at install time a link file is created with the installer
I use several Eclipse configurations with the same Eclipse install and so run Eclipse with different values of “-configuration” parameter. Different configurations may have different sets of plugins, including different versions of the same plugin that would conflict if installed in the same configuration. For such case, I believe the only way to go is to use extension locations, because links are shared between configurations and extension locations are not. Nevertheless, I have several plugins shared among all the configurations I use, so links-based approach will simplify the process of management of such shared plugins.
Hi Roman,
I have read about the -configuration argument, however I have never found out a way to use it properly. I tried “googling” around but couldn’t find much. How is that argument used ?
When setting up the new configuration I just copy the “configuration” folder from the eclipse install to another location and then launch eclipse like “eclipse -configuration new_config_dir”. So, info related to all the plugins I add via configuration manager is stored in the new_config_dir instead of the eclipse/configuration. I repeat the procedure with another directory when I need a different set of plugins.
Nice
never realized you could handle plugins that way also.. will try it out. Thanks 
Has this links folder and links file technique been used successfully by anyone on any of the Rational version 7 line of products?
I can enable my plugin using the “add an extension location” GUI operation, but RSA, RSM and RAD appear to completely ignore the links folder.
Hi,
I installed a plugin using software help->Software updates ->find and install link in RAD. How do I uninstall it?
This looks ideal for me as I want to try several plugins before deciding which ones to use. Unfortunately it seems to work some of the time but not all of the time.
I tried the technique with CFEclipse and Aptana and they work well, but JSEclipse did not show up as a perspective when I tried that. Should it or does it work some other way?
Also wnted to use XML Buddy but it did not seem to have the right directories when I unzip the distro.
Any ideas?
Hi Kevin,
I have loaded lots of plugins using this approach and none have failed. Even if they have, its because of my mistake in not conforming to the folder layout.
The .link file should point to a directory which has eclipse directory and this eclipse directory should have plugins and features folder.
Some of the places where you might make a mistake
1. Path name given in the link file (Also note that the path should have forward slash /)
2. Directory structure not in proper format
If both of these are fine, then your plugin might not be loading because of some missing dependent plugins. Start eclipse with a -clean option and check Error Log View in Eclipse. You should find logs if any plugin is not loaded properly.
RAD is not displaying installed plugin:(
i installed the “metrics plugin”(web: http://sourceforge.net/projects/metrics) to find the code metrics in RAD.
Usually after installation in Eclipse, i will select a project and right click on it to see the ‘properties’ and ‘Enable Metrics’ in that view. But in RAD 6.0.1 (Eclipse version 3.0.2) it is not working.
Can anyone verify this? Kindly tell me how to solve this problem, as i have to run the metrics plugin in RAD 6.0.1.
hima bindu
Mar 6th, 2007 at 12:48 pm
continued..
by the way, your method works fine in eclipse (3.1) but in RAD eclipse it doesnt.
To hima bindu: This method doesn’t work in Rational 7 products because IBM disabled it. I found this link with alternate methods, when I was trying to get this to work on those products:
hi anitsirK ..
i was talking about version 6 of RAD… can u plz tell me whether this works for version 6 also??
hima bindu:
Yes, it does. If you look in the …\IBM\Rational\SDP\6.0\eclipse directory (assuming you’ve installed to the default location), there’s a links folder already there, and IBM actually has several files in there when you first install the product (com.ibm.rational.rad.link for example). Put your .link files in there, and it should work, as long as your plugins work on RAD 6.
In the version 7 line (RSM, RAD, RSA), this no longer works. Why IBM seems to like removing features, then selling it as an upgrade, I’ll never understand.
hi nice site.
just tried and did a fresh install after having read this post (and a few other on the topic). And I couldn’t have the “windows” way to write the path to work….
But it works fine ^_^
Tam
Tam I didnt understand this part of your comment. Did you have any trouble with “links” approach ?
Venu,
I tried your suggestions to understand why the JSEclipse plugin is not working but can’t see any problem with the .link file or athe way the path is written. It’s just like the others and they all work.
I have decided that it is probably that it was built for Eclipse 3.1 and I am using 3.2. I guess I have to wait for a new version.
Kevin, I tried to test it out, but seems like its acquired by Adobe and requires some login to download.
Anway, the only way to find out whether the plugin is loaded is via the “Error Log” view. It will report if the plugin failed to load and also the reason
(like some API mismtach or dependent plugin missing etc)
Hi,
Does anyone know how to install eclipse v3.3 in RAD 7.0.
Currently it uses eclipse v3.2
Hi
i have a question… the Tail plugin for Eclipse (version 0.5.0), works in eclipse 3.2.2 with MyEclipse 5.5.1 GA?.
I have a copy and a tried to install but don’t work.
Sorry for my english.
Bye bye.
It doesn’t work for me with the Subclipse plug-in and there is no error log report for it.
It installed fine with the update manager. What I did notice was that when installing with the update manager I had to agree to license conditions before installation. Could the lack of license agreement be what the link method is getting blocked by without reporting an error?
Jay,
I do remember that RAD has a distinct folder which has the base Eclipse SDK. However I wouldn’t recommend changing that, since the plugin’s based on Eclipse 3.2 might no longer work with 3.3 (If there are API changes)
Tavo,
The Tail Plugin is very old and was last updated on Nov 18 2003. Probably the plugin api no longer works with Eclipse 3.2.2. When you start Eclipse, have a look at the “Error Log” view. The view shows details on plug-in load failures.
Meanwhile check on this post for an alternative way of Tailing Log files on Windows
Steve,
The license page in the update wizard pops up for every plugin installed via the update mechanism.
To test out, I downloaded the Subclipse plugin from this URL:
http://subclipse.tigris.org/files/documents/906/38385/site-1.2.3.zip
extracted the contents and copied it to a folder structure like this.
I also created a “link” file pointing to the Subclipse folder <code>path=D:/europa/subclipse</code> and I was all set. I could configure settings via the SVN preference page and also switch to the SVN perspective.
As mentioned in the post, one thing to note is the folder hierarchy. For E.g. If you have forgot to create a “eclipse” folder inside “Subclipse”, the plugin would never load.
I’m doing something wrong and would appreciate an extra set of eyeballs to get this installation method moving forward.
I have a very simple jar file that, when, copied to the eclipse/plugin directory, works perfectly.
Just to keep it simple, the jar file only contains the META-INF/MANIFEST.MF file, the content xml file, and the
plugin xml file.
As per the instructions, I did the following:
under: eclipse/links/aaa.link is
path=C:/tpplugins/aaa
under C:\tpplugins\aaa I did the following:
created C:\tpplugins\aaa\eclipse\features and C:\tpplugins\aaa\eclipse\plugins
in the folder C:\tpplugins\aaa I did the following:
copied the jar file.
extracted the jar file so that I had:
C:\tpplugins\aaa\bbb.jar
C:\tpplugins\aaa\META-INF\MANIFEST.MF file
C:\tpplugins\aaa\content.xml
C:\tpplugins\aaa\plugin.xml
Restarted Eclipse. No errors messages were encountered on startup and nothing was logged in error log file.
Tried all combinations of the above files. Just the jar file, just the files themselves, and all files.
The files were not listed under the help>> cheatsheets.
Any ideas? Thank you in advance.
Jim, with eclipse 3.2 and above, you don’t need to extract the JAR file.
You should copy or extract to the following path
c:\tpplugins\aaa\eclipse\plugins.
you seem to be extracting at c:\tpplugins\aaa which is wrong.
Venukb,
Bingo!! I feel like Uncle Eddie in Christmas Vacation.
Here is what worked.
Copied jar file to C:\tpplugins\aaa\eclipse\plugins.
Restarted Eclipse.
The world was right again.
I wanted to locate where I had problems with the original directions.
I think it was with step #3 in the original article.
It says, “Assuming that I have copied the Web tools into D:\thirdparty as shown below”, etc…
I certainly didn’t get it.
Well what was copied and, really, where was it copied?
Better would be “Copy jar file to C:\tpplugins\aaa\eclipse\plugins”
Venukb, I can’t thank you enough. Your reply made a difference. I was ready to throw in the towel.
Thanks again,
Jim
Jim, Glad you got it working
I did re-read the post again. If you notice, I do mention WTP package and its hierarchy before staring with the steps.
Irrespective of this, I will definitely change point 3; I myself was confused a little bit by the ordering.
[…] Install Eclipse Plugins – The Easy Way? ????. ?? ?? ??? ???? ? ???? ??. […]
+1
How do the feature loading methods (update, .eclipseextension, .link) differ from the plugin perspective?
ie:
When using the update manager duplicate plugins don’t seem to be downloaded and versions are checked, so when you restart eclipse it doesn’t spend wasted time trying to load a plugin that has already been loaded.
-vs-
When using the .eclipseextension; if there exists a plugin in the eclipse/plugins folder that also exists under the eclipse folder pointed at be the .eclipseextension eclipse seems to go through and verify it isn’t already loaded and if it is it writes to the error log.
Still trying to learn how the loading mechanism works…
It works fine on Mac OS X 10.4
Thanks!
R.
Nice article Venu
When I try to add subclipse 1.2.4 as an extension through Manual Installation, (Subclipse->eclipse->has plugin and features folders); it says there must be a .eclipseextension file which is not there. Do we have to create it by ourselves?
But when I followed the links path, it works fine.
Hi,
Thank you for your article.
I’m trying to create a links folder with link files inside for an exported RCP application (I export my application with the eclipse wizard and then I create manually the folders).
It seems it doesn’t work…
Have you already tried to do that?
Thank you very much.
Thank you very much for this article. Very useful.
Interestingly, I discovered in the Eclipse 3.3 sources that you can prepend the actual path in the .link files with “r ” or “rw ” to create read-only or read/write (default) sites, as in:
path=r
Hope this helps
“Greater than” and “lesser than” signs were removed. The syntax is:
path=r /path/to/…
I am unable to install for some reason. I was trying to install Hibernate Tools. Am I missing something here. I have eclipse 3.3.2 installed on my machine. Do I have install something more or am I missing something here??
@Kamal,
Yes if you are using the extensions mechanism you should refer to this post
http://blog.exis.com/colin/archives/2004/12/23/managing-plugins-in-eclipse/
@Romain,
Thanks very much for that input. Will update the article with this info.
@Rama,
What is the error that you see ?
About the JSEclipse plug-in I tried the method described here to load it from a third party plug-ins folder and the first time the plug-in loaded just fine. After a workbench restart I saw the plug-in didn’t load at all and went to the config manager just to see that the plug-in was disabled.
What I did next was enable it and restarted the workbech once again to what it was disabled again. I repeated the process but instead of restarting the workbench I just applied the changes without any restart and the plug-in is working just fine.
Any ideas why this happens? Does JSEclipse conflicts with any other feature?
Hope this might help a bit.
Nice article by the way.
Very good way and it worked with me well.
But what if I copied whole the eclipse root directory to another location (by a flash memory or shared it on a network) I guess that we have to:
(1). All plug-ins must be copied
(2). Strings 0f the corresponding link files (in the link folder) must be changed according to the corresponding plug-in new position.
Am I right?
Octavius,
Apologies for the late reply. Regarding JSEclipse even Kevin also had a similar trouble.
So I went ahead and tried installing JSEclipse using Links. When I fired up eclipse, saw a message in the Error log saying “could not find feature.xml”.
I am out of touch with eclipse from some time, but for some reason, eclipse could not find the feature.xml which was in the archive (feature jar file). I extracted the contents and deleted the archive and restarted eclipse, seemed to work fine !
Try it and let me know if it worked for you.
Mohammad,
Even if you move the entire eclipse directory, there is nothing to be done since the links point to the same external directories. Note that you should ideally keep the extension folders out of Eclipse directory !
If you do rename or move the link folders themselves, as you have pointed out you need to update the string.
Link concept works fine for me on Mandriva 8.1. My experiences:
I use
path=0_thirdparty/org.jupeter.yaml_editor_1.0.2where my eclipse directory is the root.
path=$home/apps/eclipse/0_thirdparty/org.jupeter.yaml_editor_1.0.2works also. So you can use environmental variables. I disable plugins renaming *.link file to *.link_
Thanx, Venu. Live long and prosper!
Thanks Venu, Keep Up the Good Work !
Hi Venu,
This approach seems ok but it is not appropriate for a portable Eclipse installation (I carry my Eclipse + Workspace on a portable harddrive). The Update Manager > Add Extension Location is more feasible and recognizes the change via relative location. Although after adding the extension you could only remove it manually via eclipse install>configuration>org.eclipse.update>platform.xml.
Anyway, thanks for the info.. I have walked through your steps first.
Many thanks!
-jmm
This work fine with RAD7!
I have tried with Visual Swing with no success (Eclipse 3.4.1, Windows XP).
“>
It is not show as Installed Software or Available Softwere in Help -> Software Updates. BTW, Visual Swing ZIP file does not contains a features directory.
I tried this link approach it is working fine but when i removed links folder still i am getting those linked plugins. how can i uninstall those plugins. Please help me.
JMM,
I have never tried giving a relative path in the link file. It might work I guess.
Luis,
Features is not always required by eclipse plugin contract as far as I know. I haven’t tried this approach with 3.4.
Akbar,
Are you seeing the functionality of the removed plugins? Thats surprising. In any case you can do
eclipse -cleanThis re builds the plugin cache and you should be set.Hi Venkub,
Thanks for your reply, after removing the link file i opened eclipse with -clean option but still i am seeing the functionality of the removed plugins.
please help me. What do i need to do?
Hi.
Tried this with latest eclipse installed fresh on 24Feb2009. It is the “Ganymede” version, C/C++ platform, downloaded from eclipse.org, version 3.4.1, detailed info below. Tried the Subclipse plugin, triple checked that everything is as described in the article. It does not work. I see that the feature has apparently been removed from some versions of Eclipse. Does anyone know if that is the case for the latest “Ganymede”?
Thanks. -Mikey
Eclipse Platform Version: 3.4.1
Build id: M20080911-1700
(c) Copyright Eclipse contributors and others 2000, 2008. All rights reserved. Visit http://www.eclipse.org/platform
This product includes software developed by the
Apache Software Foundation http://www.apache.org
How could I use a plugin directory that resides on network?
I tried ” path=\\\\192.168.0.1\\EclipsePlugins”, but it doesn’t work
Hey,
I am a newbie in eclipse. I have tried the basic thing of copying the contents of features and plugins and pasting it into the respective folders but it didn’t work. I mean, I am not getting the required API when I try to write the program.
Thanks
great post venu. Thanks. LEt me give this a shot.
Thanks a lot man!
Hi I tried quatumDB with eclipse 3.5 , it is only showing the help plugin, but not loading the views and perspectives
it is working perfectly when I install inside eclipse plugin and features folder, but when I use the link it is neither showing any error nor showing the plugin views and perspectives
In the tutorial what do you mean:
the contents of wtp.link has to be this: path=D:/thirdparty/wtp
For someone new to plugin’s and fairly new to Eclipse you’ve completly jumped steps here. I have no idea what you are saying to do. Where do I create this code? in eclipse? in a text document in plugins? and what if the plugin has no “features” folder, for instance I would like to install Ecalc from: http://www.eclipseplugincentral.com/Web_Links-index-req-viewlink-cid-544.html
and how do I launch the plugin inside Eclipse?
Greg,
In a text document; a missing feature folder shouldn’t matter..
i am working in a project on eclipse.i have to install manually developed plugins in eclipse.how can i do this?
Hi,
I was having issues with ClickIDE plugin with Eclipse3.4. Initially I had it working (by manually extracting the files) but later I deleted the plugin as it was throwing some exception. Later when I re tried, it (clickIDE plugin) does not even gets loaded. Not sure what when wrong. I have installed Aptna plugins between ‘deleting’ and retrying the installation.
After reading this post, I tried but of little use. Said plugin still does not gets loaded. Someone please help. Is there any log file generated while starting Eclipse, which tells which plugins got loaded and which had problem loading.
Thanks
Ashish
file extension “.lnk” (not .link) works
It’s amazing!!! Thank you so so much..I’m working with Eclipse Galileo 3.5 and I found that when replacing / in “path=” by // it works well. Once again thank you for sharing such awesome article!
I am new to eclipse. I find this approach very useful.
I am able to add CDT, RDT to Eclipse Java EE IDE. So it’s really turning true IDE for all my development needs
Thanks for such useful post.
Is this supposed to work for RCP products you’ve created, or only for Eclipse IDE?
I have a product definition, and exported, for which I want to have the normal plugins folder for plug-ins that I’ve shipped with the product. And then also a link to a folder where the user can add own plug-ins. Any ideas if this should work? Or why I can’t get it to work? (with extensions .lnk/.link using ‘/’ and backslah, or double slash / backslash…)